Skip to main content
Public API’dan foydalanish uchun OAuth talab etilmaydi. Maxfiy, server tomonidagi integratsiya uchun cheklangan ruxsatlarga ega (scoped) API kalitidan boshlang va tezkor boshlash qo‘llanmasiga amal qiling. Xavfsizlik siyosatingiz qisqa muddatli kirish tokenlarini talab qilsa yoki integratsiya platformangiz ushbu oqimni allaqachon qo‘llab-quvvatlasa, OAuth client credentials usulini tanlang. Ikkala variant ham xizmat hisobidan (service account) foydalanadi. Xizmat hisobi — bu integratsiyaning identifikatori bo‘lib, uchinchi autentifikatsiya usuli emas.

​
Qismlar o‘zaro qanday bog‘langan

Har bir integratsiya uchun bitta xizmat hisobi yarating. Shu hisob uchun API kalit yoki OAuth client’dan birini tanlang; har bir API so‘rovida ikkala usul ham kerak emas. Hech bir hisob ma’lumoti hisobning joriy ruxsatlaridan oshib keta olmaydi. Tezkor boshlash qo‘llanmasida Basic autentifikatsiyasi ishlatiladi. API kalitlar uchun Bearer sarlavhasi ham qo‘llab-quvvatlanadi; ushbu sarlavhadan foydalanish OAuth client kerakligini anglatmaydi.

​
Oddiy integratsiya uchun API kalitni tanlang

Agar maxfiy kalitlarni boshqarish tizimingizda (secret manager) saqlanadigan sir xavfsizlik talablaringizga mos kelsa, o‘zingizning rejalashtirilgan vazifalaringiz, hisobot skriptlari, ma’lumotlar konveyerlari yoki boshqa backend xizmatlari uchun API kalitdan foydalaning.
  • Autentifikatsiyalangan so‘rovlarni to‘g‘ridan-to‘g‘ri yuboring; tokenni almashtirish talab etilmaydi.
  • Faqat ish yuki uchun zarur bo‘lgan ruxsatlarni tanlang va amal qilish muddatini belgilang.
  • Kalitni almashtirish davri (overlap window) orqali yangilang yoki u oshkor bo‘lsa, darhol bekor qiling.
API kalitli integratsiya uchun OAuth client kerak emas. Tezkor boshlash qo‘llanmasidan boshlang, so‘ng yaratish va yangilash tartibi uchun API kalitlar bo‘limiga qarang.

​
Qisqa muddatli kirish tokenlari uchun OAuth’ni tanlang

Tashkilotingiz muddati tugaydigan kirish tokenlarini talab qilsa yoki integratsiya vositasi client_credentials grant turini kutsa, konfidensial backend xizmati uchun OAuth client credentials usulidan foydalaning.
  1. Xizmat hisobi uchun cheklangan ruxsatlarga ega OAuth client yarating.
  2. Sozlash jarayonida berilgan client autentifikatsiya usuli yordamida clientni mintaqaviy token endpoint’ingizda autentifikatsiya qiling.
  3. Olingan kirish tokenini API so‘rovlaringiz bilan birga yuboring. Joriy token muddati tugashidan oldin yangi token oling.
OAuth integratsiyangizga tokenni olish va uning muddatini boshqarishni qo‘shadi. Client siri baribir xavfsiz saqlanishi va almashtirilishi kerak; qisqa muddatli tokenlar bu mas’uliyatni bartaraf etmaydi. Client credentials usuli refresh tokenlardan foydalanmaydi: yangi kirish tokenini olish uchun clientni qaytadan autentifikatsiya qiling. Tashkilotingiz uchun OAuth’ga kirish yoqilgan bo‘lishi kerak. U yoqilmagan bo‘lsa, API kalitdan foydalaning yoki talablaringiz bo‘yicha Living Security qo‘llab-quvvatlash xizmatiga murojaat qiling. Client yaratish, bir martalik sirlar, bekor qilish va tiklash haqida OAuth client credentials bo‘limida ma’lumot olishingiz mumkin.

​
Hisob ma’lumotlarini backend’da saqlang

Xizmat hisobining API kalitlari va OAuth client sirlari server tomonidagi maxfiy ma’lumotlar omborida saqlanishi lozim. Ularni brauzer kodiga, mobil ilovalarga, manba kodini boshqarish tizimiga yoki jurnallarga joylashtirmang. Xizmat hisobining hisob ma’lumotlari ish yuki nomidan harakat qiladi; ular shaxsni tizimga kiritmaydi va mijoz roziligi oqimini ta’minlamaydi. Ikkala usul bilan ham tashkilotingiz uchun mintaqaviy API xostidan foydalaning. Autentifikatsiya usulini o‘zgartirish resurs URL manzilini, API versiyasini yoki operatsiya talab qiladigan ruxsatlarni o‘zgartirmaydi.