Oddiy HTTPS ulanişida faqat server özini isbotlaydi: brauzer sertifikatni tekşiradi va haqiqatan ham kerakli saytga ulanganiga işonç hosil qiladi. Mijoz esa anonim qoladi, uni keyinroq login, parol yoki API kaliti orqali aniqlaşadi. mTLS (mutual TLS, ikki tomonlama TLS) bu sxemani kengaytiradi: ulaniş paytida mijoz ham öz sertifikatini körsatadi, server esa uni tekşiradi. Sertifikati bölmagan yoki notöğri sertifikatli mijoz ilovangizgaça umuman yetib bormaydi.
API kaliti yetarli emasmi?
Köp API'lar sörov sarlavhasidagi maxfiy kalit bilan himoyalanadi va bu köpinça yetarli böladi. Lekin kalit oddiy matn qatori: u konfiguratsiya faylida, loglarda yoki xodimning kompyuteridagi skriptda qolib ketişi mumkin. Kim uni nusxalasa, dunyoning istalgan joyidan sizning API'ingizga sörov yubora oladi. Bundan taşqari, kalit tekşiruvi ilova darajasida böladi, ya'ni har qanday kimsa sizning serveringiz bilan TLS ulanişini örnatib, sörovni ilovaga yetkaza oladi.
mTLS'da esa himoya bir qadam oldinroq, TLS qöl siqişuvi bosqiçida işlaydi. Mijozning maxfiy kaliti heç qaçon tarmoq orqali uzatilmaydi, u faqat imzo qöyiş uçun işlatiladi. Köp jiddiy integratsiyalarda ikkalasi birga qöllanadi: mTLS kanalning özini çeklaydi, API kaliti yoki token esa aniq huquqlarni belgilaydi.
Qaysi holatlarda mTLS kerak böladi
mTLS odatda oçiq foydalanuvçilar uçun emas, balki oldindan ma'lum, soni çeklangan mijozlar uçun qöllanadi. Tipik misollar quyidagilar:
- ikki kompaniya örtasidagi B2B integratsiya, masalan buyurtma va qoldiqlar almaşinuvi;
- tölov yoki bank tizimlari bilan server-server aloqasi, agar hamkor buni talab qilsa;
- içki mikroservislar örtasidagi aloqa, ayniqsa ular turli serverlarda joylaşganda;
- dökondagi kassa terminallari yoki IoT qurilmalarining markaziy serverga ulanişi.
Oddiy veb-sayt taşrifçilari uçun mTLS noqulay, çunki har bir foydalanuvçiga sertifikat örnatib beriş kerak böladi. Şuning uçun ommaviy saytlarda u deyarli işlatilmaydi.
Misol: Samarqanddagi ulgurji kompaniya va omborçi hamkor
Faraz qilaylik, Samarqanddagi ulgurji savdo kompaniyasining api.example.uz manzilida buyurtmalar API'si bor. Toşkentdagi hamkor ombor har ön daqiqada yangi buyurtmalarni olib, jönatilgan tovarlar haqida ma'lumot qaytaradi. Kompaniya bu API'ga faqat şu hamkorning serveri kira olişini xohlaydi. IP manzil böyiça çeklaş bir variant, lekin hamkor provayderini almaştirsa yoki zaxira kanalga ötsa, u buziladi. mTLS esa IP'ga boğlanmaydi: sertifikat qayerdan kelmasin, faqat u bölsa ulaniş ötadi.
Kompaniya özining içki sertifikat markazini (CA) yaratadi, hamkor uçun mijoz sertifikati çiqaradi va uni xavfsiz kanal orqali topşiradi. Nginx esa faqat şu CA imzolagan sertifikatlarni qabul qiladigan qilib sozlanadi. Keyinçalik ikkinçi hamkor qöşilsa, unga ham alohida sertifikat çiqariladi va kerak bölsa birinçisiga tegmasdan bekor qilinadi.
Içki CA va mijoz sertifikatini yaratiş
Mijoz sertifikatlari uçun ommaviy sertifikat markazlaridan foydalaniş şart emas va odatda maqsadga ham mos emas. Ommaviy CA istalgan odamga sertifikat beradi, sizga esa faqat siz çiqargan sertifikatlarga işonadigan yopiq tizim kerak. Quyidagi buyruqlar VPS'da içki CA va bitta hamkor sertifikatini yaratadi:
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 faylini juda ehtiyot qilib saqlang: kim unga ega bölsa, özi uçun yangi sertifikat çiqara oladi. Yaxşi amaliyot uni API serverida emas, alohida xavfsiz joyda saqlaşdir, serverga esa faqat oçiq ca.crt qöyiladi. Hamkorga partner.crt va partner.key beriladi, buning uçun elektron poçta emas, şifrlangan arxiv yoki boşqa işonçli kanal tanlang.
Nginx'da mTLS'ni yoqiş
Server sertifikati odatdagidek qoladi, masalan bepul Let's Encrypt. Unga qöşimça ravişda mijoz sertifikatlarini tekşiriş uçun CA fayli körsatiladi va ssl_verify_client on yoqiladi:
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;
}
}
Bu yerda Nginx tekşiruvdan ötgan mijozning nomini (DN) sarlavha orqali ilovaga uzatadi, ilova esa uni loglaş yoki huquqlarni aniqlaş uçun işlatişi mumkin. proxy_set_header mijozdan kelgan şu nomdagi sarlavhalarni qayta yozadi, lekin ilova portining taşqaridan töğridan-töğri oçiq emasligiga işonç hosil qiling, aks holda sarlavhani soxtalaştiriş mumkin böladi. Sozlamani nginx -t bilan tekşirib, systemctl reload nginx bilan qöllang.
Tekşiriş va sertifikatni bekor qiliş
Hamkor serverida ulaniş curl bilan quyidagiça sinab köriladi:
curl --cert partner.crt --key partner.key https://api.example.uz/v1/orders
Sertifikatsiz urinişda Nginx 400 xatosini va "No required SSL certificate was sent" xabarini qaytaradi, bu sozlama işlayotganini bildiradi. Agar hamkor bilan şartnoma tugasa yoki kalit sizib çiqqan deb gumon qilinsa, sertifikatni bekor qiliş kerak. Buning uçun bekor qilingan sertifikatlar röyxati (CRL) tuziladi va Nginx'ga ssl_crl direktivasi bilan körsatiladi. CRL'ni openssl ca vositasi bilan yaratiş uçun avval uning konfiguratsiyasi va indeks fayli sozlangan bölişi kerak, şundan keyin buyruq quyidagiça böladi:
openssl ca -gencrl -keyfile ca.key -cert ca.crt -out ca.crl
Kiçik loyihalarda soddaroq yöl ham bor: sertifikatlarni qisqa muddatga, masalan 90 kunga çiqariş va muddati tugaganda yangilamaslik. Har holda sertifikatlar muddatini kalendarga yozib qöying, aks holda bir kuni ertalab integratsiya tösatdan töxtab qoladi.
Hostingda bu mumkinmi
mTLS veb-server darajasidagi sozlamani talab qiladi, oddiy shared hostingda esa bu sozlamalar umumiy bölib, mijoz ularni özgartira olmaydi. Şuning uçun mTLS bilan himoyalangan API uçun odatda VPS tanlanadi. sayt.uz'da VPS'ni kabinetdan buyurtma qilib, unga Nginx va yuqoridagi sozlamani örnatişingiz mumkin, server sertifikati uçun esa Let's Encrypt yetarli. Agar loyihangiz uçun qaysi variant töğri kelişini aniqlay olmasangiz, sayt.uz kabinetidan texnik yordamga yozib maslahat oling.