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 Sign-In resultiert.

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

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Vorfahren, Credential.

IdentityCredential.configURL Schreibgeschützt Experimentell: Ein String, der die URL der Konfigurationsdatei des genutzten IdP für das Sign-In spezifiziert.
IdentityCredential.isAutoSelected Schreibgeschützt Experimentell: Ein boolescher Wert, der anzeigt, ob das föderierte Sign-In mithilfe von Auto-reauthentication (d.h. ohne Benutzermediation) durchgeführt wurde oder nicht.
IdentityCredential.token Experimentell: Gibt das Token zurück, das zur Validierung des zugehörigen Sign-Ins verwendet wird.

Statische Methoden

IdentityCredential.disconnect() Experimentell: Trennt das verwendete föderierte Sign-In-Konto, um das Credential zu erhalten.

Relying parties (RPs) können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, dass sich Benutzer über einen Identity Provider (IdP) bei der RP anmelden, indem Identitätsföderation verwendet wird. Ein typischer Aufruf sieht folgendermaßen aus:

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. Daraus könnten Sie zum Beispiel den IdentityCredential.token-Wert zurückgeben:

console.log(identityCredential.token);

Werfen Sie einen Blick auf die Federated Credential Management API (FedCM) für weitere Details, wie dies funktioniert. Dieser Aufruf startet den Sign-In-Fluss, der im FedCM Sign-In-Fluss beschrieben ist.