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 |
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
code_verifieryarating: kriptografik xavfsiz tasodifiy generatordan olingan,A-Z a-z 0-9 - . _ ~belgilaridan iborat 43–128 ta belgi.code_challenge = BASE64URL(SHA256(code_verifier))ni=toʻldiruvchisiz hisoblang.- Verifierni sessiyada saqlang; faqat challengeni yuboring.
- Verifierni kod bilan birga
/oauth/tokenga 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:
stateni sessiyadagi qiymat bilan solishtiring. Farq qilsa yoki yoʻq boʻlsa, toʻxtang.stateni sessiyadan oʻchiring, shunda undan ikki marta foydalanib boʻlmaydi.errorkelsa, 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.