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 Identitätsanbieters (IdP) angibt, der für die Anmeldung verwendet wird.

Weitere Informationen finden Sie unter Bereitstellung einer Konfigurationsdatei.

Wert

Ein String.

Beispiele

Grundlegende föderierte Anmeldung und Zugriff auf `configURL`

Relying Parties (RPs) können navigator.credentials.get() mit der Option identity aufrufen, um eine Anfrage zu stellen, damit sich Benutzer über einen Identitätsanbieter (IdP) mithilfe von Identitätsföderation beim RP anmelden. Eine Anfrage, die einen einzigen 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: "********",
          nonce: "******",
        },
      ],
    },
  });

  console.log(identityCredential.configURL);
}

Ein erfolgreicher Aufruf von navigator.credentials.get(), der eine identity-Option beinhaltet, wird mit einer IdentityCredential-Instanz erfüllt, die verwendet werden kann, um die configURL des IdP zuzugreifen, der für die Anmeldung verwendet wurde.

Weitere Details, wie dies funktioniert, finden Sie im API zur Verwaltung föderierter Anmeldeinformationen (FedCM). Dieser Aufruf wird den Anmeldeprozess einleiten, der im FedCM-Anmeldeablauf beschrieben wird.