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 eine Benutzeridentitätsberechtigung, die aus einer erfolgreichen föderierten Anmeldung resultiert.

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

Credential IdentityCredential

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Vorfahren, Credential.

IdentityCredential.isAutoSelected Schreibgeschützt

Ein boolescher Wert, der anzeigt, ob die föderierte Anmeldung unter Nutzung der automatischen Wieder-Authentifizierung (d.h. ohne Benutzereingriff) durchgeführt wurde oder nicht.

IdentityCredential.token

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

Beispiele

Vertrauenswürdige Parteien (RPs) können navigator.credentials.get() mit der Option identity aufrufen, um eine Anfrage zu stellen, damit sich Benutzer über einen Identitätsanbieter (IdP) mit 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 IdentityCredential-Instanz erfüllt. Davon könnten Sie beispielsweise 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 an, wie dies funktioniert. Dieser Aufruf startet den Anmeldefluss, der im FedCM-Anmeldefluss beschrieben ist.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch