TsgcWSAPIServer_WebAuthn › Eventi

TsgcWSAPIServer_WebAuthn Events

Eventi gestibili, raggruppati per scopo, seguiti dall'elenco alfabetico completo.

Pipeline delle richieste

Nome	Descrizione
OnWebAuthnHTTPRequest	Si attiva prima che un endpoint WebAuthn elabori una richiesta HTTP in entrata; consente all'applicazione di esaminare le intestazioni, applicare limiti di frequenza o rifiutare la chiamata.
OnWebAuthnHTTPResponse	Viene generato dopo che il server ha costruito la risposta HTTP per un endpoint WebAuthn ma prima che venga inviata; utile per controllare o decorare il payload e le intestazioni in uscita.
OnWebAuthnException	Viene attivato quando viene generata un'eccezione non gestita durante l'elaborazione di una richiesta WebAuthn; consente all'applicazione di registrare l'errore e di sovrascrivere il codice di risposta HTTP.
OnWebAuthnUnauthorized	Generato quando una connessione WebSocket tenta di utilizzare una risorsa protetta da WebAuthn senza un token valido; consente all'applicazione di decidere se disconnettersi.
OnWebAuthnMetadata	Si attiva quando il server necessita dei metadati dell'autenticatore per un AAGUID; consente all'applicazione di restituire una voce BLOB FIDO MDS memorizzata nella cache o personalizzata.

Registrazione

Nome	Descrizione
OnWebAuthnRegistrationOptionsRequest	Si attiva all'inizio di /register/begin quando un client richiede PublicKeyCredentialCreationOptions; consente all'applicazione di validare l'utente e approvare o rifiutare la cerimonia.
OnWebAuthnRegistrationOptionsResponse	Si attiva dopo che il server ha costruito la risposta PublicKeyCredentialCreationOptions per /register/begin; consente all'applicazione di ispezionare o persistere la challenge generata.
OnWebAuthnRegistrationValidateCredentialId	Viene attivato durante /register/verify per consentire all'applicazione di verificare che il nuovo id di credenziale sia univoco nel suo archivio utenti.
OnWebAuthnRegistrationValidateCertificate	Viene generato durante /register/verify per consentire all'applicazione di validare la catena di certificati dell'attestazione (ad es. contro un FIDO MDS memorizzato nella cache) e di sovrascrivere il controllo integrato.
OnWebAuthnRegistrationSuccessful	Generato al termine di /register/verify quando l'attestazione è stata accettata; in questo punto l'applicazione deve persistere il nuovo record di credenziale per l'utente.
OnWebAuthnRegistrationError	Si attiva quando /register/verify rifiuta l'attestazione; espone la richiesta fallita e la motivazione testuale in modo che l'applicazione possa registrarla o segnalarla.

Autenticazione

Nome	Descrizione
OnWebAuthnAuthenticationOptionsRequest	Generato all'inizio di /authenticate/begin; l'applicazione deve restituire l'elenco delle credenziali registrate per l'utente in modo che il server possa costruire PublicKeyCredentialRequestOptions.
OnWebAuthnAuthenticationOptionsResponse	Viene attivato dopo che il server ha costruito la risposta PublicKeyCredentialRequestOptions per /authenticate/begin; consente all'applicazione di ispezionare o salvare la challenge generata.
OnWebAuthnAuthenticationSuccessful	Si attiva al termine di /authenticate/verify quando la firma dell'assertion è valida; l'applicazione dovrebbe aggiornare il contatore delle firme e stabilire la sessione.
OnWebAuthnAuthenticationError	Viene attivato quando /authenticate/verify rifiuta l'asserzione; espone la richiesta fallita e il motivo testuale affinché l'applicazione possa registrarlo o inviare un avviso.

Tutti gli eventi (in ordine alfabetico)

Nome	Descrizione
OnWebAuthnAuthenticationError	Viene attivato quando /authenticate/verify rifiuta l'asserzione; espone la richiesta fallita e il motivo testuale affinché l'applicazione possa registrarlo o inviare un avviso.
OnWebAuthnAuthenticationOptionsRequest	Generato all'inizio di /authenticate/begin; l'applicazione deve restituire l'elenco delle credenziali registrate per l'utente in modo che il server possa costruire PublicKeyCredentialRequestOptions.
OnWebAuthnAuthenticationOptionsResponse	Viene attivato dopo che il server ha costruito la risposta PublicKeyCredentialRequestOptions per /authenticate/begin; consente all'applicazione di ispezionare o salvare la challenge generata.
OnWebAuthnAuthenticationSuccessful	Si attiva al termine di /authenticate/verify quando la firma dell'assertion è valida; l'applicazione dovrebbe aggiornare il contatore delle firme e stabilire la sessione.
OnWebAuthnException	Viene attivato quando viene generata un'eccezione non gestita durante l'elaborazione di una richiesta WebAuthn; consente all'applicazione di registrare l'errore e di sovrascrivere il codice di risposta HTTP.
OnWebAuthnHTTPRequest	Si attiva prima che un endpoint WebAuthn elabori una richiesta HTTP in entrata; consente all'applicazione di esaminare le intestazioni, applicare limiti di frequenza o rifiutare la chiamata.
OnWebAuthnHTTPResponse	Viene generato dopo che il server ha costruito la risposta HTTP per un endpoint WebAuthn ma prima che venga inviata; utile per controllare o decorare il payload e le intestazioni in uscita.
OnWebAuthnMetadata	Si attiva quando il server necessita dei metadati dell'autenticatore per un AAGUID; consente all'applicazione di restituire una voce BLOB FIDO MDS memorizzata nella cache o personalizzata.
OnWebAuthnRegistrationError	Si attiva quando /register/verify rifiuta l'attestazione; espone la richiesta fallita e la motivazione testuale in modo che l'applicazione possa registrarla o segnalarla.
OnWebAuthnRegistrationOptionsRequest	Si attiva all'inizio di /register/begin quando un client richiede PublicKeyCredentialCreationOptions; consente all'applicazione di validare l'utente e approvare o rifiutare la cerimonia.
OnWebAuthnRegistrationOptionsResponse	Si attiva dopo che il server ha costruito la risposta PublicKeyCredentialCreationOptions per /register/begin; consente all'applicazione di ispezionare o persistere la challenge generata.
OnWebAuthnRegistrationSuccessful	Generato al termine di /register/verify quando l'attestazione è stata accettata; in questo punto l'applicazione deve persistere il nuovo record di credenziale per l'utente.
OnWebAuthnRegistrationValidateCertificate	Viene generato durante /register/verify per consentire all'applicazione di validare la catena di certificati dell'attestazione (ad es. contro un FIDO MDS memorizzato nella cache) e di sovrascrivere il controllo integrato.
OnWebAuthnRegistrationValidateCredentialId	Viene attivato durante /register/verify per consentire all'applicazione di verificare che il nuovo id di credenziale sia univoco nel suo archivio utenti.
OnWebAuthnUnauthorized	Generato quando una connessione WebSocket tenta di utilizzare una risorsa protetta da WebAuthn senza un token valido; consente all'applicazione di decidere se disconnettersi.