IdentityCredential: isAutoSelected-Eigenschaft
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die schreibgeschützte Eigenschaft isAutoSelected des IdentityCredential-Interfaces zeigt an, ob der föderierte Anmeldevorgang mithilfe der automatischen Re-Authentifizierung (d.h. ohne Benutzerinteraktion) durchgeführt wurde oder nicht.
Automatische Re-Authentifizierung kann auftreten, wenn ein Aufruf von navigator.credentials.get() mit einer mediation-Option von Wert "optional" oder "silent" ausgeführt wird. Es ist für einen vertrauenden Anbieter (RP) nützlich zu wissen, ob eine automatische Re-Authentifizierung stattgefunden hat, sowohl für Analyse-/Leistungsbewertungen als auch für UX-Zwecke — eine automatische Anmeldung kann einen anderen Benutzerfluss rechtfertigen als eine nicht-automatische Anmeldung.
Wert
Ein Boolean-Wert. true zeigt an, dass die automatische Re-Authentifizierung verwendet wurde; false zeigt an, dass sie nicht verwendet wurde.
Beispiele
Vertrauenswürdige Anbieter (RPs) können navigator.credentials.get() mit der Option identity aufrufen, um Benutzer dazu aufzufordern, sich über einen Identitätsanbieter (IdP) bei dem RP mittels Identitätsföderation anzumelden. Das Verhalten der automatischen Re-Authentifizierung wird durch die mediation-Option im get()-Aufruf gesteuert:
async function signIn() {
const identityCredential = await navigator.credentials.get({
identity: {
providers: [
{
configURL: "https://accounts.idp.example/config.json",
clientId: "********",
},
],
},
mediation: "optional", // this is the default
});
// isAutoSelected is true if auto-reauthentication occurred.
const isAutoSelected = identityCredential.isAutoSelected;
}
Weitere Details dazu, wie dies funktioniert, finden Sie im Federated Credential Management API (FedCM). Dieser Aufruf startet den Anmeldefluss, der im FedCM-Anmeldefluss beschrieben wird.
Spezifikationen
| Specification |
|---|
| Federated Credential Management API # dom-identitycredential-isautoselected |