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 Anmeldeprozess hervorgeht.

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

Instanzeigenschaften

Erbt Eigenschaften von seinem Vorfahren, Credential.

IdentityCredential.configURL Schreibgeschützt Experimentell: Ein String, der die URL der Konfigurationsdatei des genutzten IdP für die Anmeldung spezifiziert.
IdentityCredential.isAutoSelected Schreibgeschützt Experimentell: Ein boolescher Wert, der anzeigt, ob die föderierte Anmeldung mittels automatischer Wiederauthentifizierung (d.h. ohne Nutzervermittlung) durchgeführt wurde oder nicht.
IdentityCredential.token Experimentell: Gibt das Token zurück, das zur Validierung der zugehörigen Anmeldung verwendet wird.

Statische Methoden

IdentityCredential.disconnect() Experimentell: Trennt das genutzte Konto der föderierten Anmeldung, um das Berechtigungsnachweis zu erhalten.

Vertrauende Parteien (RPs) können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, damit sich Benutzer über einen Identitätsanbieter (IdP) mit Identitäts-Föderation bei der RP anmelden. Eine typische Anfrage sieht folgendermaßen aus:

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

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

console.log(identityCredential.token);

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