PublicKeyCredential

PublicKeyCredential.authenticatorAttachment Schreibgeschützt

Ein String, der den Mechanismus angibt, mit dem die WebAuthn-Implementierung zum Zeitpunkt des Abschlusses des zugehörigen Aufrufs von navigator.credentials.create() oder navigator.credentials.get() mit dem Authentifikator verbunden ist.

PublicKeyCredential.id Schreibgeschützt

Geerbt von Credential und überschrieben, um die base64url-Kodierung von PublicKeyCredential.rawId zu sein.

PublicKeyCredential.rawId Schreibgeschützt

Ein ArrayBuffer, der den global eindeutigen Identifikator für dieses PublicKeyCredential enthält. Dieser Identifikator kann verwendet werden, um Anmeldeinformationen für zukünftige Aufrufe von navigator.credentials.get() nachzuschlagen.

PublicKeyCredential.response Schreibgeschützt

Eine Instanz eines AuthenticatorResponse-Objekts. Es ist entweder vom Typ AuthenticatorAttestationResponse, wenn das PublicKeyCredential das Ergebnis eines navigator.credentials.create()-Aufrufs war, oder vom Typ AuthenticatorAssertionResponse, wenn das PublicKeyCredential das Ergebnis eines navigator.credentials.get()-Aufrufs war.

PublicKeyCredential.type Schreibgeschützt

Geerbt von Credential. Immer auf public-key für PublicKeyCredential-Instanzen gesetzt.

PublicKeyCredential.getClientCapabilities()

Gibt ein Promise zurück, das mit einem Objekt aufgelöst wird, das verwendet werden kann, um zu überprüfen, ob bestimmte WebAuthn-Funktionen und Erweiterungen unterstützt werden.

PublicKeyCredential.isConditionalMediationAvailable()

Gibt ein Promise zurück, das zu true aufgelöst wird, wenn eine bedingte Vermittlung verfügbar ist.

PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable()

Gibt ein Promise zurück, das zu true aufgelöst wird, wenn ein Authentifikator, der an die Plattform gebunden ist, in der Lage ist, den Benutzer zu verifizieren.

PublicKeyCredential.parseCreationOptionsFromJSON()

Praktische Methode zur Deserialisierung von servergesendeten Anmeldedaten beim Registrieren eines Benutzers mit Anmeldedaten.

PublicKeyCredential.parseRequestOptionsFromJSON()

Praktische Methode zur Deserialisierung von servergesendeten Anfragedaten, wenn ein (registrierter) Benutzer authentifiziert wird.

PublicKeyCredential.signalAllAcceptedCredentials()

Gibt dem Authentifikator alle gültigen Anmeldeinformationen-IDs bekannt, die der Anbieter Server immer noch für einen bestimmten Benutzer bereithält.

PublicKeyCredential.signalCurrentUserDetails()

Gibt dem Authentifikator bekannt, dass ein bestimmter Benutzer seinen Benutzernamen und/oder seinen Anzeigenamen aktualisiert hat.

PublicKeyCredential.signalUnknownCredential()

Gibt dem Authentifikator bekannt, dass eine Anmeldeinformationen-ID durch den Anbieter-Server nicht erkannt wurde, zum Beispiel, weil sie gelöscht wurde.

PublicKeyCredential.getClientExtensionResults()

Wenn Erweiterungen angefordert wurden, gibt diese Methode die Ergebnisse der Verarbeitung dieser Erweiterungen zurück.

PublicKeyCredential.toJSON()

Praktische Methode zur Erstellung einer JSON-String-Darstellung eines PublicKeyCredential zum Senden an den Server, wenn ein Benutzer mit Anmeldedaten registriert und ein registrierter Benutzer authentifiziert wird.

Hier verwenden wir navigator.credentials.create(), um eine neue Anmeldeinformation zu generieren.

const createCredentialOptions = {
  publicKey: {
    challenge: new Uint8Array([
      21, 31, 105 /* 29 more random bytes generated by the server */,
    ]),
    rp: {
      name: "Example CORP",
      id: "login.example.com",
    },
    user: {
      id: new Uint8Array(16),
      name: "canand@example.com",
      displayName: "Carina Anand",
    },
    pubKeyCredParams: [
      {
        type: "public-key",
        alg: -7,
      },
    ],
  },
};

navigator.credentials
  .create(createCredentialOptions)
  .then((newCredentialInfo) => {
    const response = newCredentialInfo.response;
    const clientExtensionsResults =
      newCredentialInfo.getClientExtensionResults();
  })
  .catch((err) => {
    console.error(err);
  });

Hier holen wir eine bestehende Anmeldeinformation von einem Authentifikator ab, indem wir navigator.credentials.get() verwenden.

const requestCredentialOptions = {
  publicKey: {
    challenge: new Uint8Array([
      /* bytes sent from the server */
    ]),
  },
};

navigator.credentials
  .get(requestCredentialOptions)
  .then((credentialInfoAssertion) => {
    // send assertion response back to the server
    // to proceed with the control of the credential
  })
  .catch((err) => {
    console.error(err);
  });

• Die übergeordnete Schnittstelle Credential