Discovery hujjati
GET/.well-known/openid-configuration
{
"issuer": "https://myid.goxost.net",
"authorization_endpoint": "https://myid.goxost.net/oauth/authorize",
"token_endpoint": "https://myid.goxost.net/oauth/token",
"userinfo_endpoint": "https://myid.goxost.net/oauth/userinfo",
"jwks_uri": "https://myid.goxost.net/oauth/jwks",
"revocation_endpoint": "https://myid.goxost.net/oauth/revoke",
"end_session_endpoint": "https://myid.goxost.net/oauth/logout",
"scopes_supported": ["openid", "profile", "email", "offline_access"],
"response_types_supported": ["code"],
"response_modes_supported": ["query"],
"grant_types_supported": ["authorization_code", "refresh_token"],
"subject_types_supported": ["public"],
"id_token_signing_alg_values_supported": ["RS256"],
"token_endpoint_auth_methods_supported": ["client_secret_basic", "client_secret_post", "none"],
"revocation_endpoint_auth_methods_supported": ["client_secret_basic", "client_secret_post", "none"],
"code_challenge_methods_supported": ["S256"],
"prompt_values_supported": ["none", "login", "consent"],
"claims_supported": ["iss", "sub", "aud", "exp", "iat", "auth_time", "nonce", "amr", "azp", "name", "locale", "updated_at", "email", "email_verified"],
"claims_parameter_supported": false,
"request_parameter_supported": false,
"request_uri_parameter_supported": false,
"authorization_response_iss_parameter_supported": true
}
Kutubxonalar bu hujjatni bir marta oʻqiydi va keshlaydi. Kodga faqat issuer manzilini yozing.
JWKS
GET/oauth/jwks
{
"keys": [
{
"kty": "RSA",
"use": "sig",
"alg": "RS256",
"kid": "20261116-093000-a1b2c3",
"n": "0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx4…",
"e": "AQAB"
}
]
}
Kalitlar vaqti-vaqti bilan almashtiriladi; almashtirish paytida toʻplamda eski va yangi kalit birga boʻladi. Toʻplamni keshlang, nomaʼlum kid bilan token kelsa, uni rad etishdan oldin toʻplamni qayta yuklab oling (daqiqasiga koʻpi bilan bir marta).
ID tokenni tekshirish
Yaxshi kutubxona bularning barchasini siz uchun bajaradi. Qoʻlda tekshirsangiz, quyidagilarning barchasini tekshiring va birinchi muvaffaqiyatsizlikdayoq tokenni rad eting:
- Bu uch qismli JWT; sarlavhadagi
alg—RS256(noneyokiHS256ni hech qachon qabul qilmang). - Sarlavhadagi
kidJWKS dagi kalitga mos keladi va imzo shu kalit bilan toʻgʻri. issaynanhttps://myid.goxost.netga teng.audtarkibida sizningclient_idingiz bor;azpmavjud boʻlsa, uclient_idingizga teng.expkelajakda,iatesa kelajakda emas (soatlar farqi uchun 60 soniyagacha ruxsat bering).nonceshu kirish uchun saqlagan qiymatingizga teng.max_ageyuborgan boʻlsangiz,auth_timeyetarlicha yangi.
Shundan keyin claimʼlarga ishonish mumkin: sub — foydalanuvchi.
Serveringiz ID tokenni HTTPS orqali bevosita /oauth/token dan olgan boʻlsa, OpenID Connect imzo tekshiruvini (1–2-qadamlar) oʻtkazib yuborishga ruxsat beradi, ammo 3–6-qadamlar baribir majburiy. Imzoni baribir tekshirish arzon va xavfsizroq.