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, bevor Sie diese produktiv verwenden.

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

Die IdentityCredential-Schnittstelle der Federated Credential Management API (FedCM) repräsentiert eine Benutzeridentitätsnachweis, der aus einer erfolgreichen föderierten Anmeldung resultiert.

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

Credential IdentityCredential

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Vorfahren, Credential.

IdentityCredential.isAutoSelected Nur lesbar

Ein boolescher Wert, der anzeigt, ob die föderierte Anmeldung mithilfe der automatischen Wiederanmeldung (d.h. ohne Benutzermediation) 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, damit sich Benutzer über einen Identitätsanbieter (IdP) mithilfe der Identitätsföderation beim RP anmelden. Eine typische Anfrage könnte so aussehen:

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. Aus dieser könnte man zum Beispiel den IdentityCredential.token-Wert 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 im FedCM-Anmeldevorgang beschriebenen Anmeldevorgang.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch