IdentityProvider

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

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 Identitätsanbieter (IdP) und bietet Zugriff auf verwandte Informationen und Funktionen.

Statische Methoden

close()

Bietet ein manuelles Signal an den Browser, dass ein Anmeldefluss eines IdPs abgeschlossen ist. Dies ist erforderlich, um beispielsweise den Anmeldedialog des IdP zu schließen, wenn die Anmeldung vollständig abgeschlossen ist und der IdP die Datenerfassung vom Nutzer beendet hat.

getUserInfo()

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

Beispiele

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

// IdentityProvider.getUserInfo() returns an array of user information.
if (user_info.length > 0) {
  // Returning accounts should be first, so the first account received
  // is guaranteed to be a returning account
  const name = user_info[0].name;
  const given_name = user_info[0].given_name;
  const display_name = given_name ? given_name : name;
  const picture = user_info[0].picture;
  const email = user_info[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

BCD tables only load in the browser

Siehe auch