IdentityCredential: token-Eigenschaft

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more support for this feature? Tell us why.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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 sollte: 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 geben, wie der zurückgegebene token-Wert interpretiert und verwendet werden soll.

Relying Parties (RPs) können navigator.credentials.get() mit der Option identity aufrufen, um eine Anfrage zu stellen, damit Benutzer sich über einen Identitätsanbieter (IdP) beim RP anmelden können, indem Identity Federation genutzt wird. Eine typische Anfrage würde folgendermaßen aussehen:

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 beinhaltet, wird mit einer IdentityCredential-Instanz erfüllt, die verwendet werden kann, um auf das token zuzugreifen, das zur Validierung der Anmeldung genutzt wurde.

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