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 der IdentityCredential-Schnittstelle gibt an, ob der föderierte Anmeldevorgang unter Verwendung der automatischen Neuauthentifizierung (d.h. ohne Benutzereinwirkung) durchgeführt wurde oder nicht.

Eine automatische Neuauthentifizierung kann auftreten, wenn ein Aufruf von navigator.credentials.get() mit einer mediation-Optionswert von "optional" oder "silent" ausgeführt wird. Es ist für eine vertrauende Partei (RP) nützlich zu wissen, ob eine automatische Neuauthentifizierung für Analysen/Leistungsbewertung und für UX-Zwecke stattfand — eine automatische Anmeldung kann einen anderen UI-Fluss rechtfertigen als eine nicht-automatische Anmeldung.

Wert

Ein boolescher Wert. true gibt an, dass die automatische Neuauthentifizierung verwendet wurde; false gibt an, dass sie nicht verwendet wurde.

Beispiele

Vertrauende Parteien (RPs) können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, dass sich Benutzer über einen Identitätsanbieter (IdP), unter Verwendung der Identitätsföderation, beim RP anmelden. Das Verhalten der automatischen Neuauthentifizierung wird durch die mediation-Option im Aufruf von get() gesteuert:

js
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;
}

Schauen Sie sich das Federated Credential Management API (FedCM) für weitere Details an, wie dies funktioniert. Dieser Aufruf wird den Anmeldevorgang starten, der im FedCM-Anmeldeprozess beschrieben wird.

Spezifikationen

Specification
Federated Credential Management API
# dom-identitycredential-isautoselected

Browser-Kompatibilität

Siehe auch