パスキー(WebAuthn)の実装の確認とは、ブラウザから届く登録とログインの応答を、サーバーが仕様どおりに1つずつ検証できているかを、自分のサーバーの単体テストで確かめる作業です。署名・challenge・origin・rpIDの照合は検証ライブラリが止めてくれますが、credential IDの重複・challengeの使い捨て・パスキーの追加と削除の扱いは、アプリ側で書かないと誰も止めません。この記事は、自分の実装の検証漏れを見つけて直すための確認の手順をまとめたものです。
2026年のUSENIX Securityで発表された論文「The State of Passkeys」は、パスキーに対応した103のサイトを調べ、仕様が求める確認をすべて満たしたサイトは1つも無かったと報告しています。18サイトには重大(critical)な不備があり、うち5サイトは署名を検証していませんでした。パスキーそのものが破られたのではなく、サイト側の検証の抜けです。自分のサービスが同じ抜けを持っていないかは、公開のサイトに何かを送って試すのではなく、自分の手元で検証関数をテストして確かめます。
この記事では、論文で見つかった不備の種類と件数、検証ライブラリが止めるものとアプリ側で足す確認の分け方、自分の検証関数を単体テストで確かめる観点と合否、本番の前に確かめる手順をまとめます。確認は2026年11月16日に、macOS 27.2.1(Apple Silicon)・Node.js 23.10.0・npm 10.9.2・@simplewebauthn/server 14.1.0で行いました。仕様の手順はW3Cの勧告(Web Authentication Level 3・2026年8月25日)で確かめています。
結論:ライブラリに任せる検証と、アプリで足す確認を分ける
署名・challengeの一致・origin・rpID・type・UP/UVのフラグは、検証ライブラリに正しい期待値を渡せば止まります。credential IDの重複・challengeの使い捨てとセッションへの結びつけ・パスキーの追加時の本人確認は、ライブラリの外なのでアプリで書きます。どちらをどう確かめるかを分けたのが次の表です。
| 確認すること | 止めるのは | テストで確かめること(合否) |
|---|---|---|
| 署名 | ライブラリ(ただし戻り値の verified を見ること) | 正常系で verified: true を受けて初めてログインを通す。戻り値を見ずに通していないか |
| type(登録用とログイン用の取り違え) | ライブラリ | 登録用と検証用のオプションを取り違えていないか |
| challengeの一致 | ライブラリ(期待値はアプリが渡す) | 検証に渡す期待値が、そのセッションで発行したchallengeか |
| origin | ライブラリ(許す一覧はアプリが渡す) | 許すoriginの一覧が完全一致で、使う場所だけに絞られているか |
| rpID | ライブラリ(期待値はアプリが渡す) | rpIDが使うホスト名だけで、親ドメインに広げていないか |
| UP・UVのフラグ | ライブラリ(UVは既定で必須) | 登録・ログイン・検証でUVの指定がそろっているか |
| credential IDの重複 | アプリ | 確認が無いと別ユーザーの登録が通る。一意の制約で拒否になることをテストで確かめる |
| challengeの使い捨て | アプリ | 使い捨てが無いと同じchallengeのログインが2回通る。取り出した時点で消すことをテストで確かめる |
つまり、ライブラリを入れただけでは半分です。残りの半分は、データベースとセッションの扱いの中にあります。
論文で見つかった不備と件数
論文は872のパスキー対応サイトを洗い出し、そのうち208サイトで実際にパスキーを登録して扱いを調べ、103サイトに15種類の確認の抜けがないかを試しています(USENIX Security 2026の発表ページ・論文の表2)。論文の表2から主な項目を選び、深刻度(CVSS)と見つかったサイトの数を並べました。自分の実装で同じ項目が守られているかの、確認の一覧として読めます。
| 確認の抜け | CVSS | 起きること | 見つかったサイト |
|---|---|---|---|
| 署名を検証しない | 9.8 | 署名が合わない応答でもログインが通る | 5 |
| credential IDの重複(Credential Overwrite) | 9.1 | 利用者の公開鍵が上書きされてログインできなくなる・利用者のパスキーが消える・利用者が別人のアカウントに結びつく | 14 |
| Related Originsの古いドメイン | 8.8 | 共有を許す一覧に、今は自社の管理下にないドメインが残っている | 1(このドメインが他人に取られると72のoriginに影響) |
| challengeの確認の抜け | 8.2 | 古い応答の使い回し・別のセッションへの差し込みが通る | 22 |
| originの確認の抜け | 8.1 | 使う場所以外のoriginからの応答が通る | 40 |
| 登録用の署名をログインに使う(Context) | 6.4 | 登録とログインの取り違え | 12 |
確認の抜けとは別に、208サイトの扱いも調べられています。パスキーの追加の前に、パスワード・メール・SMSなどで本人を確かめたのは71サイト(34%)だけで、66%はログイン中なら確認なしで追加できました。80サイト(38%)はパスキーの有効範囲(rpID)を親ドメインまで広げていました。1つのパスキーしか登録できないサイトが25あり、削除のボタンが無い・同じパスキーでないと消せないサイトもありました。アルゴリズムでは、SHA-1を使うRSA署名は5回(論文の数え方)求められていて、パスキーでは使えない共通鍵のHMACを求めるサイトが8ありました。
自分の検証を単体テストで確かめる
確かめるのは、公開のサイトではなく自分のサーバーの検証関数です。正常系(本物の登録とログイン)は、ブラウザのテスト機能である仮想認証器(Chrome DevToolsのWebAuthnタブ、Playwright・Seleniumの仮想認証器)で通します。アプリ側で足す確認(credential IDの一意・challengeの使い捨て・UVの一致)は、データベースとロジックのテストで確かめます。署名・origin・rpID・フラグはライブラリに任せ、正常系が通ること・戻り値の verified を見ていることだけを確かめます。
確認は自分の実装に対してだけ行ってください。他人のサービスや、自分の管理外のサーバーに、確認のための応答を送ってはいけません(不正アクセス禁止法に触れます)。改ざんした応答を手で組み立てる必要はありません。見つける対象は「自分の検証が足りているか」であって、他人の仕組みを破ることではないからです。
検証サーバーの最小の形(passkey-server.mjs)
@simplewebauthn/server で登録とログインを検証する最小のサーバーです。データベースとセッションの代わりに Map を使っています。uniqueCredentialId(credential IDの重複の確認)と consumeChallenge(challengeの使い捨て)を切り替えられるようにしてあるのは、テストで「確認を外すと通ってしまい、付けると拒否される」ことを赤と緑で確かめるためです。本番では必ず付けたまま使ってください。
import {
generateAuthenticationOptions,
generateRegistrationOptions,
verifyAuthenticationResponse,
verifyRegistrationResponse,
} from '@simplewebauthn/server';
const RP_ID = 'app.example.com';
const ORIGIN = 'https://app.example.com';
const ALGS = [-7, -8, -257];
export function createPasskeyServer({ uniqueCredentialId = true, consumeChallenge = true } = {}) {
const credentials = new Map();
const challenges = new Map();
function takeChallenge(sessionId, purpose) {
const saved = challenges.get(sessionId);
if (!saved || saved.purpose !== purpose || saved.expiresAt < Date.now()) {
throw new Error('challenge が無いか期限切れ');
}
if (consumeChallenge) challenges.delete(sessionId);
return saved.challenge;
}
async function startRegistration(sessionId, user) {
const options = await generateRegistrationOptions({
rpName: 'Example',
rpID: RP_ID,
userName: user.name,
userID: new TextEncoder().encode(user.id),
supportedAlgorithmIDs: ALGS,
authenticatorSelection: { residentKey: 'preferred', userVerification: 'required' },
excludeCredentials: [...credentials.values()]
.filter((c) => c.userId === user.id)
.map((c) => ({ id: c.id })),
});
challenges.set(sessionId, { challenge: options.challenge, purpose: 'register', expiresAt: Date.now() + 60_000 });
return options;
}
async function finishRegistration(sessionId, user, response) {
const expectedChallenge = takeChallenge(sessionId, 'register');
const { verified, registrationInfo } = await verifyRegistrationResponse({
response,
expectedChallenge,
expectedOrigin: ORIGIN,
expectedRPID: RP_ID,
supportedAlgorithmIDs: ALGS,
});
if (!verified) throw new Error('登録の検証に失敗');
const { id, publicKey, counter } = registrationInfo.credential;
if (uniqueCredentialId && credentials.has(id)) {
throw new Error('この credential ID はすでに登録されている');
}
credentials.set(id, { id, publicKey, counter, userId: user.id });
return id;
}
async function startLogin(sessionId) {
const options = await generateAuthenticationOptions({ rpID: RP_ID, userVerification: 'required' });
challenges.set(sessionId, { challenge: options.challenge, purpose: 'login', expiresAt: Date.now() + 60_000 });
return options;
}
async function finishLogin(sessionId, response) {
const expectedChallenge = takeChallenge(sessionId, 'login');
const saved = credentials.get(response.id);
if (!saved) throw new Error('登録されていない credential ID');
const { verified, authenticationInfo } = await verifyAuthenticationResponse({
response,
expectedChallenge,
expectedOrigin: ORIGIN,
expectedRPID: RP_ID,
credential: { id: saved.id, publicKey: saved.publicKey, counter: saved.counter },
});
if (!verified) throw new Error('ログインの検証に失敗');
credentials.set(saved.id, { ...saved, counter: authenticationInfo.newCounter });
return saved.userId;
}
return { startRegistration, finishRegistration, startLogin, finishLogin, credentials };
}単体テストで確かめる観点と合否
自分の finishRegistration・finishLogin(またはそれにあたる関数)に対して、次の観点をテストにします。正常系は仮想認証器で1回通し、残りはアプリ側のロジックとデータベースへの問い合わせで確かめます。
| 観点 | テストの内容 | 合格 |
|---|---|---|
| 正常系 | 仮想認証器で登録→ログインを1回通す | どちらも成功し、保存した鍵でログインできる |
| 戻り値を見ている | 検証の戻り値 verified が false のとき、ログインを通さない分岐があるか(コードを読む/verified を強制的に false にした単体テスト) | if (!verified) で止まる |
| credential IDの一意 | 同じcredential IDの行を2つ入れようとする(データベースへの問い合わせ) | 一意の制約で2つ目が拒否される(0件で合格) |
| challengeの使い捨て | challengeを取り出す処理を2回呼ぶ | 2回目は「無いか期限切れ」で拒否される |
| UVの一致 | 登録・ログイン・検証のオプションの userVerification を読み比べる | 3か所でそろっている |
| originとrpID | 検証に渡すoriginの一覧とrpIDを読む | 完全一致の一覧で、使う場所だけに絞られている |
気をつけたい点が2つあります。1つ目は、署名が合わないとき、@simplewebauthn/serverは例外を投げずに verified: false を返すことです。try で例外だけを見て戻り値を見ない書き方だと、署名を検証していないのと同じになります。2つ目は、counterです。ライブラリは「前回より大きいか」を確かめますが、前回も今回も0なら確かめません。WebAuthnの勧告の手順も、両方が0のときは回数を比べないと書いています(7.2節)。counterが0のままの認証器に対して使い回しを止めるのは、challengeを1回で捨てる処理です。だからcredential IDの一意とchallengeの使い捨ては、ライブラリに任せず自分でテストします。
アプリ側で足す4つの確認
ライブラリが止めない2つ(credential IDの重複・challengeの使い捨て)と、設定の食い違いで利用者を締め出す1つ、パスキーの使える範囲を広げすぎる1つを、アプリの側で足します。
credential IDは全ユーザーで一意にする
WebAuthnの勧告は、登録の手順の中で「credential IDがどのユーザーにもまだ登録されていないことを確かめ、登録済みなら登録を失敗させるべき(SHOULD)」と書いています(Web Authentication Level 3の7.1節)。データベースでは、credential IDの列に一意の制約を付け、保存の前に存在を確かめます。ユーザーごとの一意ではなく、全ユーザーで一意にするのがポイントです。
- 保存は「無ければ入れる」にし、上書き(upsert)にしない
- ログインでは credential ID から行を引き、その行のユーザーとしてログインさせる。ユーザー名を先に入れる画面なら、引いた行のユーザーと一致するかも見る
- 既存の重複を探すには、credential IDでまとめて2行以上ある行を数える(0件が合格)
challengeはセッションに結びつけて1回で捨てる
challengeは、発行したセッションと用途(登録かログインか)と期限をいっしょに保存し、検証に使ったらすぐ消します。「発行したchallengeの一覧のどれかに当たればよい」という保存のしかたは、別のセッションのchallengeを差し込まれても通ってしまいます。記事のサーバーはセッションIDをキーにして保存し、取り出した時点で消しています。
origin・rpIDは使う場所だけに絞る
rpIDを親ドメイン(example.com)にすると、すべてのサブドメインがそのパスキーを使えるようになります。ログインに使う場所が app.example.com だけなら、rpIDも app.example.com にします。originは完全一致の一覧で渡し、「example.com で終わるか」のような前方・後方一致で許さないでください。すでに親ドメインで発行したパスキーは、rpIDを変えると使えなくなるので、変える前に新しいパスキーの登録を案内する期間が要ります。
本人確認(UV)の指定を登録・ログイン・検証でそろえる
@simplewebauthn/server 14.1.0の既定では、登録とログインのオプションの userVerification が preferred(できれば)なのに、検証の requireUserVerification は true(必須)でした。既定値の組み合わせのままだと、本人確認をしない認証器の利用者は、ブラウザの側では登録やログインを終えても、サーバーの検証で拒否されることになります。記事のサーバーはオプションを required にそろえています。本人確認を任意にするなら、検証の側も合わせて外し、2要素めの扱いにするかを決めます。
登録・削除・共有の運用で確かめること
検証のコードが正しくても、パスキーの出し入れの画面に穴があると、他人のパスキーを追加させられたり、なくしたときに戻れなくなったりします。論文の調べた項目から、画面と運用で確かめることを並べます。
- 追加の前の本人確認:ログイン中でも、パスキーの追加はパスワードの変更と同じ重さで扱い、追加の直前に再認証(パスワード・既存のパスキー・メールのどれか)を求める
- 複数の登録:予備の認証器を持てるよう、1人に複数のパスキーを登録できるようにする(登録のオプションの
excludeCredentialsで同じ認証器の二重登録だけを防ぐ) - 削除:1つずつ消せる。消すときに、そのパスキー自身での認証を求めない(なくしたものは使えないため)
- Related Origins:
/.well-known/webauthnの一覧に載せたドメインが、すべて今も自社の管理下にあるか。期限切れのドメインを残さない - アルゴリズム:一覧(
pubKeyCredParams)にSHA-1のRSA署名や共通鍵のHMACを入れない。論文によると、実際に最も多く求められていたのはES256とRS256で、@simplewebauthn/server 14.1.0の既定は、Node.js 23.10.0ではEdDSA(-8)・ES256(-7)・RS256(-257)の3つだった(ML-DSAに対応する実行環境ではML-DSA-44も加わる)
本番の前に確かめる手順
次の順で確かめると、1回のループで閉じられます。どれも、自分の検証関数のテストか、データベース・設定・画面の確認で合否が出ます。他人のサービスへ何かを送る手順はありません。
- 検証関数を取り出す:自分のサーバーの登録とログインの検証の部分(ライブラリを呼んで保存するところ)を、記事の
passkey-server.mjsと同じ形の関数にして、テストから呼べるようにする - 正常系を通す:仮想認証器(Chrome DevToolsのWebAuthnタブ、Playwright・Seleniumの仮想認証器)で、登録とログインが1回通ることを確かめる
- 戻り値を見る:検証の戻り値
verifiedを見て分岐しているかをコードで確かめる。見ていなければ、署名を検証していないのと同じ - アプリ側の確認をテストする:同じcredential IDの登録が一意の制約で拒否されるか、challengeを取り出す処理を2回呼ぶと2回目が拒否されるかを、単体テストで確かめる
- 設定を見る:rpIDとoriginの一覧が使う場所だけか、
/.well-known/webauthnの一覧のドメインが全部生きているか、userVerificationが登録・ログイン・検証でそろっているか - 画面を見る:追加の前に再認証があるか、複数登録と1つずつの削除ができるか
ここまで通れば、論文の挙げた項目のうち、署名の戻り値・credential IDの重複・challengeの使い捨て・origin・rpID・UVは自分の実装で確かめたことになります。counterの巻き戻し・バックアップのフラグ(BE/BS)・credential IDの長さ・iframeからの呼び出し(crossOrigin)は、仮想認証器のオプションや、保存した正常系の値を変えた単体テストで確かめてください。次の一手は、同じ検証に使うライブラリ自体を古いままにしないことです。依存の脆弱性の確かめ方はNode.jsの脆弱性の確認と対応|全環境の版を洗い出すとNext.js・RSCの脆弱性|同梱の修正を目印で確かめるで、版を洗い出す手順として整理しています。
つまずきやすい点
| 症状 | 原因 | 直し方 |
|---|---|---|
| 署名が合わない応答でもログインできる | verified を見ず、例外が出なければ成功としていた | if (!verified) で止める |
| ブラウザでは登録できたのにサーバーで拒否される | オプションのUVが preferred、検証は必須 | オプションを required にするか、検証の側を合わせる |
| サブドメインを足したら旧パスキーが使えない | rpIDを変えた(パスキーは発行時のrpIDに結びつく) | 移行期間を設け、新しいrpIDでの登録を案内する |
| 同じ応答を送り直すとログインできる | counterが0の認証器で、challengeを使い捨てにしていない | 取り出した時点でchallengeを消す |
| ある利用者のパスキーが急に使えなくなった | credential IDで上書き保存している | 一意の制約を付け、upsertをやめる |
パスキーの前段にあるパスワードのログインやセッションの扱いはPHPログイン機能の作り方|セッションとpassword_hashで安全に実装する手順で、ログインしたあとの認証情報の置き場所はlocalStorageにJWTを保存すべきかで整理しています。
よくある質問
Q. 検証ライブラリを使っていれば、論文の確認項目は全部満たせますか?
満たせません。署名・challenge・origin・rpID・フラグはライブラリが止めますが、credential IDの重複とchallengeの使い捨ては、ライブラリの外のデータベースとセッションの扱いなので、アプリで書いてテストする必要があります。
Q. rpIDは親ドメインにしたほうが便利ではないですか?
便利ですが、すべてのサブドメインがパスキーを使えるようになります。論文では38%のサイトが親ドメインまで広げていました。使う場所が1つなら、そのホスト名をrpIDにするのが安全です。
Q. counterを見ていれば、challengeを使い捨てにしなくてよいですか?
よくありません。WebAuthnの勧告の手順は今回と保存済みの両方が0なら回数を比べず、テストでも同じchallengeを2回渡すと、使い捨てが無いと2回とも通ります。challengeは検証に使った時点で消してください。
Q. 改ざんした応答を自分で作って試さなくてよいのですか?
要りません。正常系は仮想認証器(ブラウザのテスト機能)で通し、署名やoriginの照合はライブラリに任せます。自分で足す確認(credential IDの一意・challengeの使い捨て・UVの一致)は、データベースとロジックのテストで合否が出ます。他人のサービスに応答を送るのは不正アクセス禁止法に触れるので行いません。
Q. パスキーの追加に再認証を求めると、利用者が面倒になりませんか?
追加の直前に1回だけ求める形なら、ふだんのログインは変わりません。論文では34%のサイトが追加の前に確認しており、主にパスワード・メール・SMSを使っていました。既存のパスキーでの確認でもかまいません。
Q. PHPやPythonのサーバーでも同じ確かめ方ができますか?
できます。確かめる観点(verified を見る・credential IDを一意にする・challengeを使い捨てる・UVをそろえる)は言語に関係なく同じで、正常系は仮想認証器、残りはロジックとデータベースのテストで確かめます。
次に読む
依存のパッケージを入れるときに動くスクリプトの扱いはnpm 12のinstallスクリプト停止|壊れる依存と許可の決め方で、ログインのあとのトークンの保存先の比べ方はlocalStorage・sessionStorage・Cookie・IndexedDBの使い分けでまとめています。





