Asosiy qismga oʻtish

Oqim · 5-bob

Tokenlar va yangilash

Token manzili nimani qaytaradi, har bir token qancha yashaydi va refresh token rotatsiyasi qanday ishlaydi.

2 daqiqa oʻqish

Token javobi

{
  "access_token": "8kq0H3…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "Tn2c9W…",
  "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ij…",
  "scope": "openid profile email offline_access"
}
Maydon Maʼnosi
access_token UserInfo uchun shaffof boʻlmagan satr. Uni tahlil qilmang
token_type Har doim Bearer
expires_in Access token amal qilish muddati, soniyalarda
refresh_token Faqat offline_access berilganda
id_token Foydalanuvchi shaxsi yozilgan imzoli JWT — ID token bobiga qarang
scope Haqiqatda berilgan scopeʼlar; soʻralganidan kam boʻlishi mumkin

Javob Cache-Control: no-store bilan keladi. Tokenlarni hech qachon logga yozmang.

Amal qilish muddatlari

Token Muddat Izoh
Authorization code 60 soniya Bir martalik
Access token 1 soat Shaffof emas; faqat UserInfo ni chaqirib tekshiring
Refresh token 30 kun Har ishlatilganda almashtiriladi
ID token exp ga qarang Kirish dalili, API kaliti emas

Yangilash

Refresh token olish uchun offline_access scopeʼini soʻrang. Access token muddati tugaganda yangi juftlik oling:

curl -X POST https://myid.goxost.net/oauth/token \
  -u "gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM:YOUR_CLIENT_SECRET" \
  -d grant_type=refresh_token \
  -d refresh_token=Tn2c9W…

Ochiq klientlar -u oʻrniga client_id ni soʻrov tanasida yuboradi.

Javob yuqoridagi bilan bir xil koʻrinishda, lekin yangi refresh_token va yangi id_token (nonce siz) bilan keladi. Refresh tokenni saqlang va eskisidan darhol voz keching. Torroq scope yuborib, kamroq scopeʼli token olish mumkin; openid qolishi shart.

Rotatsiya va qayta ishlatishni aniqlash

Har bir refresh token aynan bir marta ishlaydi. Har bir yangilash yangi token qaytaradi, bitta kirishdan kelib chiqqan tokenlar zanjiri esa bir oilani tashkil qiladi.

Agar allaqachon ishlatilgan refresh token yana yuborilsa, GOXOST ID uni oʻgʻirlangan deb hisoblaydi va butun oilani bekor qiladi: hujumchining ham, haqiqiy ilovaning ham tokenlari ishlamay qoladi va foydalanuvchi qayta kirishi kerak boʻladi. Soʻrov invalid_grant bilan tugaydi.

Muhim

Agar ilovangizning bir nechta jarayoni bir vaqtda yangilash qila olsa, yangilashni ketma-ket bajaring (har bir foydalanuvchi uchun qulf) — aks holda bir xil token bilan ikkita parallel soʻrov qayta ishlatishdek koʻrinadi va foydalanuvchi tizimdan chiqarib yuboriladi.

Refresh token foydalanuvchi parolini oʻzgartirganda, xizmatingizni Ulangan xizmatlar roʻyxatidan olib tashlaganda yoki bloklanganda ham ishlamay qoladi.

Bekor qilish

POST/oauth/revoke

Foydalanuvchi xizmatingizdan chiqqanda tokenni bekor qiling (RFC 7009):

curl -X POST https://myid.goxost.net/oauth/revoke \
  -u "gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM:YOUR_CLIENT_SECRET" \
  -d token=Tn2c9W… \
  -d token_type_hint=refresh_token
Parametr Qiymat
token Access yoki refresh token
token_type_hint Ixtiyoriy: access_token yoki refresh_token

Javob — boʻsh tanali 200 OK, hatto token nomaʼlum yoki allaqachon bekor qilingan boʻlsa ham. Refresh tokenni bekor qilish butun kirish oilasini yakunlaydi.