自省端点 (Introspection Endpoint)
v2.2 中添加
自省端点是对 RFC 7662 的实现。
它可以用于验证参考令牌(如果使用者 (consumer) 不支持适当的 JWT 或密码库,也可以用于验证 JWT)。
自省端点需要使用一个域 (scope) 凭据进行认证(访问令牌只有包含域才可以被允许来自省令牌)。
示例 (Example)
POST /connect/introspect
Authorization: Basic xxxyyy
token=<token>
成功的响应会返回 200 状态码以及有效或者无效的令牌:
{
"active": true,
"sub": "123"
}
未知的或者过期的令牌被标记为无效:
{
"active": false,
}
如果域没有被授权,那么非法的请求将会返回 400 或 401 状态码。
备注 自省端点替代了更老的访问令牌验证端点。由于自省端点需要认证,它在参考令牌中添加了私有特性,而这在之前是没有的。访问令牌验证端点仍然存在,但是不推荐使用它,你可以在 EndpointOptions
中禁用它,并选用自省端点。