IdentityCredential
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more 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 ein Benutzeridentitätsnachweis, der aus einem erfolgreichen föderierten Anmeldevorgang hervorgeht.
Ein erfolgreicher Aufruf von navigator.credentials.get(), der eine identity-Option beinhaltet, wird mit einer Instanz von IdentityCredential erfüllt.
Instanz-Eigenschaften
Erbt Eigenschaften von ihrem Vorfahren, Credential.
IdentityCredential.configURLSchreibgeschützt-
Ein String, der die URL der Konfigurationsdatei des verwendeten IdP zur Anmeldung angibt.
IdentityCredential.isAutoSelectedSchreibgeschützt-
Ein Boolescher Wert, der angibt, ob die föderierte Anmeldung mithilfe von Auto-Reauthentifizierung (d.h. ohne Benutzerintervention) durchgeführt wurde oder nicht.
IdentityCredential.token-
Gibt das Token zurück, das zur Validierung der zugehörigen Anmeldung verwendet wurde.
Statische Methoden
IdentityCredential.disconnect()-
Trennt das föderierte Anmeldekonto, das verwendet wurde, um das Anmeldeinformation zu erhalten.
Beispiele
Grundlegende föderierte Anmeldung
Vertrauensparteien (RPs) können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, damit sich Benutzer über einen Identitätsanbieter (IdP) bei der RP anmelden können, unter Verwendung von Identitätsföderation. Eine typische Anfrage könnte folgendermaßen aussehen:
async function signIn() {
const identityCredential = await navigator.credentials.get({
identity: {
providers: [
{
configURL: "https://accounts.idp.example/config.json",
clientId: "********",
params: {/* IdP-specific parameters */},
},
],
},
});
}
Wenn erfolgreich, wird dieser Aufruf mit einer Instanz von IdentityCredential erfüllt. Daraus könnten Sie beispielsweise den IdentityCredential.token-Wert zurückgeben:
console.log(identityCredential.token);
Schauen Sie sich die Federated Credential Management API (FedCM) für weitere Details an, wie dies funktioniert. Dieser Aufruf wird den Anmeldefluss starten, der im FedCM-Anmeldefluss beschrieben wird.
Spezifikationen
| Spezifikation |
|---|
| Federated Credential Management API # browser-api-identity-credential-interface |