Açıklama
chrome.webAuthenticationProxy API, uzak bir ana makinede çalışan uzaktan masaüstü yazılımının, Web Authentication API (WebAuthn) isteklerini yerel bir istemcide işlemek için yakalamasına olanak tanır.
İzinler
webAuthenticationProxyKullanılabilirlik
Türler
CreateRequest
Özellikler
- requestDetailsJson
dize
PublicKeyCredentialCreationOptions, JSON dizesi olarak serileştirilmiş şekildenavigator.credentials.create()'ye iletilir. Serileştirme biçimi,PublicKeyCredential.parseCreationOptionsFromJSON()ile uyumludur. - requestId
sayı
İsteğin opak tanımlayıcısı.
CreateResponseDetails
Özellikler
- hata
DOMExceptionDetails isteğe bağlı
Varsa, uzaktan istekten elde edilen
DOMException. - requestId
sayı
CreateRequestöğesininrequestId. - responseJson
dize isteğe bağlı
Uzak istek tarafından oluşturulan
PublicKeyCredential, varsa href="https://w3c.github.io/webauthn/#dom-publickeycredential-tojson">PublicKeyCredential.toJSON()çağrılarak JSON dizesi olarak serileştirilir.
DOMExceptionDetails
Özellikler
- mesaj
dize
- ad
dize
GetRequest
Özellikler
- requestDetailsJson
dize
PublicKeyCredentialRequestOptions, JSON dizesi olarak serileştirilmiş şekildenavigator.credentials.get()'ye iletilir. Serileştirme biçimi,PublicKeyCredential.parseRequestOptionsFromJSON()ile uyumludur. - requestId
sayı
İsteğin opak tanımlayıcısı.
GetResponseDetails
Özellikler
- hata
DOMExceptionDetails isteğe bağlı
Varsa, uzaktan istekten elde edilen
DOMException. - requestId
sayı
CreateRequestöğesininrequestId. - responseJson
dize isteğe bağlı
Uzak istek tarafından oluşturulan
PublicKeyCredential, varsa href="https://w3c.github.io/webauthn/#dom-publickeycredential-tojson">PublicKeyCredential.toJSON()çağrılarak JSON dizesi olarak serileştirilir.
IsUvpaaRequest
Özellikler
- requestId
sayı
İsteğin opak tanımlayıcısı.
IsUvpaaResponseDetails
Özellikler
- isUvpaa
boolean
- requestId
sayı
Yöntemler
attach()
chrome.webAuthenticationProxy.attach(): Promise<string | undefined>
Bu uzantıyı etkin Web Authentication API istek proxy'si yapar.
Uzak masaüstü uzantıları genellikle bu ana bilgisayara uzak oturumun eklendiğini algıladıktan sonra bu yöntemi çağırır. Bu yöntem hatasız döndüğünde WebAuthn isteklerinin normal işlenmesi askıya alınır ve bu uzantı API'sinden gelen etkinlikler tetiklenir.
Farklı bir uzantı zaten eklenmişse bu yöntem hata verir.
Eklenen uzantı, normal WebAuthn isteği işlemine devam etmek için uzak masaüstü oturumu sona erdiğinde detach() işlevini çağırmalıdır. Uzantılar kaldırılırsa otomatik olarak ayrılır.
Yerel bir uygulamadan (askıya alınmış olabilir) uzantıya uzaktan oturum ekleme değişikliğini bildirmek için onRemoteSessionStateChange etkinliğine bakın.
İadeler
-
Promise<string | undefined>
completeCreateRequest()
chrome.webAuthenticationProxy.completeCreateRequest(
details: CreateResponseDetails,
): Promise<void>
navigator.credentials.create() çağrısının sonucunu bildirir. İstek iptal edilmediyse (bu durumda onRequestCanceled etkinliği tetiklenir) uzantı, aldığı her onCreateRequest etkinliği için bu işlevi çağırmalıdır.
Parametreler
- ayrıntılar
İadeler
-
Promise<void>
completeGetRequest()
chrome.webAuthenticationProxy.completeGetRequest(
details: GetResponseDetails,
): Promise<void>
navigator.credentials.get() çağrısının sonucunu bildirir. İstek iptal edilmediyse (bu durumda onRequestCanceled etkinliği tetiklenir) uzantı, aldığı her onGetRequest etkinliği için bu işlevi çağırmalıdır.
Parametreler
- ayrıntılar
İadeler
-
Promise<void>
completeIsUvpaaRequest()
chrome.webAuthenticationProxy.completeIsUvpaaRequest(
details: IsUvpaaResponseDetails,
): Promise<void>
PublicKeyCredential.isUserVerifyingPlatformAuthenticator() çağrısının sonucunu bildirir. Uzantı, aldığı her onIsUvpaaRequest etkinliği için bu işlevi çağırmalıdır.
Parametreler
- ayrıntılar
İadeler
-
Promise<void>
detach()
chrome.webAuthenticationProxy.detach(): Promise<string | undefined>
Bu uzantının etkin Web Authentication API isteği proxy'si olmasını engeller.
Bu yöntem genellikle uzantı, bir uzak masaüstü oturumunun sonlandırıldığını algıladığında çağrılır. Bu yöntem döndürüldüğünde uzantı, etkin Web Authentication API isteği proxy'si olmaktan çıkar.
Yerel bir uygulamadan (askıya alınmış olabilir) uzantıya uzaktan oturum ekleme değişikliğini bildirmek için onRemoteSessionStateChange etkinliğine bakın.
İadeler
-
Promise<string | undefined>
Etkinlikler
onCreateRequest
chrome.webAuthenticationProxy.onCreateRequest.addListener(
callback: function,
)
Bir WebAuthn navigator.credentials.create() çağrısı gerçekleştiğinde tetiklenir. Uzantı, completeCreateRequest() işlevini requestInfo adresinden gelen requestId ile çağırarak yanıt vermelidir.
Parametreler
- callback
işlev
callbackparametresi şu şekilde görünür:(requestInfo: CreateRequest) => void
- requestInfo
-
onGetRequest
chrome.webAuthenticationProxy.onGetRequest.addListener(
callback: function,
)
Bir WebAuthn navigator.credentials.get() çağrısı gerçekleştiğinde tetiklenir. Uzantı, completeGetRequest() işlevini requestInfo konumundan gelen requestId ile çağırarak yanıt vermelidir.
Parametreler
- callback
işlev
callbackparametresi şu şekilde görünür:(requestInfo: GetRequest) => void
- requestInfo
-
onIsUvpaaRequest
chrome.webAuthenticationProxy.onIsUvpaaRequest.addListener(
callback: function,
)
PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable() araması yapıldığında tetiklenir. Uzantı, completeIsUvpaaRequest() işlevini requestInfo konumundan gelen requestId ile çağırarak yanıt vermelidir.
Parametreler
- callback
işlev
callbackparametresi şu şekilde görünür:(requestInfo: IsUvpaaRequest) => void
- requestInfo
-
onRemoteSessionStateChange
chrome.webAuthenticationProxy.onRemoteSessionStateChange.addListener(
callback: function,
)
Bu uzantıyla ilişkili bir yerel uygulama, varsayılan kullanıcı verileri dizini içindeki WebAuthenticationProxyRemoteSessionStateChange adlı bir dizinde uzantının kimliğine eşit bir ada sahip bir dosyaya yazarak bu etkinliğin tetiklenmesine neden olabilir.
Dosyanın içeriği boş olmalıdır. Yani bu etkinliğin tetiklenmesi için dosyanın içeriğinin değiştirilmesi gerekmez.
Yerel ana makine uygulaması, uzantı hizmet çalışanı askıya alınmışken olası bir uzak oturum durumu değişikliğini (ör. ayrılmıştan bağlıya veya tam tersi) bildirmek için bu etkinlik mekanizmasını kullanabilir. Uzantı, bu etkinliğin işleyicisinde attach() veya detach() API yöntemlerini uygun şekilde çağırabilir.
Etkinlik işleyici, yükleme sırasında eşzamanlı olarak kaydedilmelidir.
Parametreler
- callback
işlev
callbackparametresi şu şekilde görünür:() => void
onRequestCanceled
chrome.webAuthenticationProxy.onRequestCanceled.addListener(
callback: function,
)
Bir onCreateRequest veya onGetRequest etkinliği iptal edildiğinde (WebAuthn isteği arayan tarafından iptal edildiği veya zaman aşımına uğradığı için) tetiklenir. Uzantı, bu etkinliği aldığında istemci tarafında ilgili isteğin işlenmesini iptal etmelidir. Uzantılar, iptal edilen istekleri tamamlayamaz.
Parametreler
- callback
işlev
callbackparametresi şu şekilde görünür:(requestId: number) => void
- requestId
sayı
-