Оддий HTTPS уланишида фақат сервер ўзини исботлайди: браузер сертификатни текширади ва ҳақиқатан ҳам керакли сайтга уланганига ишонч ҳосил қилади. Мижоз эса аноним қолади, уни кейинроқ login, парол ёки API калити орқали аниқлашади. mTLS (mutual TLS, икки томонлама TLS) бу схемани кенгайтиради: уланиш пайтида мижоз ҳам ўз сертификатини кўрсатади, сервер эса уни текширади. Сертификати бўлмаган ёки нотўғри сертификатли мижоз иловангизгача умуман етиб бормайди.
API калити етарли эмасми?
Кўп API'лар сўров сарлавҳасидаги махфий калит билан ҳимояланади ва бу кўпинча етарли бўлади. Лекин калит оддий матн қатори: у конфигурация файлида, логларда ёки ходимнинг компьютеридаги скриптда қолиб кетиши мумкин. Ким уни нусхаласа, дунёнинг исталган жойидан сизнинг API'ингизга сўров юбора олади. Бундан ташқари, калит текшируви илова даражасида бўлади, яъни ҳар қандай кимса сизнинг серверингиз билан TLS уланишини ўрнатиб, сўровни иловага етказа олади.
mTLS'да эса ҳимоя бир қадам олдинроқ, TLS қўл сиқишуви босқичида ишлайди. Мижознинг махфий калити ҳеч қачон тармоқ орқали узатилмайди, у фақат имзо қўйиш учун ишлатилади. Кўп жиддий интеграцияларда иккаласи бирга қўлланади: mTLS каналнинг ўзини чеклайди, API калити ёки токен эса аниқ ҳуқуқларни белгилайди.
Қайси ҳолатларда mTLS керак бўлади
mTLS одатда очиқ фойдаланувчилар учун эмас, балки олдиндан маълум, сони чекланган мижозлар учун қўлланади. Типик мисоллар қуйидагилар:
- икки компания ўртасидаги B2B интеграция, масалан буюртма ва қолдиқлар алмашинуви;
- тўлов ёки банк тизимлари билан сервер-сервер алоқаси, агар ҳамкор буни талаб қилса;
- ички микросервислар ўртасидаги алоқа, айниқса улар турли серверларда жойлашганда;
- дўкондаги касса терминаллари ёки IoT қурилмаларининг марказий серверга уланиши.
Оддий веб-сайт ташрифчилари учун mTLS ноқулай, чунки ҳар бир фойдаланувчига сертификат ўрнатиб бериш керак бўлади. Шунинг учун оммавий сайтларда у деярли ишлатилмайди.
Мисол: Самарқанддаги улгуржи компания ва омборчи ҳамкор
Фараз қилайлик, Самарқанддаги улгуржи савдо компаниясининг api.example.uz манзилида буюртмалар API'си бор. Тошкентдаги ҳамкор омбор ҳар ўн дақиқада янги буюртмаларни олиб, жўнатилган товарлар ҳақида маълумот қайтаради. Компания бу API'га фақат шу ҳамкорнинг сервери кира олишини хоҳлайди. IP манзил бўйича чеклаш бир вариант, лекин ҳамкор провайдерини алмаштирса ёки захира каналга ўтса, у бузилади. mTLS эса IP'га боғланмайди: сертификат қаердан келмасин, фақат у бўлса уланиш ўтади.
Компания ўзининг ички сертификат марказини (CA) яратади, ҳамкор учун мижоз сертификати чиқаради ва уни хавфсиз канал орқали топширади. Nginx эса фақат шу CA имзолаган сертификатларни қабул қиладиган қилиб созланади. Кейинчалик иккинчи ҳамкор қўшилса, унга ҳам алоҳида сертификат чиқарилади ва керак бўлса биринчисига тегмасдан бекор қилинади.
Ички CA ва мижоз сертификатини яратиш
Мижоз сертификатлари учун оммавий сертификат марказларидан фойдаланиш шарт эмас ва одатда мақсадга ҳам мос эмас. Оммавий CA исталган одамга сертификат беради, сизга эса фақат сиз чиқарган сертификатларга ишонадиган ёпиқ тизим керак. Қуйидаги буйруқлар VPS'да ички CA ва битта ҳамкор сертификатини яратади:
mkdir -p /etc/nginx/mtls && cd /etc/nginx/mtls
# 1. Ichki CA (sertifikat markazi)
openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes \
-keyout ca.key -out ca.crt -subj "/CN=Example API CA"
# 2. Hamkor uchun kalit va so'rov
openssl req -newkey rsa:2048 -nodes \
-keyout partner.key -out partner.csr -subj "/CN=ombor-hamkor"
# 3. Faqat mijoz autentifikatsiyasi uchun imzolash
printf "extendedKeyUsage=clientAuth\n" > client.ext
openssl x509 -req -in partner.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-out partner.crt -days 365 -sha256 -extfile client.ext
ca.key файлини жуда эҳтиёт қилиб сақланг: ким унга эга бўлса, ўзи учун янги сертификат чиқара олади. Яхши амалиёт уни API серверида эмас, алоҳида хавфсиз жойда сақлашдир, серверга эса фақат очиқ ca.crt қўйилади. Ҳамкорга partner.crt ва partner.key берилади, бунинг учун электрон почта эмас, шифрланган архив ёки бошқа ишончли канал танланг.
Nginx'да mTLS'ни ёқиш
Сервер сертификати одатдагидек қолади, масалан бепул Let's Encrypt. Унга қўшимча равишда мижоз сертификатларини текшириш учун CA файли кўрсатилади ва ssl_verify_client on ёқилади:
server {
listen 443 ssl;
server_name api.example.uz;
ssl_certificate /etc/letsencrypt/live/api.example.uz/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.example.uz/privkey.pem;
ssl_client_certificate /etc/nginx/mtls/ca.crt;
ssl_verify_client on;
ssl_verify_depth 2;
location / {
proxy_set_header X-Client-DN $ssl_client_s_dn;
proxy_set_header X-Client-Verify $ssl_client_verify;
proxy_pass http://127.0.0.1:8000;
}
}
Бу ерда Nginx текширувдан ўтган мижознинг номини (DN) сарлавҳа орқали иловага узатади, илова эса уни логлаш ёки ҳуқуқларни аниқлаш учун ишлатиши мумкин. proxy_set_header мижоздан келган шу номдаги сарлавҳаларни қайта ёзади, лекин илова портининг ташқаридан тўғридан-тўғри очиқ эмаслигига ишонч ҳосил қилинг, акс ҳолда сарлавҳани сохталаштириш мумкин бўлади. Созламани nginx -t билан текшириб, systemctl reload nginx билан қўлланг.
Текшириш ва сертификатни бекор қилиш
Ҳамкор серверида уланиш curl билан қуйидагича синаб кўрилади:
curl --cert partner.crt --key partner.key https://api.example.uz/v1/orders
Сертификатсиз уринишда Nginx 400 хатосини ва "No required SSL certificate was sent" хабарини қайтаради, бу созлама ишлаётганини билдиради. Агар ҳамкор билан шартнома тугаса ёки калит сизиб чиққан деб гумон қилинса, сертификатни бекор қилиш керак. Бунинг учун бекор қилинган сертификатлар рўйхати (CRL) тузилади ва Nginx'га ssl_crl директиваси билан кўрсатилади. CRL'ни openssl ca воситаси билан яратиш учун аввал унинг конфигурацияси ва индекс файли созланган бўлиши керак, шундан кейин буйруқ қуйидагича бўлади:
openssl ca -gencrl -keyfile ca.key -cert ca.crt -out ca.crl
Кичик лойиҳаларда соддароқ йўл ҳам бор: сертификатларни қисқа муддатга, масалан 90 кунга чиқариш ва муддати тугаганда янгиламаслик. Ҳар ҳолда сертификатлар муддатини календарга ёзиб қўйинг, акс ҳолда бир куни эрталаб интеграция тўсатдан тўхтаб қолади.
Хостингда бу мумкинми
mTLS веб-сервер даражасидаги созламани талаб қилади, оддий shared хостингда эса бу созламалар умумий бўлиб, мижоз уларни ўзгартира олмайди. Шунинг учун mTLS билан ҳимояланган API учун одатда VPS танланади. sayt.uz'да VPS'ни кабинетдан буюртма қилиб, унга Nginx ва юқоридаги созламани ўрнатишингиз мумкин, сервер сертификати учун эса Let's Encrypt етарли. Агар лойиҳангиз учун қайси вариант тўғри келишини аниқлай олмасангиз, sayt.uz кабинетидан техник ёрдамга ёзиб маслаҳат олинг.