TsgcWSAPIServer_WebAuthn › Ereignisse

TsgcWSAPIServer_WebAuthn Ereignisse

Ereignisse, die Sie behandeln können, nach Zweck gruppiert, gefolgt von der vollständigen alphabetischen Liste.

Anfrage-Pipeline

Name	Beschreibung
OnWebAuthnHTTPRequest	Wird ausgelöst, bevor ein WebAuthn-Endpunkt eine eingehende HTTP-Anfrage verarbeitet; ermöglicht es der Anwendung, Header zu inspizieren, Rate-Limits anzuwenden oder den Aufruf abzulehnen.
OnWebAuthnHTTPResponse	Wird ausgelöst, nachdem der Server die HTTP-Antwort für einen WebAuthn-Endpunkt erstellt hat, aber bevor sie gesendet wird; nützlich, um das ausgehende Payload und die Header zu auditieren oder zu dekorieren.
OnWebAuthnException	Wird ausgelöst, wenn bei der Verarbeitung einer WebAuthn-Anfrage eine nicht behandelte Ausnahme ausgelöst wird; ermöglicht es der Anwendung, den Fehler zu protokollieren und den HTTP-Antwortcode zu überschreiben.
OnWebAuthnUnauthorized	Wird ausgelöst, wenn eine WebSocket-Verbindung versucht, eine WebAuthn-geschützte Ressource ohne gültiges Token zu verwenden; ermöglicht es der Anwendung zu entscheiden, ob die Verbindung getrennt werden soll.
OnWebAuthnMetadata	Wird ausgelöst, wenn der Server Authenticator-Metadaten für eine AAGUID benötigt; ermöglicht es der Anwendung, einen zwischengespeicherten oder benutzerdefinierten FIDO-MDS-BLOB-Eintrag zurückzugeben.

Registrierung

Name	Beschreibung
OnWebAuthnRegistrationOptionsRequest	Wird zu Beginn von /register/begin ausgelöst, wenn ein Client PublicKeyCredentialCreationOptions anfordert; ermöglicht es der Anwendung, den Benutzer zu validieren und die Zeremonie zu genehmigen oder abzulehnen.
OnWebAuthnRegistrationOptionsResponse	Wird ausgelöst, nachdem der Server die PublicKeyCredentialCreationOptions-Antwort für /register/begin erstellt hat; ermöglicht es der Anwendung, die generierte Challenge zu überprüfen oder zu persistieren.
OnWebAuthnRegistrationValidateCredentialId	Wird während /register/verify ausgelöst, damit die Anwendung prüfen kann, dass die neue Credential-ID in ihrem Benutzerspeicher eindeutig ist.
OnWebAuthnRegistrationValidateCertificate	Wird während /register/verify ausgelöst, damit die Anwendung die Attestierungs-Zertifikatskette validieren (zum Beispiel gegen einen zwischengespeicherten FIDO MDS) und die integrierte Prüfung überschreiben kann.
OnWebAuthnRegistrationSuccessful	Wird am Ende von /register/verify ausgelöst, wenn die Attestierung akzeptiert wurde; hier muss die Anwendung den neuen Anmeldeinformationsdatensatz für den Benutzer persistieren.
OnWebAuthnRegistrationError	Wird ausgelöst, wenn /register/verify die Attestation ablehnt; stellt die fehlgeschlagene Anfrage und den textuellen Grund bereit, sodass die Anwendung darüber protokollieren oder alarmieren kann.

Authentifizierung

Name	Beschreibung
OnWebAuthnAuthenticationOptionsRequest	Wird zu Beginn von /authenticate/begin ausgelöst; die Anwendung muss die Liste der für den Benutzer registrierten Anmeldedaten zurückgeben, damit der Server PublicKeyCredentialRequestOptions erstellen kann.
OnWebAuthnAuthenticationOptionsResponse	Wird ausgelöst, nachdem der Server die PublicKeyCredentialRequestOptions-Antwort für /authenticate/begin erstellt hat; ermöglicht der Anwendung, die generierte Challenge zu prüfen oder zu persistieren.
OnWebAuthnAuthenticationGetCredential	Wird bei der Prüfung einer Assertion ausgelöst, wenn das vom Browser verwendete Credential nicht in der Credential-Liste der Zeremonie enthalten ist (Anmeldung ohne Benutzernamen und Passkey-Autofill); die Anwendung gibt den Credential-Datensatz aus ihrem eigenen Speicher zurück.
OnWebAuthnAuthenticationSuccessful	Wird am Ende von /authenticate/verify ausgelöst, wenn die Assertion-Signatur gültig ist; die Anwendung sollte den Sign-Zähler aktualisieren und die Sitzung herstellen.
OnWebAuthnAuthenticationError	Wird ausgelöst, wenn /authenticate/verify die Assertion ablehnt; stellt die fehlgeschlagene Anforderung und den textuellen Grund bereit, sodass die Anwendung darüber protokollieren oder alarmieren kann.

Alle Ereignisse (alphabetisch)

Name	Beschreibung
OnWebAuthnAuthenticationError	Wird ausgelöst, wenn /authenticate/verify die Assertion ablehnt; stellt die fehlgeschlagene Anforderung und den textuellen Grund bereit, sodass die Anwendung darüber protokollieren oder alarmieren kann.
OnWebAuthnAuthenticationGetCredential	Wird bei der Prüfung einer Assertion ausgelöst, wenn das vom Browser verwendete Credential nicht in der Credential-Liste der Zeremonie enthalten ist (Anmeldung ohne Benutzernamen und Passkey-Autofill); die Anwendung gibt den Credential-Datensatz aus ihrem eigenen Speicher zurück.
OnWebAuthnAuthenticationOptionsRequest	Wird zu Beginn von /authenticate/begin ausgelöst; die Anwendung muss die Liste der für den Benutzer registrierten Anmeldedaten zurückgeben, damit der Server PublicKeyCredentialRequestOptions erstellen kann.
OnWebAuthnAuthenticationOptionsResponse	Wird ausgelöst, nachdem der Server die PublicKeyCredentialRequestOptions-Antwort für /authenticate/begin erstellt hat; ermöglicht der Anwendung, die generierte Challenge zu prüfen oder zu persistieren.
OnWebAuthnAuthenticationSuccessful	Wird am Ende von /authenticate/verify ausgelöst, wenn die Assertion-Signatur gültig ist; die Anwendung sollte den Sign-Zähler aktualisieren und die Sitzung herstellen.
OnWebAuthnException	Wird ausgelöst, wenn bei der Verarbeitung einer WebAuthn-Anfrage eine nicht behandelte Ausnahme ausgelöst wird; ermöglicht es der Anwendung, den Fehler zu protokollieren und den HTTP-Antwortcode zu überschreiben.
OnWebAuthnHTTPRequest	Wird ausgelöst, bevor ein WebAuthn-Endpunkt eine eingehende HTTP-Anfrage verarbeitet; ermöglicht es der Anwendung, Header zu inspizieren, Rate-Limits anzuwenden oder den Aufruf abzulehnen.
OnWebAuthnHTTPResponse	Wird ausgelöst, nachdem der Server die HTTP-Antwort für einen WebAuthn-Endpunkt erstellt hat, aber bevor sie gesendet wird; nützlich, um das ausgehende Payload und die Header zu auditieren oder zu dekorieren.
OnWebAuthnMetadata	Wird ausgelöst, wenn der Server Authenticator-Metadaten für eine AAGUID benötigt; ermöglicht es der Anwendung, einen zwischengespeicherten oder benutzerdefinierten FIDO-MDS-BLOB-Eintrag zurückzugeben.
OnWebAuthnRegistrationError	Wird ausgelöst, wenn /register/verify die Attestation ablehnt; stellt die fehlgeschlagene Anfrage und den textuellen Grund bereit, sodass die Anwendung darüber protokollieren oder alarmieren kann.
OnWebAuthnRegistrationOptionsRequest	Wird zu Beginn von /register/begin ausgelöst, wenn ein Client PublicKeyCredentialCreationOptions anfordert; ermöglicht es der Anwendung, den Benutzer zu validieren und die Zeremonie zu genehmigen oder abzulehnen.
OnWebAuthnRegistrationOptionsResponse	Wird ausgelöst, nachdem der Server die PublicKeyCredentialCreationOptions-Antwort für /register/begin erstellt hat; ermöglicht es der Anwendung, die generierte Challenge zu überprüfen oder zu persistieren.
OnWebAuthnRegistrationSuccessful	Wird am Ende von /register/verify ausgelöst, wenn die Attestierung akzeptiert wurde; hier muss die Anwendung den neuen Anmeldeinformationsdatensatz für den Benutzer persistieren.
OnWebAuthnRegistrationValidateCertificate	Wird während /register/verify ausgelöst, damit die Anwendung die Attestierungs-Zertifikatskette validieren (zum Beispiel gegen einen zwischengespeicherten FIDO MDS) und die integrierte Prüfung überschreiben kann.
OnWebAuthnRegistrationValidateCredentialId	Wird während /register/verify ausgelöst, damit die Anwendung prüfen kann, dass die neue Credential-ID in ihrem Benutzerspeicher eindeutig ist.
OnWebAuthnUnauthorized	Wird ausgelöst, wenn eine WebSocket-Verbindung versucht, eine WebAuthn-geschützte Ressource ohne gültiges Token zu verwenden; ermöglicht es der Anwendung zu entscheiden, ob die Verbindung getrennt werden soll.