Asosiy qismga oʻtish

Oqim · 4-bob

PKCE bilan authorization code

GOXOST ID qoʻllab-quvvatlaydigan yagona oqim: brauzer bir martalik kodni qaytarib olib keladi, ilovangiz esa uni PKCE verifier bilan birga tokenlarga almashtiradi.

2 daqiqa oʻqish

Avtorizatsiya soʻrovi

GET/oauth/authorize

Foydalanuvchi brauzerini quyidagi query parametrlari bilan shu manzilga yuboring:

Parametr Majburiy Qiymat
response_type ha code
client_id ha Sizning gxid_… klient ID ingiz
redirect_uri ha Roʻyxatga olingan URI laringizdan aynan bittasi
scope ha Boʻsh joy bilan ajratiladi; openid boʻlishi shart
state ha Tasodifiy qiymat, qaytishda tekshiriladi
code_challenge ha BASE64URL(SHA256(code_verifier))
code_challenge_method ha S256
nonce tavsiya etiladi Tasodifiy qiymat, id_token ichida qaytariladi
prompt yoʻq none, login yoki consent
max_age yoʻq Oxirgi kirishdan keyin necha soniya oʻtgach qayta kirish talab qilinishi
Eslatma

PKCE har bir klient uchun, jumladan maxfiy klientlar uchun ham majburiy. code_challenge siz yoki plain usuli bilan yuborilgan soʻrovlar invalid_request bilan rad etiladi.

PKCE

  1. code_verifier yarating: kriptografik xavfsiz tasodifiy generatordan olingan, A-Z a-z 0-9 - . _ ~ belgilaridan iborat 43–128 ta belgi.
  2. code_challenge = BASE64URL(SHA256(code_verifier)) ni = toʻldiruvchisiz hisoblang.
  3. Verifierni sessiyada saqlang; faqat challengeni yuboring.
  4. Verifierni kod bilan birga /oauth/token ga yuboring.

Kodni ushlab olgan kishi verifiersiz undan foydalana olmaydi.

prompt va max_age

Qiymat Xatti-harakat
(berilmagan) Kerak boʻlsa kirish; rozilik hali berilmagan boʻlsa, soʻrash
prompt=login Foydalanuvchi tizimda boʻlsa ham, parolni har doim qayta soʻrash
prompt=consent Rozilik ekranini har doim koʻrsatish
prompt=none Hech qanday sahifa koʻrsatmaslik. Foydalanuvchi tizimga kirmagan yoki ruxsat bermagan boʻlsa, xato qaytarish
max_age=300 Oxirgi kirishdan 300 soniyadan koʻp vaqt oʻtgan boʻlsa, parolni qayta soʻrash

prompt=none foydalanuvchida GOXOST ID seansi bor-yoʻqligini sezdirmasdan tekshirish uchun qulay. Mumkin boʻlgan xatolar: login_required, consent_required, interaction_required. Agar max_age ga tayansangiz, auth_time claimʼini u bilan solishtiring.

Callback

Muvaffaqiyatli boʻlsa, brauzer redirect_uri ingizga qaytadi:

https://example.com/auth/goxost/callback?code=Splx10BeZQQYbYS6WxSbIA&state=af0ifjsldkj&iss=https%3A%2F%2Fmyid.goxost.net

Xato boʻlsa (masalan, foydalanuvchi Rad etish tugmasini bosgan boʻlsa):

https://example.com/auth/goxost/callback?error=access_denied&error_description=The+user+denied+access&state=af0ifjsldkj&iss=https%3A%2F%2Fmyid.goxost.net

Ikkala holatda ham:

  1. state ni sessiyadagi qiymat bilan solishtiring. Farq qilsa yoki yoʻq boʻlsa, toʻxtang.
  2. state ni sessiyadan oʻchiring, shunda undan ikki marta foydalanib boʻlmaydi.
  3. error kelsa, foydalanuvchiga tushunarli xabar koʻrsating — Xatolar bobiga qarang.

Ikkala javobda iss (RFC 9207) ham boʻladi. Kutubxonangiz uni tekshirsa, u https://myid.goxost.net ga teng boʻlishi kerak.

Kodni almashtirish

POST/oauth/token

Serveringizdan form-encoded (application/x-www-form-urlencoded) soʻrov:

Parametr Qiymat
grant_type authorization_code
code Callbackdan kelgan kod
redirect_uri Avtorizatsiya soʻrovidagi qiymatning aynan oʻzi
code_verifier PKCE verifier
client_id Ochiq klientlar va client_secret_post uchun
client_secret Faqat client_secret_post bilan

Kod berilganidan 60 soniya oʻtib eskiradi va faqat bir marta ishlatilishi mumkin. Ikkinchi urinish invalid_grant bilan tugaydi. Javob Tokenlar va yangilash bobida tasvirlangan.