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

Weitere Informationen finden Sie unter Bereitstellen einer Konfigurationsdatei.

Wert

Ein String.

Beispiele

Grundlegende föderierte Anmeldung und Zugriff auf `configURL`

Vertrauende Parteien (RPs) können navigator.credentials.get() mit der Option identity aufrufen, um eine Anfrage zu stellen, damit sich Benutzer über einen Identity Provider (IdP) beim RP anmelden, unter Verwendung der Identitätsföderation. Eine Anfrage, die einen einzelnen Anbieter angibt, würde so 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.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 für die Anmeldung verwendeten IdP zuzugreifen.

Weitere Einzelheiten darüber, wie dies funktioniert, finden Sie in der Federated Credential Management API (FedCM). Dieser Aufruf wird den Anmeldeablauf starten, der im FedCM-Anmeldeablauf beschrieben wird.