TsgcHTTP_JWT_Server › 事件

TsgcHTTP_JWT_Server 事件

可处理的事件按用途分组,后跟完整的字母顺序列表。

请求管道

名称描述
OnJWTBeforeRequest在任何 JWT 处理之前,对每个传入的 HTTP/WebSocket 请求触发;将 Cancel 设置为 True 可绕过此连接的 JWT 验证。
OnJWTUnauthorized当请求没有有效的 JWT 且即将被拒绝时触发;将 Disconnect=False 设置为仍然接受(例如,CORS 预检请求)。
OnJWTException在解码或验证令牌时引发异常时触发,以便应用程序记录错误。
OnJWTResponseError在发送 Unauthorized HTTP 响应之前触发,允许自定义代码(默认 401)、文本(默认"Unauthorized")和头部。

验证

名称描述
OnJWTBeforeValidateToken在 Bearer 令牌被提取后、验证之前触发;将 Cancel 设为 True 跳过验证(请求将被视为已授权)。
OnJWTBeforeValidateSignature在 JWT 解码完成后、签名验证之前触发,公开解码后的 Header 和 Payload,并允许按令牌覆盖验证所用的 Secret/PublicKey。
OnJWTAfterValidateToken在签名和声明验证运行后触发;检查 Header、Payload 和 Error,并翻转 Valid 标志以接受或拒绝令牌。

所有事件(按字母顺序排列)

名称描述
OnJWTAfterValidateToken在签名和声明验证运行后触发;检查 Header、Payload 和 Error,并翻转 Valid 标志以接受或拒绝令牌。
OnJWTBeforeRequest在任何 JWT 处理之前,对每个传入的 HTTP/WebSocket 请求触发;将 Cancel 设置为 True 可绕过此连接的 JWT 验证。
OnJWTBeforeValidateSignature在 JWT 解码完成后、签名验证之前触发,公开解码后的 Header 和 Payload,并允许按令牌覆盖验证所用的 Secret/PublicKey。
OnJWTBeforeValidateToken在 Bearer 令牌被提取后、验证之前触发;将 Cancel 设为 True 跳过验证(请求将被视为已授权)。
OnJWTException在解码或验证令牌时引发异常时触发,以便应用程序记录错误。
OnJWTResponseError在发送 Unauthorized HTTP 响应之前触发,允许自定义代码(默认 401)、文本(默认"Unauthorized")和头部。
OnJWTUnauthorized当请求没有有效的 JWT 且即将被拒绝时触发;将 Disconnect=False 设置为仍然接受(例如,CORS 预检请求)。