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, bevor Sie diese produktiv verwenden.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

Die schreibgeschützte isAutoSelected Eigenschaft des IdentityCredential-Interfaces zeigt an, ob der föderierte Anmeldevorgang unter Verwendung der automatischen Reauthentifizierung (d.h. ohne Benutzereingriff) durchgeführt wurde oder nicht.

Eine automatische Reauthentifizierung kann erfolgen, wenn ein Aufruf von navigator.credentials.get() mit einem mediation-Optionswert von "optional" oder "silent" ausgeführt wird. Es ist nützlich für einen vertrauenden Dritten (RP) zu wissen, ob eine automatische Reauthentifizierung erfolgt ist, um Analysen/Leistungsbewertungen durchzuführen und für UX-Zwecke — eine automatische Anmeldung könnte einen anderen UI-Fluss als eine nicht-automatische Anmeldung erfordern.

Wert

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

Beispiele

RPs können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, dass sich Benutzer über einen Identitätsanbieter (IdP) mithilfe der Identitätsföderation beim RP anmelden. Das Verhalten der automatischen Reauthentifizierung wird durch die mediation-Option im get()-Aufruf 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;
}

Sehen 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-Anmeldefluss beschrieben ist.

Spezifikationen

No specification found

No specification data found for api.IdentityCredential.isAutoSelected.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch