IdentityCredential: configURL-Eigenschaft

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 configURL-Eigenschaft der IdentityCredential-Schnittstelle ist eine schreibgeschützte Eigenschaft, die eine Zeichenkette zurückgibt, die die URL der Konfigurationsdatei des Identity Providers (IdP) angibt, der für die Anmeldung verwendet wird.

Weitere Informationen finden Sie unter Konfigurationsdatei bereitstellen.

Wert

Eine Zeichenkette.

Beispiele

Grundlagen der föderierten Anmeldung und Zugriff auf die `configURL`

Vertrauenswürdige Parteien (RP) können navigator.credentials.get() mit der identity-Option aufrufen, um eine Anfrage zu stellen, damit sich Benutzer über einen Identity Provider (IdP) bei der RP anmelden können, indem sie die Identitätsföderation nutzen. Eine Anfrage, die einen einzigen Anbieter angibt, würde folgendermaßen aussehen:

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

  console.log(identityCredential.configURL);
}

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 die configURL des IdP zuzugreifen, der für die Anmeldung verwendet wurde.

Weitere Details, wie dies funktioniert, finden Sie in der Federated Credential Management API (FedCM). Dieser Aufruf wird den Anmeldeablauf auslösen, der im FedCM-Anmeldeablauf beschrieben wird.