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 isAutoSelected-Eigenschaft des IdentityCredential-Interfaces gibt an, ob der föderierte Anmeldevorgang unter Verwendung der automatischen Reauthentifizierung (d.h. ohne Benutzermediation) durchgeführt wurde oder nicht.

Eine automatische Reauthentifizierung kann auftreten, wenn ein Aufruf von navigator.credentials.get() mit einem Wert der mediation-Option von "optional" oder "silent" ausgeführt wird. Es ist nützlich für eine verantwortliche Partei (RP) zu wissen, ob eine automatische Reauthentifizierung für Analysen/Leistungsbewertungen und für UX-Zwecke stattgefunden hat — eine automatische Anmeldung kann einen anderen UI-Ablauf als eine nicht-automatische Anmeldung rechtfertigen.

Wert

Ein boolescher Wert. true zeigt an, dass eine automatische Reauthentifizierung verwendet wurde; false zeigt an, dass dies nicht der Fall war.

Beispiele

Grundlegende föderierte Anmeldung und Zugriff auf `isAutoSelected`

RPs können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, damit sich Benutzer über eine IdP bei der RP anmelden können, indem sie die Identitätsföderation verwenden. Das Verhalten der automatischen Reauthentifizierung 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;
}

Ein erfolgreicher navigator.credentials.get()-Aufruf, der eine identity-Option enthält, erfüllt sich mit einer IdentityCredential-Instanz, die verwendet werden kann, um auf die isAutoSelected-Eigenschaft zuzugreifen: Diese ist gleich true, wenn eine automatische Reauthentifizierung stattgefunden hat.

Sehen Sie sich die Federated Credential Management API (FedCM) für weitere Details an, wie dies funktioniert. Dieser Aufruf startet den Anmeldeprozess, der im FedCM-Anmeldeablauf beschrieben wird.