FedCM-Updates in Chrome 143

Veröffentlicht: 12. Januar 2026

In Chrome 143 werden Updates für die Federated Credential Management (FedCM) API eingeführt, um den Datenschutz, die Entwicklerumgebung und die Browserinteroperabilität zu verbessern. Diese Änderungen basieren auf Feedback von Identitätsanbietern (IdPs), vertrauenden Seiten (RPs) und der Web-Community.

Das sind die wichtigsten Neuerungen:

Unterstützung strukturierter JSON-Antworten vom ID-Bestätigungsendpunkt

Bisher musste das Attribut token in der Antwort des FedCM-ID-Assertion-Endpunkts ein String sein. Das zwang Entwickler dazu, Daten auf dem Server manuell in einen JSON-String zu serialisieren und auf dem Client zu parsen.

Ab Chrome 143 unterstützt der ID-Assertion-Endpunkt ein strukturiertes JSON-Objekt als Wert für das Attribut token, zum Beispiel:

{
  "token": {
    "access_token": "a1b2c3d4e5f6...",
    "user_info": {
      "email": "jane.doe@company.example",
      "given_name": "Jane",
      "family_name": "Doe"
    }
  }
}

Durch diese Änderung entfällt die Notwendigkeit der manuellen JSON-Serialisierung und des Parsings. Außerdem können IdPs zusätzliche Informationen zurückgeben.

Sie können diese Funktion in der FedCM-Demo ausprobieren oder im Leitfaden FedCM auf der Seite des Identitätsanbieters implementieren nachlesen, wie die aktualisierte Antwort des ID-Assertion-Endpunkts strukturiert ist.

Client-Metadaten validieren

Zum besseren Schutz des Datenschutzes von Nutzern wird die Validierung für IdP-Endpunkte mit FedCM verstärkt. Diese Änderung verhindert, dass ein IdP eine vertrauende Seite einer eindeutigen ID zuordnet, die als Pfadparameter übergeben wird.

Wenn in Ihrer FedCM-Konfiguration der client_metadata-Endpunkt verwendet wird, müssen Sie accounts_endpoint und login_url in Ihre .well-known/web-identity-Datei aufnehmen. Ab Chrome 145 erzwingt der Browser den Parameter accounts_endpoint in der well-known-Datei.

{
  "accounts_endpoint": "/example-accounts",
  "login_url": "/example-login"
}

Weitere Informationen finden Sie im Implementierungsleitfaden für FedCM.

Aktualisierungen der API-Konsistenz und Fehlerbehandlung

In Chrome 143 werden zwei Änderungen eingeführt, um die Klarheit und Konsistenz der FedCM API in verschiedenen Browsern zu verbessern. Dies entspricht dem Feedback aus dem Web-Ökosystem.

Parameter nonce verschieben

Ab Version 145 wird der Parameter nonce auf oberster Ebene in Chrome nicht mehr unterstützt. Sie müssen den Parameter nonce im Objekt „params“ im Aufruf navigator.credentials.get() übergeben:

const credential = await navigator.credentials.get({
  identity: {
    providers: [{
      // Don't pass nonce as a top-level parameter here
      configURL: "/fedcm.json",
      clientId: "123",
      params: {
     // Place nonce within the params object    
        nonce: "a-random-nonce"
      }
    }]
  }
});

Achten Sie darauf, dass Ihre serverseitige Logik den nonce im params-Objekt im ID-Assertion-Endpunkt erwartet.

IdentityCredentialError.code in IdentityCredentialError.error umbenennen

Um Namenskonflikte mit dem integrierten Attribut DOMException.code zu vermeiden, wurde IdentityCredentialError.code in IdentityCredentialError.error umbenannt. Diese Änderung wird ab Chrome 145 erzwungen.

try {
  // FedCM API call
} catch (e) {
   // Renamed IdentityCredentialError.code to IdentityCredentialError.error:    
   console.log(e.error);
}

Um die Abwärtskompatibilität während der Übergangsphase (Chrome 143 und 144) zu gewährleisten, sollten Sie in Ihrer Fehlerbehandlungslogik sowohl die Attribute code als auch error prüfen. So funktioniert Ihre Lösung auch in älteren Browsern, während Nutzer auf neuere Chrome-Versionen aktualisieren:

 // In older browsers, the property might still be named 'code'
 // during the transition period
  const errorCode = e.error ?? e.code;
  if (errorCode) {
    // Handle specific error types
  } else {
    console.error("An unknown error occurred", e);
  }

Weitere Informationen finden Sie im Abschnitt Fehlerantwort zurückgeben der FedCM-Dokumentation.

Feedback geben

Wir freuen uns über Ihr Feedback, während wir FedCM weiterentwickeln und verbessern. Wenn Sie Feedback geben möchten oder Probleme auftreten:

Weitere Informationen