chrome.webAuthenticationProxy

chrome.webAuthenticationProxy.attach(
  callback?: function,
)

Rende questa estensione il proxy di richiesta API Web Authentication attivo.

In genere le estensioni desktop remoto chiamano questo metodo dopo aver rilevato il collegamento di una sessione remota all'host. Quando questo metodo viene restituito senza errori, l'elaborazione regolare delle richieste WebAuthn viene sospesa e vengono generati gli eventi dell'API di estensione.

Questo metodo non riesce e restituisce un errore se è già collegata un'estensione diversa.

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

Fai riferimento all'evento onRemoteSessionStateChange per segnalare una modifica del collegamento della sessione remota da un'applicazione nativa all'estensione (possibilmente sospesa).

chrome.webAuthenticationProxy.completeCreateRequest(
  details: CreateResponseDetails,
  callback?: function,
)

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

chrome.webAuthenticationProxy.completeGetRequest(
  details: GetResponseDetails,
  callback?: function,
)

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

chrome.webAuthenticationProxy.completeIsUvpaaRequest(
  details: IsUvpaaResponseDetails,
  callback?: function,
)

Segnala il risultato di una chiamata PublicKeyCredential.isUserVerifyingPlatformAuthenticator(). L'estensione deve effettuare una chiamata per ogni evento onIsUvpaaRequest ricevuto.

chrome.webAuthenticationProxy.detach(
  callback?: function,
)

Impedisce che l'estensione sia il proxy di richiesta API Web Authentication attivo.

Questo metodo viene generalmente chiamato quando l'estensione rileva che una sessione di Remote Desktop è stata terminata. Una volta restituito questo metodo, l'estensione non è più il proxy di richiesta API Web Authentication attivo.

Fai riferimento all'evento onRemoteSessionStateChange per segnalare una modifica del collegamento della sessione remota da un'applicazione nativa all'estensione (possibilmente sospesa).

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

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

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

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

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

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

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

Un'applicazione nativa associata a questa estensione può causare l'attivazione dell'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. Ad esempio, non è necessario modificare i contenuti del file per attivare questo evento.

L'applicazione host nativa può utilizzare questo meccanismo di evento per segnalare una possibile modifica dello stato della sessione remota (ad esempio da scollegata a collegata o viceversa) mentre il service worker di estensione è eventualmente sospeso. Nel gestore di questo evento, l'estensione può chiamare i metodi dell'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é è scaduta). Quando riceve questo evento, l'estensione deve annullare l'elaborazione della richiesta corrispondente sul lato client. Le estensioni non possono completare una richiesta dopo averla annullata.