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_tokenni aynan shu kirishga bogʻlaydi;code_verifier— 43–128 ta tasodifiy belgi; uning SHA-256 xeshinicode_challengesifatida 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) |