TsgcWSAPIServer_WebAuthn › 事件

TsgcWSAPIServer_WebAuthn 事件

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

请求管道

名称	描述
OnWebAuthnHTTPRequest	在 WebAuthn 端点处理传入的 HTTP 请求之前触发；允许应用程序检查标头、应用速率限制或拒绝调用。
OnWebAuthnHTTPResponse	在服务器为 WebAuthn 端点构建 HTTP 响应后、发送之前触发；用于审计或装饰传出载荷和标头。
OnWebAuthnException	当处理 WebAuthn 请求时抛出未处理异常时触发；允许应用程序记录错误并覆盖 HTTP 响应代码。
OnWebAuthnUnauthorized	当 WebSocket 连接尝试使用受 WebAuthn 保护的资源但没有有效令牌时触发；允许应用程序决定是否断开连接。
OnWebAuthnMetadata	当服务器需要某个 AAGUID 的身份验证器元数据时触发；允许应用程序返回缓存或自定义的 FIDO MDS BLOB 条目。

注册

名称	描述
OnWebAuthnRegistrationOptionsRequest	在客户端请求 PublicKeyCredentialCreationOptions 时，在 /register/begin 开始处触发；允许应用程序验证用户并批准或拒绝该仪式。
OnWebAuthnRegistrationOptionsResponse	当服务器为 /register/begin 构建完 PublicKeyCredentialCreationOptions 响应后触发；允许应用程序检查或持久化生成的挑战值。
OnWebAuthnRegistrationValidateCredentialId	在 /register/verify 期间触发，让应用程序检查新凭据 id 在其用户存储中是否唯一。
OnWebAuthnRegistrationValidateCertificate	在 /register/verify 期间触发，让应用程序验证认证证书链（例如与缓存的 FIDO MDS 进行对比）并覆盖内置检查。
OnWebAuthnRegistrationSuccessful	在 /register/verify 结束时，当证明被接受后触发；应用程序必须在此处为用户持久化新的凭据记录。
OnWebAuthnRegistrationError	当 /register/verify 拒绝认证时触发；暴露失败的请求和文本原因，以便应用程序记录或发出警报。

身份验证

名称	描述
OnWebAuthnAuthenticationOptionsRequest	在 /authenticate/begin 开始时触发；应用程序必须返回为该用户注册的凭证列表，以便服务器构建 PublicKeyCredentialRequestOptions。
OnWebAuthnAuthenticationOptionsResponse	在服务器构建了 /authenticate/begin 的 PublicKeyCredentialRequestOptions 响应后触发；允许应用程序检查或持久化生成的挑战。
OnWebAuthnAuthenticationSuccessful	在 /authenticate/verify 验证断言签名有效后触发；应用程序应更新签名计数器并建立会话。
OnWebAuthnAuthenticationError	当 /authenticate/verify 拒绝断言时触发；公开失败的请求和文字原因，以便应用程序可以记录或发出警报。

所有事件（按字母顺序排列）

名称	描述
OnWebAuthnAuthenticationError	当 /authenticate/verify 拒绝断言时触发；公开失败的请求和文字原因，以便应用程序可以记录或发出警报。
OnWebAuthnAuthenticationOptionsRequest	在 /authenticate/begin 开始时触发；应用程序必须返回为该用户注册的凭证列表，以便服务器构建 PublicKeyCredentialRequestOptions。
OnWebAuthnAuthenticationOptionsResponse	在服务器构建了 /authenticate/begin 的 PublicKeyCredentialRequestOptions 响应后触发；允许应用程序检查或持久化生成的挑战。
OnWebAuthnAuthenticationSuccessful	在 /authenticate/verify 验证断言签名有效后触发；应用程序应更新签名计数器并建立会话。
OnWebAuthnException	当处理 WebAuthn 请求时抛出未处理异常时触发；允许应用程序记录错误并覆盖 HTTP 响应代码。
OnWebAuthnHTTPRequest	在 WebAuthn 端点处理传入的 HTTP 请求之前触发；允许应用程序检查标头、应用速率限制或拒绝调用。
OnWebAuthnHTTPResponse	在服务器为 WebAuthn 端点构建 HTTP 响应后、发送之前触发；用于审计或装饰传出载荷和标头。
OnWebAuthnMetadata	当服务器需要某个 AAGUID 的身份验证器元数据时触发；允许应用程序返回缓存或自定义的 FIDO MDS BLOB 条目。
OnWebAuthnRegistrationError	当 /register/verify 拒绝认证时触发；暴露失败的请求和文本原因，以便应用程序记录或发出警报。
OnWebAuthnRegistrationOptionsRequest	在客户端请求 PublicKeyCredentialCreationOptions 时，在 /register/begin 开始处触发；允许应用程序验证用户并批准或拒绝该仪式。
OnWebAuthnRegistrationOptionsResponse	当服务器为 /register/begin 构建完 PublicKeyCredentialCreationOptions 响应后触发；允许应用程序检查或持久化生成的挑战值。
OnWebAuthnRegistrationSuccessful	在 /register/verify 结束时，当证明被接受后触发；应用程序必须在此处为用户持久化新的凭据记录。
OnWebAuthnRegistrationValidateCertificate	在 /register/verify 期间触发，让应用程序验证认证证书链（例如与缓存的 FIDO MDS 进行对比）并覆盖内置检查。
OnWebAuthnRegistrationValidateCredentialId	在 /register/verify 期间触发，让应用程序检查新凭据 id 在其用户存储中是否唯一。
OnWebAuthnUnauthorized	当 WebSocket 连接尝试使用受 WebAuthn 保护的资源但没有有效令牌时触发；允许应用程序决定是否断开连接。