Data di pubblicazione: 12 gennaio 2026
Chrome 143 introduce aggiornamenti all'API Federated Credential Management (FedCM) per migliorare la privacy, l'esperienza degli sviluppatori e l'interoperabilità del browser. Queste modifiche si basano sul feedback dei provider di identità (IdP), delle relying party (RP) e della community web.
Gli aggiornamenti principali sono:
- Supporto per risposte JSON strutturate
- Convalida più rigorosa dei metadati del client
- Miglioramenti della coerenza delle API
Supportare risposte JSON strutturate dall'endpoint di asserzione dell'ID
In precedenza, l'endpoint di asserzione ID di FedCM richiedeva che la proprietà token nella risposta fosse una stringa. Ciò costringeva gli sviluppatori a serializzare manualmente i dati in una stringa JSON sul server e ad analizzarli sul client.
A partire da Chrome 143, l'endpoint di asserzione ID supporta un oggetto JSON strutturato come valore della proprietà token, ad esempio:
{
"token": {
"access_token": "a1b2c3d4e5f6...",
"user_info": {
"email": "jane.doe@company.example",
"given_name": "Jane",
"family_name": "Doe"
}
}
}
Questa modifica elimina la necessità di serializzazione e analisi JSON manuali e consente agli IdP di restituire informazioni aggiuntive.
Prova questa funzionalità con la demo di FedCM o consulta la guida Implementa FedCM sul lato del provider di identità per informazioni aggiornate su come è strutturata la risposta dell'endpoint di asserzione ID aggiornato.
Convalida i metadati del client
Per proteggere meglio la privacy degli utenti, FedCM sta rafforzando la convalida degli endpoint IdP. Questa modifica impedisce a un IdP di abbinare un RP a un ID univoco passato come parametro di percorso.
Se la configurazione di FedCM utilizza l'endpoint client_metadata, devi includere accounts_endpoint e login_url nel file .well-known/web-identity. A partire da Chrome 145, il browser applica il parametro accounts_endpoint nel file well-known.
{
"accounts_endpoint": "/example-accounts",
"login_url": "/example-login"
}
Per maggiori dettagli, consulta la guida all'implementazione di FedCM.
Aggiornamenti relativi alla coerenza dell'API e alla gestione degli errori
Chrome 143 introduce due modifiche per migliorare la chiarezza e la coerenza dell'API FedCM tra i browser, in linea con il feedback dell'ecosistema web.
Sposta il parametro nonce
A partire dalla versione 145, Chrome non supporta più il parametro nonce di primo livello. Devi passare il parametro nonce all'interno dell'oggetto params nella chiamata 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"
}
}]
}
});
Assicurati che la logica lato server preveda nonce all'interno dell'oggetto params nell'endpoint di asserzione ID.
Rinomina IdentityCredentialError.code in IdentityCredentialError.error
Per evitare conflitti di denominazione con la proprietà DOMException.code integrata,
IdentityCredentialError.code è stata rinominata in IdentityCredentialError.error.
Questa modifica verrà applicata a partire da Chrome 145.
try {
// FedCM API call
} catch (e) {
// Renamed IdentityCredentialError.code to IdentityCredentialError.error:
console.log(e.error);
}
Per garantire la compatibilità con le versioni precedenti durante il periodo di transizione (Chrome 143 e 144), controlla le proprietà code e error nella logica di gestione degli errori.
In questo modo, la tua soluzione funzionerà nei browser meno recenti mentre gli utenti eseguono l'aggiornamento alle versioni più recenti di Chrome:
// 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);
}
Scopri di più nella sezione Restituisci una risposta di errore della documentazione di FedCM.
Condividi il tuo feedback
Il tuo feedback è importante per noi e ci aiuta a sviluppare e migliorare continuamente FedCM. Se hai feedback o riscontri problemi:
- Segnala un problema nel nostro repository GitHub.
- Iscriviti alla nostra mailing list per la newsletter per gli sviluppatori per non perderti gli ultimi annunci.