Aggiornamenti di FedCM in Chrome 143

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:

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:

Scopri di più