Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

IdentityProvider

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.

Das IdentityProvider-Interface der Federated Credential Management (FedCM) API repräsentiert einen IdP und bietet Zugriff auf verwandte Informationen und Funktionalitäten.

Statische Methoden

close() Experimentell

Bietet ein manuelles Signal an den Browser, dass ein IdP-Anmeldefluss abgeschlossen ist. Dies ist beispielsweise notwendig, um das IdP-Anmeldedialogfenster zu schließen, wenn die Anmeldung vollständig abgeschlossen ist und der IdP das Sammeln von Daten vom Benutzer beendet hat.

getUserInfo() Experimentell

Gibt Informationen über einen zuvor angemeldeten Benutzer bei seiner Rückkehr zu einem IdP zurück, die genutzt werden können, um eine personalisierte Willkommensnachricht und Anmeldeschaltfläche bereitzustellen.

Beispiele

Grundlegende Nutzung von IdentityProvider.getUserInfo()

Das folgende Beispiel zeigt, wie die Methode getUserInfo() verwendet werden kann, um Informationen über einen zuvor angemeldeten Benutzer von einem spezifischen IdP zurückzugeben.

js
// Iframe displaying a page from the https://idp.example origin
const userInfo = await IdentityProvider.getUserInfo({
  configURL: "https://idp.example/fedcm.json",
  clientId: "client1234",
});

// IdentityProvider.getUserInfo() returns an array of user information.
if (userInfo.length > 0) {
  // Returning accounts should be first, so the first account received
  // is guaranteed to be a returning account
  const name = userInfo[0].name;
  const givenName = userInfo[0].given_name;
  const displayName = givenName || name;
  const picture = userInfo[0].picture;
  const email = userInfo[0].email;

  // …

  // Render a personalized sign-in button using the information returned above
}

Spezifikationen

Specification
Federated Credential Management API
# browser-api-identity-provider-interface

Browser-Kompatibilität

Siehe auch