パスキーは特定のウェブサイトに関連付けられており、作成されたウェブサイトへのログインにのみ使用できます。
これはリライング パーティ ID(RP ID)で指定されます。example.com ドメイン用に作成されたパスキーの場合、RP ID は www.example.com または example.com になります。
RP ID は、パスキーがどこでも認証に使用できる単一の認証情報として使用されるのを防ぎますが、次のような問題が発生します。
- 複数のドメインを持つサイト: ユーザーは、同じ会社が管理する異なる国固有のドメイン(
example.com、example.co.ukなど)に同じパスキーを使用してログインすることはできません。 - ブランド ドメイン: ユーザーは、1 つのブランドで使用されている異なるドメイン(
acme.comやacmerewards.comなど)で同じ認証情報を使用することはできません。 - モバイルアプリ: モバイルアプリには独自のドメインがないことが多く、認証情報の管理が困難です。
ID 連携に基づく回避策や、iframe に基づく回避策もありますが、場合によっては不便なこともあります。関連オリジン リクエストは、この問題の解決策となります。
解決策
関連オリジン リクエストを使用すると、ウェブサイトは RP ID の使用を許可するオリジンを指定できます。
これにより、ユーザーは、運営する複数のサイトで同じパスキーを再利用できます。
関連するオリジン リクエストを使用するには、特定の URL https://{RP ID}/.well-known/webauthn で特別な JSON ファイルを提供する必要があります。example.com が追加のオリジンに RP ID としての使用を許可する場合は、https://example.com/.well-known/webauthn: で次のファイルを提供する必要があります。
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
これらのサイトのいずれかが、example.com を RP ID として使用するパスキーの作成(navigator.credentials.create)または認証(navigator.credentials.get)を呼び出すと、ブラウザはリクエスト元のオリジンと一致しない RP ID を検出します。ブラウザが関連オリジン リクエストをサポートしている場合、まず https://{RP ID}/.well-known/webauthn で webauthn ファイルを探します。ファイルが存在する場合、ブラウザはリクエスト元のオリジンが allowlist にあるかどうかを確認します。「はい」の場合、パスキーの作成または認証の手順に進みます。
ブラウザが関連オリジン リクエストをサポートしていない場合、SecurityError がスローされます。
ブラウザ サポート
関連オリジン リクエストは、Chrome と Safari でサポートされています。2026 年 1 月現在、Firefox はこの機能の導入を検討中です。ステータスは、Mozilla の標準ポジションの問題で確認できます。
関連するオリジン リクエストを設定する
次のデモでは、https://ror-1.glitch.me と https://ror-2.glitch.me の 2 つのサイトを使用します。ユーザーが両方のサイトで同じパスキーを使用してログインできるように、関連オリジン リクエストを使用して、ror-2.glitch.me が ror-1.glitch.me を RP ID として使用できるようにします。
デモ
https://ror-2.glitch.me は、ror-1.glitch.me を RP ID として使用する関連オリジン リクエストを実装しているため、ror-1 と ror-2 の両方が、パスキーの作成時またはパスキーによる認証時に ror-1.glitch.me を RP ID として使用します。また、これらのサイト間で共有されるパスキー データベースも実装しました。
ユーザー エクスペリエンスは次のようになります。
ror-2でパスキーを正常に作成し、認証できます。RP ID はror-1(ror-2ではない)です。ror-1またはror-2のいずれかでパスキーを作成すると、ror-1とror-2の両方でそのパスキーを使用して認証できます。ror-2は RP ID としてror-1を指定しているため、これらのサイトのいずれかからパスキーの作成または認証リクエストを行うことは、ror-1 でリクエストを行うことと同じです。RP ID は、リクエストをオリジンに関連付ける唯一のものです。ror-1またはror-2でパスキーを作成すると、ror-1とror-2の両方で Chrome による自動入力が可能になります。- これらのサイトのいずれかで作成された認証情報の RP ID は
ror-1になります。
コードを見る:
- ror-1 コードベースで設定された
/.well-known/webauthnファイルを確認します。 - ror-2 コードベースで
RP_ID_RORの出現箇所を確認します。
ステップ 1: 共有アカウント データベースを実装する
ユーザーが site-1 と site-2 で同じパスキーを使用してログインできるようにするには、これら 2 つのサイトで共有されるアカウント データベースを実装します。
ステップ 2: site-1 で .well-known/webauthn JSON ファイルを設定する
まず、site-2.com が RP ID として使用できるように site-1.com を構成します。これを行うには、webauthn JSON ファイルを作成します。
{
"origins": [
"https://site-2.com"
]
}
JSON オブジェクトには、origins という名前のキーが含まれている必要があります。このキーの値は、ウェブにおけるオリジンを含む 1 つ以上の文字列の配列です。
重要な制限事項: ラベルは最大 5 個
このリストの各要素が処理され、eTLD + 1 ラベルが抽出されます。たとえば、example.co.uk と example.de の eTLD+1 ラベルはどちらも example です。ただし、example-rewards.com の eTLD+1 ラベルは example-rewards です。Chrome では、ラベルの最大数は 5 です。
ステップ 3: site-1 で .well-known/webauthn JSON を提供する
次に、site-1.com/.well-known/webauthn で JSON ファイルを提供します。
たとえば、express では次のようになります。
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
ここでは、正しい content-type('application/json')がすでに設定されている express res.json を使用しています。
ステップ 4: site-2 で RP ID を指定する
site-2 コードベースで、必要なすべての場所で site-1.com を RP ID として設定します。
- 認証情報の作成時:
navigator.credentials.createフロントエンド呼び出しに渡される認証情報作成optionsで、site-1.comを RP ID として設定します。通常、これはサーバーサイドで生成されます。- データベースに保存する前に認証情報の検証を実行するため、
site-1.comを想定される RP ID として設定します。
- 認証後:
navigator.credentials.getフロントエンド呼び出しに渡され、通常はサーバーサイドで生成される認証optionsで、site-1.comを RP ID として設定します。- ユーザーを認証する前に認証情報の検証を行うため、サーバーで検証される想定の RP ID として
site-1.comを設定します。
トラブルシューティング
その他の考慮事項
サイトとモバイルアプリ間でパスキーを共有する
関連するオリジン リクエストを使用すると、ユーザーは複数のサイトでパスキーを再利用できます。ユーザーがウェブサイトとモバイルアプリでパスキーを再利用できるようにするには、次の手法を使用します。
- Chrome の場合: Digital Asset Links。詳しくは、デジタル アセット リンクのサポートを追加するをご覧ください。
- Safari の場合: 関連付けられたドメイン。
サイト間でパスワードを共有する
関連するオリジン リクエストを使用すると、ユーザーはサイト間でパスキーを再利用できます。サイト間でパスワードを共有するためのソリューションは、パスワード マネージャーによって異なります。Google パスワード マネージャーの場合は、Digital Asset Links を使用します。Safari には別のシステムがあります。
認証情報マネージャーとユーザー エージェントの役割
これはサイト デベロッパーの範囲を超えていますが、長期的には、RP ID はユーザー エージェントやユーザーが使用している認証情報マネージャーでユーザーに表示されるコンセプトではないことに注意してください。代わりに、ユーザー エージェントと認証情報マネージャーは、認証情報が使用された場所をユーザーに表示する必要があります。この変更の実装には時間がかかります。一時的な解決策として、現在のウェブサイトと元の登録サイトの両方を表示します。