IdentityCredential

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das IdentityCredential Interface der Federated Credential Management API (FedCM) repräsentiert ein Benutzeridentitätsnachweis, der aus einem erfolgreichen föderierten Anmeldevorgang resultiert.

Ein erfolgreicher Aufruf von navigator.credentials.get(), der eine identity-Option enthält, wird mit einer Instanz von IdentityCredential erfüllt.

Credential IdentityCredential

Instanzeigenschaften

Erbt Eigenschaften von seinem Vorfahren, Credential.

IdentityCredential.isAutoSelected Schreibgeschützt

Ein boolescher Wert, der angibt, ob die föderierte Anmeldung mithilfe der automatischen Wiederanmeldung (d.h. ohne Benutzervermittlung) durchgeführt wurde oder nicht.

IdentityCredential.token

Gibt das Token zurück, das zur Validierung der zugehörigen Anmeldung verwendet wird.

Beispiele

Vertrauenswürdige Parteien (RPs) können navigator.credentials.get() mit der Option identity aufrufen, um eine Anfrage zu stellen, dass sich Benutzer über einen Identitätsanbieter (IdP) mithilfe von Identitätsföderation bei der RP anmelden. Eine typische Anfrage sieht folgendermaßen aus:

js
async function signIn() {
  const identityCredential = await navigator.credentials.get({
    identity: {
      providers: [
        {
          configURL: "https://accounts.idp.example/config.json",
          clientId: "********",
          nonce: "******",
        },
      ],
    },
  });
}

Bei Erfolg wird dieser Aufruf mit einer Instanz von IdentityCredential erfüllt. Daraus könnten Sie zum Beispiel den Wert von IdentityCredential.token zurückgeben:

js
console.log(identityCredential.token);

Schauen Sie sich die Federated Credential Management API (FedCM) für weitere Details darüber an, wie dies funktioniert. Dieser Aufruf startet den Anmeldefluss, der im FedCM Anmeldefluss beschrieben wird.

Spezifikationen

Specification
Federated Credential Management API
# browser-api-identity-credential-interface

Browser-Kompatibilität

Siehe auch