chrome.webAuthenticationProxy

chrome.webAuthenticationProxy.attach(): Promise<string | undefined>

Imposta questa estensione come proxy di richiesta dell'API Web Authentication attiva.

Le estensioni di Desktop remoto in genere chiamano questo metodo dopo aver rilevato l'allegato di una sessione remota a questo host. Una volta che questo metodo viene restituito senza errori, l'elaborazione regolare delle richieste WebAuthn viene sospesa e vengono generati eventi da questa API di estensione.

Questo metodo non va a buon fine e genera un errore se è già collegata un'altra estensione.

L'estensione allegata deve chiamare detach() al termine della sessione di desktop remoto per riprendere la normale elaborazione delle richieste WebAuthn. Le estensioni vengono automaticamente scollegate se vengono scaricate.

Fai riferimento all'evento onRemoteSessionStateChange per segnalare una modifica dell'allegato della sessione remota da un'applicazione nativa all'estensione (eventualmente sospesa).

chrome.webAuthenticationProxy.completeCreateRequest(
  details: CreateResponseDetails,
): Promise<void>

Riporta il risultato di una chiamata navigator.credentials.create(). L'estensione deve chiamare questo metodo per ogni evento onCreateRequest ricevuto, a meno che la richiesta non sia stata annullata (nel qual caso viene attivato un evento onRequestCanceled).

chrome.webAuthenticationProxy.completeGetRequest(
  details: GetResponseDetails,
): Promise<void>

Riporta il risultato di una chiamata navigator.credentials.get(). L'estensione deve chiamare questo metodo per ogni evento onGetRequest ricevuto, a meno che la richiesta non sia stata annullata (nel qual caso viene attivato un evento onRequestCanceled).

chrome.webAuthenticationProxy.completeIsUvpaaRequest(
  details: IsUvpaaResponseDetails,
): Promise<void>

Riporta il risultato di una chiamata PublicKeyCredential.isUserVerifyingPlatformAuthenticator(). L'estensione deve chiamare questo metodo per ogni evento onIsUvpaaRequest ricevuto.

chrome.webAuthenticationProxy.detach(): Promise<string | undefined>

Rimuove questa estensione in modo che non sia più il proxy attivo per le richieste API Web Authentication.

Questo metodo viene in genere chiamato quando l'estensione rileva che una sessione di desktop remoto è stata terminata. Una volta restituito questo metodo, l'estensione non è più il proxy di richiesta dell'API Web Authentication attiva.

Fai riferimento all'evento onRemoteSessionStateChange per segnalare una modifica dell'allegato della sessione remota da un'applicazione nativa all'estensione (eventualmente sospesa).

chrome.webAuthenticationProxy.onCreateRequest.addListener(
  callback: function,
)

Viene attivato quando si verifica una chiamata WebAuthn navigator.credentials.create(). L'estensione deve fornire una risposta chiamando completeCreateRequest() con requestId da requestInfo.

chrome.webAuthenticationProxy.onGetRequest.addListener(
  callback: function,
)

Viene attivato quando si verifica una chiamata navigator.credentials.get() di WebAuthn. L'estensione deve fornire una risposta chiamando completeGetRequest() con requestId da requestInfo

chrome.webAuthenticationProxy.onIsUvpaaRequest.addListener(
  callback: function,
)

Viene attivato quando si verifica una chiamata PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable(). L'estensione deve fornire una risposta chiamando completeIsUvpaaRequest() con requestId da requestInfo

chrome.webAuthenticationProxy.onRemoteSessionStateChange.addListener(
  callback: function,
)

Un'applicazione nativa associata a questa estensione può attivare questo evento scrivendo in un file con un nome uguale all'ID dell'estensione in una directory denominata WebAuthenticationProxyRemoteSessionStateChange all'interno della directory dei dati utente predefinita

I contenuti del file devono essere vuoti. ovvero non è necessario modificare i contenuti del file per attivare questo evento.

L'applicazione host nativa può utilizzare questo meccanismo di eventi per segnalare un possibile cambiamento di stato della sessione remota (ad esempio da scollegata ad allegata o viceversa) mentre il service worker dell'estensione è possibilmente sospeso. Nel gestore di questo evento, l'estensione può chiamare i metodi API attach() o detach() di conseguenza.

Il listener di eventi deve essere registrato in modo sincrono al momento del caricamento.

chrome.webAuthenticationProxy.onRequestCanceled.addListener(
  callback: function,
)

Viene attivato quando un evento onCreateRequest o onGetRequest viene annullato (perché la richiesta WebAuthn è stata interrotta dal chiamante o perché è scaduto il timeout). Quando riceve questo evento, l'estensione deve annullare l'elaborazione della richiesta corrispondente sul lato client. Le estensioni non possono completare una richiesta una volta annullata.