Asosiy qismga oʻtish

Maʼlumotnoma · 9-bob

Discovery, JWKS va ID token

Kutubxonalar manzil va kalitlarni qayerdan topadi hamda ID tokenni oʻzingiz qanday tekshirishingiz mumkin.

1 daqiqa oʻqish

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:

  1. Bu uch qismli JWT; sarlavhadagi alg — RS256 (none yoki HS256 ni hech qachon qabul qilmang).
  2. Sarlavhadagi kid JWKS dagi kalitga mos keladi va imzo shu kalit bilan toʻgʻri.
  3. iss aynan https://myid.goxost.net ga teng.
  4. aud tarkibida sizning client_id ingiz bor; azp mavjud boʻlsa, u client_id ingizga teng.
  5. exp kelajakda, iat esa kelajakda emas (soatlar farqi uchun 60 soniyagacha ruxsat bering).
  6. nonce shu kirish uchun saqlagan qiymatingizga teng.
  7. max_age yuborgan boʻlsangiz, auth_time yetarlicha yangi.

Shundan keyin claimʼlarga ishonish mumkin: sub — foydalanuvchi.

Maslahat

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.