Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
IdentityCredential
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell:Dies ist eineexperimentelle Technologie
Überprüfen Sie dieBrowser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur insicheren Kontexten (HTTPS) in einigen oder allenunterstützenden Browsern verfügbar.
DasIdentityCredential Interface derFederated Credential Management API (FedCM) repräsentiert ein Benutzeridentitätsnachweis, der aus einem erfolgreichen föderierten Anmeldeprozess hervorgeht.
Ein erfolgreicher Aufruf vonnavigator.credentials.get(), der eineidentity-Option enthält, wird mit einerIdentityCredential-Instanz erfüllt.
Instanzeigenschaften
Erbt Eigenschaften von seinem Vorfahren,Credential.
IdentityCredential.configURLSchreibgeschütztExperimentellEin String, der die URL derKonfigurationsdatei des genutztenIdP für die Anmeldung spezifiziert.
IdentityCredential.isAutoSelectedSchreibgeschütztExperimentellEin boolescher Wert, der anzeigt, ob die föderierte Anmeldung mittelsautomatischer Wiederauthentifizierung (d.h. ohne Nutzervermittlung) durchgeführt wurde oder nicht.
IdentityCredential.tokenExperimentellGibt das Token zurück, das zur Validierung der zugehörigen Anmeldung verwendet wird.
Statische Methoden
IdentityCredential.disconnect()ExperimentellTrennt das genutzte Konto der föderierten Anmeldung, um das Berechtigungsnachweis zu erhalten.
Beispiele
Grundlegende föderierte Anmeldung
Vertrauende Parteien (RPs) könnennavigator.credentials.get() mit deridentity-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 einerIdentityCredential-Instanz erfüllt. Daraus könnte man zum Beispiel den Wert vonIdentityCredential.token zurückgeben:
console.log(identityCredential.token);Sehen Sie sich dieFederated Credential Management API (FedCM) für weitere Details darüber an, wie dies funktioniert. Dieser Aufruf startet den Anmeldeablauf, der imFedCM-Anmeldeablauf beschrieben wird.
Spezifikationen
| Specification |
|---|
| Federated Credential Management API # browser-api-identity-credential-interface |