PublicKeyCredential: authenticatorAttachment-Eigenschaft
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die schreibgeschützte Eigenschaft authenticatorAttachment
des PublicKeyCredential
-Interfaces ist ein String, der die allgemeine Kategorie des Authentifikators angibt, der während des zugehörigen Aufrufes von navigator.credentials.create()
oder navigator.credentials.get()
verwendet wird.
Wert
Ein String, welcher einer der folgenden Werte sein wird:
"platform"
-
Der Authentifikator ist Teil des Geräts, auf dem WebAuthn läuft (als Plattform-Authenticator bezeichnet), daher wird WebAuthn mit ihm über ein für diese Plattform verfügbares Transportmittel kommunizieren, wie zum Beispiel eine plattformspezifische API. Ein öffentlicher Schlüssel, der an einen Plattform-Authenticator gebunden ist, wird als Plattform-Anmeldedaten bezeichnet.
"cross-platform"
-
Der Authentifikator ist nicht Teil des Geräts, auf dem WebAuthn läuft (als Roaming-Authenticator bezeichnet, da er zwischen verschiedenen Geräten wechseln kann), daher wird WebAuthn mit ihm über ein plattformübergreifendes Transportprotokoll wie Bluetooth oder NFC kommunizieren. Ein öffentlicher Schlüssel, der an einen Roaming-Authenticator gebunden ist, wird als Roaming-Anmeldedaten bezeichnet.
Beispiele
const options = {
challenge: new Uint8Array(26) /* from the server */,
rp: {
name: "Example CORP",
id: "login.example.com",
},
user: {
id: new Uint8Array(26) /* To be changed for each user */,
name: "canand@example.com",
displayName: "Carina Anand",
},
pubKeyCredParams: [
{
type: "public-key",
alg: -7,
},
],
};
navigator.credentials
.create({ publicKey: options })
.then((pubKeyCredential) => {
const attachment = pubKeyCredential.authenticatorAttachment;
// Do something with authenticatorAttachment
})
.catch((err) => {
// Deal with any error
});
Spezifikationen
Specification |
---|
Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-publickeycredential-authenticatorattachment |
Browser-Kompatibilität
BCD tables only load in the browser