JWKS 公钥集合

GET

/.well-known/jwks.json

返回当前及验证过渡期公钥集合，只用于验证 JWT，不包含私钥。
公开只读元数据，CORS 与 Discovery 一致：请求带 Origin 时返回
Access-Control-Allow-Origin: *（不带凭据），且始终 Vary: Origin。
另返回 Access-Control-Expose-Headers: ETag，让浏览器 JS 能读取 ETag 并发起
条件请求；200 与 304 均适用。该头只出现在 JWKS，不扩到其它路由。
缓存策略为 Cache-Control: public, max-age=60, must-revalidate，RP 可在 60 秒内
直接使用共享缓存；过期后用 If-None-Match 发起条件请求，公钥集合未变时返回 304。
ETag 由 JWKS 字节的 SHA-256 派生，确定性且跨实例一致；密钥轮换或吊销后 ETag 改变。

请求参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

公钥集合

Headers

Bodyapplication/json

示例

{}

🔵304

🔴503服务器故障

修改于 2026-08-16 10:45:00

OIDC Discovery

OAuth 授权码入口