公開日: 2026 年 1 月 12 日
Chrome 143 では、Federated Credentials Management(FedCM)API が更新され、プライバシー、デベロッパー エクスペリエンス、ブラウザの相互運用性が向上しています。これらの変更は、ID プロバイダ(IdP)、証明書利用者(RP)、ウェブ コミュニティからのフィードバックに基づいています。
主な更新内容は次のとおりです。
ID アサーション エンドポイントからの構造化 JSON レスポンスをサポート
以前は、FedCM の ID アサーション エンドポイントでは、レスポンスの token プロパティが文字列である必要がありました。このため、デベロッパーはサーバー上でデータを JSON 文字列に手動でシリアル化し、クライアント上で解析する必要がありました。
Chrome 143 以降、ID アサーション エンドポイントは、token プロパティの値として構造化 JSON オブジェクトをサポートしています。次に例を示します。
{
"token": {
"access_token": "a1b2c3d4e5f6...",
"user_info": {
"email": "jane.doe@company.example",
"given_name": "Jane",
"family_name": "Doe"
}
}
}
この変更により、手動での JSON のシリアル化と解析が不要になり、IdP が追加情報を返すことができるようになります。
この機能は FedCM デモでお試しいただけます。また、更新された ID アサーション エンドポイント レスポンスの構造に関する最新情報については、ID プロバイダ側で FedCM を実装するのガイドをご覧ください。
クライアント メタデータを検証する
ユーザーのプライバシーをより適切に保護するため、FedCM は IdP エンドポイントの検証を強化しています。この変更により、IdP が RP をパスパラメータとして渡された一意の ID と照合することを防止します。
FedCM 構成で client_metadata エンドポイントを使用している場合は、.well-known/web-identity ファイルに accounts_endpoint と login_url を含める必要があります。Chrome 145 以降、ブラウザは既知のファイルの accounts_endpoint パラメータを適用します。
{
"accounts_endpoint": "/example-accounts",
"login_url": "/example-login"
}
詳しくは、FedCM 実装ガイドをご覧ください。
API の整合性とエラー処理の更新
Chrome 143 では、ウェブ エコシステムからのフィードバックに沿って、ブラウザ間での FedCM API の明確さと一貫性を向上させるために 2 つの変更が導入されています。
nonce パラメータを再配置する
バージョン 145 以降、Chrome では最上位の nonce パラメータのサポートが終了します。navigator.credentials.get() 呼び出しの params オブジェクト内で nonce パラメータを渡す必要があります。
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"
}
}]
}
});
サーバーサイドのロジックが、ID アサーション エンドポイントの params オブジェクト内の nonce を想定していることを確認します。
IdentityCredentialError.code を IdentityCredentialError.error に変更
組み込みの DOMException.code プロパティとの名前の競合を回避するため、IdentityCredentialError.code の名前を IdentityCredentialError.error に変更しました。この変更は Chrome 145 から適用されます。
try {
// FedCM API call
} catch (e) {
// Renamed IdentityCredentialError.code to IdentityCredentialError.error:
console.log(e.error);
}
移行期間(Chrome 143 と 144)中に下位互換性を確保するには、エラー処理ロジックで code プロパティと error プロパティの両方を確認します。これにより、ユーザーが新しいバージョンの 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);
}
詳しくは、FedCM ドキュメントのエラー レスポンスを返すセクションをご覧ください。
フィードバックをお寄せください
FedCM の開発と改善を継続するにあたり、皆様からのご意見をお待ちしております。フィードバックがある場合や問題が発生した場合は、
- GitHub リポジトリで問題を報告する。
- デベロッパー ニュースレターのメーリング リストに登録して、最新のお知らせを入手してください。