IdentityCredential
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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.
Die IdentityCredential-Schnittstelle der Federated Credential Management API (FedCM) repräsentiert einen Identitätsnachweis eines Benutzers, der aus einer erfolgreichen föderierten Anmeldung hervorgeht.
Ein erfolgreicher Aufruf von navigator.credentials.get() mit der Option identity liefert eine IdentityCredential-Instanz.
Instanzeigenschaften
Erbt Eigenschaften von der übergeordneten Schnittstelle Credential.
IdentityCredential.configURLSchreibgeschützt-
Eine Zeichenfolge mit der URL der Konfigurationsdatei des für die Anmeldung verwendeten IdP.
IdentityCredential.isAutoSelectedSchreibgeschützt-
Ein boolescher Wert, der angibt, ob die föderierte Anmeldung mittels automatischer Neuauthentifizierung (d.h. ohne Mitwirkung des Benutzers) durchgeführt wurde.
IdentityCredential.tokenSchreibgeschützt-
Gibt das Token zurück, mit dem die zugehörige Anmeldung validiert wird.
Statische Methoden
IdentityCredential.disconnect()-
Trennt die Verbindung zu dem für den Erhalt des Identitätsnachweises verwendeten Konto für die föderierte Anmeldung.
Beispiele
Grundlegende föderierte Anmeldung
Relying Parties (RPs) können navigator.credentials.get() mit der Option identity aufrufen, um Benutzer zur Anmeldung bei der RP über einen Identitätsanbieter (IdP) mittels Identitätsföderation aufzufordern. Eine typische Anfrage sieht so 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 liefert dieser Aufruf eine IdentityCredential-Instanz. Daraus können Sie beispielsweise den Wert von IdentityCredential.token zurückgeben:
console.log(identityCredential.token);
Weitere Informationen zur Funktionsweise finden Sie unter Federated Credential Management API (FedCM). Dieser Aufruf startet den unter FedCM-Anmeldeablauf beschriebenen Anmeldevorgang.
Spezifikationen
| Spezifikation |
|---|
| Federated Credential Management API # browser-api-identity-credential-interface |