IdentityCredential: token-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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 schreibgeschützte token-Eigenschaft des IdentityCredential-Interfaces gibt das Token zurück, das zur Validierung der zugehörigen Anmeldung verwendet wird.

Die FedCM-API definiert nicht die Struktur des token-Objekts oder was der RP damit tun soll: Dies hängt vollständig vom föderierten Identitätsprotokoll ab, das der IdP implementiert.

Wenn ein RP sich entscheidet, mit einem bestimmten IdP zu arbeiten, wird dieser Anweisungen bereitstellen, wie der zurückgegebene token-Wert interpretiert und verwendet werden soll.

Reliance Parties (RPs) können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, dass sich Benutzer über einen Identitätsanbieter (IdP) bei der RP anmelden, und dabei Identitätsföderation verwenden. Eine typische Anfrage sieht folgendermaßen aus:

async function signIn() {
  const identityCredential = await navigator.credentials.get({
    identity: {
      providers: [
        {
          configURL: "https://accounts.idp.example/config.json",
          clientId: "********",
          params: {
            /* IdP-specific parameters */
          },
        },
      ],
    },
  });

  console.log(identityCredential.token);
}

Ein erfolgreicher Aufruf von navigator.credentials.get(), der eine identity-Option enthält, wird mit einer IdentityCredential-Instanz erfüllt, die verwendet werden kann, um auf das token zuzugreifen, das zur Validierung der Anmeldung verwendet wird.

Sehen Sie sich Federated Credential Management API (FedCM) an, um weitere Details zu erhalten, wie dies funktioniert. Dieser Aufruf wird den Anmeldeablauf starten, der in FedCM-Anmeldeablauf beschrieben ist.