Asosiy qismga oʻtish

Boshlash · 3-bob

Klientni roʻyxatdan oʻtkazish

Foydalanuvchilarni GOXOST ID orqali tizimga kirituvchi har bir xizmat — klient. Klientlarni GOXOST jamoasi roʻyxatga oladi; bu bobda nimani soʻrash va qaysi turni tanlash tushuntiriladi.

2 daqiqa oʻqish

Klientni qanday soʻrash kerak

Mustaqil roʻyxatdan oʻtish hozircha mavjud emas. GOXOST Yordam markaziga murojaat yuboring va quyidagilarni koʻrsating:

  • foydalanuvchilar rozilik ekranida koʻradigan xizmat nomi va logotipi;
  • klient turi — maxfiy yoki ochiq (pastga qarang);
  • barcha redirect URI lar, aynan yozilgan holda;
  • chiqish dan foydalansangiz, chiqishdan keyingi redirect URI lar;
  • kerakli scopeʼlar: openid va ixtiyoriy ravishda profile, email, offline_access.

Sizga gxid_ bilan boshlanadigan client_id beriladi. Maxfiy klientga bir marta koʻrsatiladigan client_secret ham beriladi — uni serveringizning maxfiy sozlamalarida saqlang, hech qachon kodda yoki repozitoriyda emas. Secret oshkor boʻlib qolsa, qoʻllab-quvvatlash xizmatidan yangisini soʻrang.

Klient turlari

Maxfiy Ochiq
Qayerda ishlaydi Serveringizda (PHP, Node.js, Python…) Brauzer ilovasi (SPA), mobil yoki desktop ilova
client_secret Ha Yoʻq
/oauth/token da autentifikatsiya client_secret_basic yoki client_secret_post Faqat client_id
PKCE S256 Majburiy Majburiy

Kirishda server ishtirok etsa, hatto oʻz backendiga ega SPA uchun ham, maxfiy turni tanlang. Ochiq turni faqat kod toʻliq foydalanuvchi qurilmasida ishlaganda, yaʼni secretni saqlab boʻlmaydigan holda tanlang.

client_secret_basic

Klient ID va secret Authorization sarlavhasida yuboriladi (HTTP Basic, ikkalasi avval URL-kodlanadi):

Authorization: Basic base64(urlencode(client_id) ":" urlencode(client_secret))

client_secret_post

Klient ID va secret boshqa parametrlar bilan birga forma tanasida yuboriladi:

client_id=gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM&client_secret=YOUR_CLIENT_SECRET&grant_type=…

Redirect URI lar

  • Siz yuboradigan redirect_uri roʻyxatga olinganlardan biriga aynan mos kelishi kerak: sxema, host, port, yoʻl va query. Wildcard ham, prefiks boʻyicha moslash ham yoʻq.
  • Faqat https qabul qilinadi. Yagona istisno — ishlab chiqish uchun http://localhost (va 127.0.0.1).
  • Mobil ilovalar ilovaga biriktirilgan https havoladan foydalanadi (iOS da Universal Links, Android da App Links); Mobil va SPA bobiga qarang.
Muhim

client_id yoki redirect_uri notoʻgʻri boʻlsa, GOXOST ID xato sahifasini koʻrsatadi va yoʻnaltirishni amalga oshirmaydi — nomaʼlum manzilga yoʻnaltirish xavfli boʻlardi.

Foydalanuvchi xizmatingizga birinchi marta kirganda GOXOST ID undan ruxsat soʻraydi va soʻralayotgan maʼlumotlarni sanab koʻrsatadi. GOXOST ekotizimi xizmatlari ishonchli deb belgilanishi va bu ekranni oʻtkazib yuborishi mumkin. Foydalanuvchi istalgan vaqtda hisobidagi Ulangan xizmatlar boʻlimida ruxsatni olib tashlashi mumkin; keyingi kirishda ruxsat yana soʻraladi.