Asosiy qismga oʻtish

Boshlash · 2-bob

Tez boshlash

Butun jarayon besh qadamda: klient olish, PKCE qiymatlarini yaratish, foydalanuvchini GOXOST ID ga yuborish, kodni almashtirish va foydalanuvchi maʼlumotlarini oʻqish.

2 daqiqa oʻqish

1. Klient oling

GOXOST jamoasidan xizmatingizni roʻyxatga olishni soʻrang (Klientni roʻyxatdan oʻtkazish bobiga qarang). Sizga quyidagilar beriladi:

  • client_id — masalan, gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM;
  • client_secret — faqat maxfiy (server) klientlar uchun, bir marta koʻrsatiladi;
  • redirect URI — siz yuboradigan koʻrinishda aynan roʻyxatga olinadi, masalan https://example.com/auth/goxost/callback.

2. state, nonce va PKCE qiymatlarini yarating

Har bir kirish uchun uchta tasodifiy qiymat yarating va ularni foydalanuvchi sessiyasida saqlang:

  • state — callbackni soxta soʻrovlardan himoya qiladi;
  • nonce — id_token ni aynan shu kirishga bogʻlaydi;
  • code_verifier — 43–128 ta tasodifiy belgi; uning SHA-256 xeshini code_challenge sifatida yuboring.
code_verifier=$(openssl rand -base64 48 | tr -d '=+/\n' | cut -c1-64)
code_challenge=$(printf '%s' "$code_verifier" | openssl dgst -sha256 -binary | openssl base64 -A | tr '+/' '-_' | tr -d '=')

3. Foydalanuvchini kirishga yuboring

Brauzerni avtorizatsiya manziliga yoʻnaltiring:

https://myid.goxost.net/oauth/authorize
  ?response_type=code
  &client_id=gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM
  &redirect_uri=https%3A%2F%2Fexample.com%2Fauth%2Fgoxost%2Fcallback
  &scope=openid%20profile%20email
  &state=af0ifjsldkj
  &nonce=n-0S6_WzA2Mj
  &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
  &code_challenge_method=S256

Foydalanuvchi tizimga kiradi va birinchi marta xizmatingizga ruxsat beradi. Soʻng GOXOST ID uni qaytaradi:

https://example.com/auth/goxost/callback?code=Splx10BeZQQYbYS6WxSbIA&state=af0ifjsldkj

4. Kodni almashtiring

state sessiyadagi qiymatga mos kelishini tekshiring, soʻng serveringizdan token manzilini chaqiring. Kod 60 soniya yashaydi va faqat bir marta ishlaydi.

curl -X POST https://myid.goxost.net/oauth/token \
  -u "gxid_01JD3W8V6Q2N9F4K7T5R0YHXBM:YOUR_CLIENT_SECRET" \
  -d grant_type=authorization_code \
  -d code=Splx10BeZQQYbYS6WxSbIA \
  -d redirect_uri=https://example.com/auth/goxost/callback \
  -d code_verifier=YOUR_CODE_VERIFIER
{
  "access_token": "8kq0H3…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ij…",
  "scope": "openid profile email"
}

5. Foydalanuvchini aniqlang

id_token ni tekshiring (Discovery, JWKS va ID token bobiga qarang) va uning claimʼlarini oʻqing yoki access token bilan UserInfo ni chaqiring:

curl https://myid.goxost.net/oauth/userinfo -H "Authorization: Bearer 8kq0H3…"
{
  "sub": "01JD3X2M7K9QF5B8N4T6W0RZCE",
  "name": "Aziza Karimova",
  "locale": "uz",
  "updated_at": 1763290000,
  "email": "aziza@example.com",
  "email_verified": true
}

Foydalanuvchini sub boʻyicha toping yoki yarating. Tayyor — foydalanuvchi tizimga kirdi.

Manzillar

Manzil Vazifasi
GET /.well-known/openid-configuration Discovery hujjati
GET /oauth/jwks id_token ni tekshirish uchun ochiq kalitlar
GET /oauth/authorize Kirish va rozilik (brauzer)
POST /oauth/token Kod va refresh tokenni almashtirish
GET yoki POST /oauth/userinfo Foydalanuvchi claimʼlari (Bearer token)
POST /oauth/revoke Tokenni bekor qilish (RFC 7009)
GET /oauth/logout GOXOST ID seansini yakunlash (brauzer)