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 Federierten Credential-Management-API (FedCM) stellt ein Benutzeridentitäts-Credential dar, das aus einem erfolgreichen föderierten Anmeldevorgang stammt.

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

Instanzeigenschaften

Erbt Eigenschaften von seinem Vorgänger, Credential.

IdentityCredential.configURL Schreibgeschützt Experimentell: Ein String, der die URL der Konfigurationsdatei des für die Anmeldung verwendeten IdP angibt.
IdentityCredential.isAutoSelected Schreibgeschützt Experimentell: Ein boolescher Wert, der angibt, ob die föderierte Anmeldung mit automatischer Wiederanmeldung (d.h. ohne Benutzermediation) durchgeführt wurde oder nicht.
IdentityCredential.token Experimentell: Gibt das Token zurück, das zur Validierung der zugehörigen Anmeldung verwendet wurde.

Statische Methoden

IdentityCredential.disconnect() Experimentell: Trennt das für die Erlangung des Credentials verwendete föderierte Anmeldekonto.

Vertrauensparteien (RPs) können navigator.credentials.get() mit der identity Option aufrufen, um eine Anfrage zu stellen, dass Benutzer sich über einen Identitätsanbieter (IdP) mithilfe der Identitätsföderation beim RP anmelden. Eine typische Anfrage könnte so aussehen:

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

Wenn erfolgreich, wird dieser Aufruf mit einer IdentityCredential Instanz erfüllt. Aus dieser könnten Sie beispielsweise den IdentityCredential.token Wert zurückgeben:

console.log(identityCredential.token);

Lesen Sie im Federierten Credential Management API (FedCM) nach, um mehr Details darüber zu erfahren, wie dies funktioniert. Dieser Aufruf wird den Anmeldevorgang einleiten, der im FedCM Anmeldevorgang beschrieben wird.