Aktualizacje FedCM w Chrome 143

Data publikacji: 12 stycznia 2026 r.

W Chrome 143 wprowadziliśmy aktualizacje interfejsu Federated Credential Management (FedCM) API, które zwiększają prywatność, ułatwiają pracę deweloperom i poprawiają interoperacyjność przeglądarki. Te zmiany są oparte na opiniach dostawców tożsamości, stron zależnych i społeczności internetowej.

Najważniejsze zmiany:

Obsługa uporządkowanych odpowiedzi JSON z punktu końcowego asercji tożsamości

Wcześniej punkt końcowy asercji identyfikatora FedCM wymagał, aby właściwość token w odpowiedzi była ciągiem znaków. Zmuszało to deweloperów do ręcznego serializowania danych do ciągu znaków JSON na serwerze i analizowania ich na kliencie.

Od wersji Chrome 143 punkt końcowy asercji tożsamości obsługuje uporządkowany obiekt JSON jako wartość właściwości token, na przykład:

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

Dzięki tej zmianie nie trzeba już ręcznie serializować i analizować danych JSON, a dostawcy tożsamości mogą zwracać dodatkowe informacje.

Wypróbuj tę funkcję w wersji demonstracyjnej FedCM lub zapoznaj się z przewodnikiem Implementowanie FedCM po stronie dostawcy tożsamości, aby uzyskać aktualne informacje o strukturze odpowiedzi zaktualizowanego punktu końcowego asercji tożsamości.

Weryfikowanie metadanych klienta

Aby lepiej chronić prywatność użytkowników, FedCM wzmacnia weryfikację punktów końcowych dostawcy tożsamości. Ta zmiana uniemożliwia dostawcy tożsamości dopasowanie dostawcy usługi do unikalnego identyfikatora przekazanego jako parametr ścieżki.

Jeśli konfiguracja FedCM używa punktu końcowego client_metadata, musisz uwzględnić accounts_endpoint i login_url w pliku .well-known/web-identity. Od wersji Chrome 145 przeglądarka wymusza parametr accounts_endpoint w pliku well-known.

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

Więcej informacji znajdziesz w przewodniku po implementacji FedCM.

Aktualizacje dotyczące spójności interfejsu API i obsługi błędów

Chrome 143 wprowadza 2 zmiany, które poprawiają przejrzystość i spójność interfejsu FedCM API w różnych przeglądarkach, zgodnie z opiniami dotyczącymi ekosystemu internetowego.

Przenieś parametr nonce

Od wersji 145 Chrome przestaje obsługiwać parametr nonce najwyższego poziomu. Musisz przekazać parametr nonce w obiekcie params w wywołaniu navigator.credentials.get():

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"
      }
    }]
  }
});

Upewnij się, że logika po stronie serwera oczekuje parametru nonce w obiekcie params w punkcie końcowym asercji tożsamości.

Zmień nazwę IdentityCredentialError.code na IdentityCredentialError.error

Aby uniknąć konfliktów nazw z wbudowaną właściwością DOMException.code, nazwa IdentityCredentialError.code została zmieniona na IdentityCredentialError.error. Ta zmiana zacznie obowiązywać od Chrome 145.

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

Aby zapewnić zgodność wsteczną w okresie przejściowym (Chrome 143 i 144), sprawdź właściwości code i error w logice obsługi błędów. Dzięki temu Twoje rozwiązanie będzie działać w starszych przeglądarkach, gdy użytkownicy będą aktualizować Chrome do nowszych wersji:

 // 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);
  }

Więcej informacji znajdziesz w sekcji Zwracanie odpowiedzi o błędzie w dokumentacji FedCM.

Prześlij opinię

Twoja opinia jest dla nas bardzo ważna i pomaga nam rozwijać i ulepszać FedCM. Jeśli masz uwagi lub napotkasz problemy:

Więcej informacji