2026年のパスキーとWebAuthn:ウェブ開発者のための実践的実装ガイド
パスキーはパスワードを保存せずにパスワードレスサインインを約束しますが、WebAuthnを正しく実装するにはブラウザAPIを呼び出すだけでは不十分です。登録、認証、サーバー側検証、発見可能な認証情報、アカウント回復が安全なウェブアプリケーションでどのように連携するかを学びましょう。
パスキーとWebAuthn in 2026: Web開発者向け実践実装ガイド
パスワードは何十年もの間、Webアプリケーションのデフォルト認証機構でした。彼らはまた、セキュリティ問題の永続的な発生源でもあります。
ユーザーは再利用します。攻撃者はフィッシングを通じて盗み取ります。サーバーはパスワードハッシュを保護し、リセットを管理し、資格情報スタフィッディング攻撃から防御しなければなりません。
パスキーは根本的に異なるアプローチを提供します。
代わりにユーザーに共有秘密を覚えられるよう求めるのではなく、パスキーは公開鍵暗号学とユーザーが制御する認証器を使用します。ブラウザはWebAuthnを通じて標準インターフェースを提供し、サーバーは正しいクレデンシャルが使用されたことを確認する暗号学的証拠を検証します。
この技術はもはや実験的なものではなくなりました。WebAuthnは現代のブラウザで広く利用可能であり、そのJSONの利便メソッドにより統合はかなり簡素化されました。
しかし、安全なパスキーによるログインを構築するには、依然として慎重なバックエンド設計が必要です。
このガイドは、アーキテクチャを説明し、ブラウザ側のフローを実演し、開発者が見落としてはならないサーバー側のチェックを特定します。
1. パスキーは正確には何ですか?
パスキーは、公開鍵暗号学を通じてユーザーを認証するために使用される、発見可能なFIDOクレデンシャルです。
登録中、認証器は暗号鍵ペアを作成します。
秘密鍵は認証器またはそのクレデンシャル管理エコシステムによって保護されたままです。ウェブサイトは対応する公開鍵を受け取り、それをユーザーのアカウントに関連付けます。
認証中、サーバーは新しいチャレンジを発行します。認証器はそのチャレンジに関連するデータを署名し、サーバーは保存された公開鍵を使用して署名を検証します。
ウェブサイトに送信される再利用可能なパスワードはありません。
認証器は、スマートフォン、Windows Helloを使用するコンピューター、ハードウェアセキュリティキー、または同期パスキーをサポートするクレデンシャルマネージャーかもしれません。
すべてのパスキーがデバイス間で同期されるわけではありません。一部のクレデンシャルはデバイスに紐付きのままですが、他方は安全にバックアップされ、クレデンシャルプロバイダーを通じて利用可能にできます。
FIDO仕様は、クレデンシャルをRelying Partyのドメインにバインドすることでフィッシングを抵抗するよう設計されています。生体データは使用される場合、デバイスによってローカルで処理され、ウェブサイトに送信されることはありません。
2. WebAuthnはパスキーの背後にあるブラウザAPIです
WebAuthnは、ウェブサイトが公開鍵クレデンシャルを作成および使用できるようにするウェブプラットフォームAPIです。
2つのブラウザメソッドが基礎を形成します。
navigator.credentials.create()
navigator.credentials.get()
最初のメソッドはクレデンシャルを作成し、2番目のメソッドは既存のクレデンシャルを使用して認証をリクエストします。
両方のメソッドはpublicKeyオプションと一緒に動作し、通常はHTTPSであるセキュアコンテキストを必要とします。
重要なのは、ブラウザがユーザーを認証したかどうかを決定しないことです。ブラウザはバックエンドが検証しなければならないデータを返します。
ブラウザのプロンプトが成功したことは、ログインを受け入れることの証明ではありません。
サーバーは依然として、チャレンジ、オリジン、Relying Party識別子、暗号学的証拠を検証する責任を負います。
3. 完全なアーキテクチャを理解する
典型的な実装には次の4つのコンポーネントが含まれます。
- Webアプリケーションのフロントエンド。WebAuthnを呼び出します。
- アプリケーションバックエンド。チャレンジを生成し、レスポンスを検証します。
- 認証器またはパスキープロバイダー。秘密鍵を保護します。
- データベース。クレデンシャルメタデータと公開鍵を保存します。
登録フローは次のとおりです:ウェブアプリケーションが登録オプションをリクエストし、バックエンドがチャレンジとユーザー情報を生成し、ブラウザと認証器がクレデンシャルと鍵ペアを作成し、バックエンドが結果を検証して公開鍵を保存します。
サーバーは決して、ブラウザから返されたためとして登録データを信じるべきではありません。
悪意のあるクライアントは、期待されるフロントエンドをまったく使用せず、任意のHTTPリクエストを送信できます。
そのため、検証はサーバー側で行う必要があります。
4. サーバーで登録オプションを生成する
WebAuthnを呼び出す前に、バックエンドは登録チャレンジとオプションを生成します。
説明用のオプションオブジェクトは次のようになります。
{
"rp": {
"name": "Example Application",
"id": "example.com"
},
"user": {
"id": "dXNlci0xMjM",
"name": "alex@example.com",
"displayName": "Alex"
},
"challenge": "SERVER_GENERATED_BASE64URL_CHALLENGE",
"pubKeyCredParams": [
{
"type": "public-key",
"alg": -7
}
],
"authenticatorSelection": {
"residentKey": "required",
"userVerification": "required"
},
"attestation": "none",
"timeout": 300000
}
これは説明用のJSONであり、完全な本番レスポンスではありません。
いくつかのフィールドが重要です。
rp.idはRelying Partyを識別します。例えば、example.comは、WebAuthnのRP ID検証ルールの対象となるそのドメインの適切なサブドメインに使用できます。
user.idは、JSON転送のためにbase64urlでエンコードされた、安定していて不透明なアカウント識別子であるべきです。不要な個人情報を公開してはいけません。
challengeはサーバー上で暗号学的に安全なランダムソースを使用して生成する必要があります。
residentKey: "required"は発見可能なクレデンシャルを要求し、パスキー体験に必要なものです。
userVerification: "required"はデバイスPINや生体認証などのローカルユーザー検証を要求します。バックエンドは後で、その検証が実際に発生したかどうかを確認する必要があります。
Googleのサーバー側登録ガイドはこれらのフィールドを説明し、登録データの生成と検証のために維持されているWebAuthnライブラリの使用を推奨しています。
5. JavaScriptでパスキーを作成する
現代のブラウザは便利なメソッドを提供します。
PublicKeyCredential.parseCreationOptionsFromJSON()
これはbase64urlエンコードされたバイナリフィールドを含むJSON表現を、WebAuthnが期待する構造に変換します。
これにより、すべてのフィールドに対してカスタムのbase64urlからArrayBufferへの変換ロジックを書く必要がありません。
ここに、簡略化されたブラウザ側の登録関数があります。
async function registerPasskey() {
const optionsResponse = await fetch(
'/api/passkeys/register/options',
{
method: 'POST',
credentials: 'same-origin',
headers: {
'Content-Type': 'application/json',
'X-CSRF-Token': csrfToken
}
}
);
if (!optionsResponse.ok) {
throw new Error('Unable to start registration');
}
const optionsJson = await optionsResponse.json();
const publicKey =
PublicKeyCredential.parseCreationOptionsFromJSON(
optionsJson
);
const credential = await navigator.credentials.create({
publicKey
});
if (!credential) {
throw new Error('No credential was created');
}
const verifyResponse = await fetch(
'/api/passkeys/register/verify',
{
method: 'POST',
credentials: 'same-origin',
headers: {
'Content-Type': 'application/json',
'X-CSRF-Token': csrfToken
},
body: JSON.stringify(credential.toJSON())
}
);
if (!verifyResponse.ok) {
throw new Error('Registration verification failed');
}
return await verifyResponse.json();
}
The csrfToken変数は、アプリケーション提供のanti-CSRFトークンを表します。サーバーはそれを検証する必要があります。この例では、ページがすでに安全に認証されたユーザーに関連付けられていることを前提としています。
credential.toJSON()は、返されたクレデンシャルのJSONフレンドリーな表現を提供し、手動のバイナリシリアライゼーションのさらなる層を回避します。
これらの便利機能は現在のブラウザで利用可能ですが、古いブラウザバージョンをサポートするアプリケーションは互換性処理を提供すべきです。
上記のコードはブラウザ側だけであり、完全な認証実装ではありません。
6. サーバーが登録中に検証しなければならないこと
ブラウザが新しいクレデンシャルを返したら、バックエンドは何かを保存する前にそれを検証する必要があります。
検証プロセスが少なくとも以下を確立する必要があります。
- 返されたチャレンジが、この登録試行のために生成されたものと一致すること。
- チャレンジが新しいもので、すでに消費されていないこと。
- 報告されたオリジンが、明示的に信頼されたアプリケーションのオリジンと一致すること。
- 認証器データが期待されるRP IDに対応していること。
- 必要なユーザー存在とユーザー検証の条件が満たされていること。
- クレデンシャルの公開鍵と識別子を抽出して検証できること。
- 登録が正しい認証済みアカウントに関連付けられていること。
アプリケーションのポリシーに応じて、追加のチェックには、サポートされるアルゴリズム、クレデンシャルの一意性、アテステーション要件が含まれる場合があります。
成功した登録は通常、次のものを保存します。
| Field | Purpose |
|---|---|
credential_id |
Identifies the credential |
user_id |
Links it to an account |
public_key |
Verifies future signatures |
sign_count |
Tracks authenticator counter data |
transports |
Optional authenticator transport hints |
created_at |
Registration timestamp |
last_used_at |
Account management and auditing |
backup_eligible / backup_state |
Optional backup-related metadata |
正確なデータベース表現は、検証ライブラリとアプリケーションに依存します。
説得力のある理由とそれを維持する専門知識がない限り、CBOR解析、アテステーション検証、暗号学的署名検証をゼロから実装しないでください。
W3C仕様は、詳細な登録および認証検証手順を定義しています。
7. 既存ユーザーを認証する
認証は類似した構造に従いますが、新しい鍵ペアを作成しません。
サーバーは新しいチャレンジを生成し、認証オプションをブラウザに送信します。
発見可能なパスキーによるログインのため、これらのオプションには次のものが含まれるかもしれません。
{
"challenge": "NEW_SERVER_GENERATED_CHALLENGE",
"rpId": "example.com",
"userVerification": "required",
"timeout": 300000
}
ブラウザは次にクレデンシャルをリクエストできます。
async function authenticateWithPasskey() {
const optionsResponse = await fetch(
'/api/passkeys/login/options',
{
credentials: 'same-origin'
}
);
if (!optionsResponse.ok) {
throw new Error('Unable to start authentication');
}
const optionsJson = await optionsResponse.json();
const publicKey =
PublicKeyCredential.parseRequestOptionsFromJSON(
optionsJson
);
const credential = await navigator.credentials.get({
publicKey
});
if (!credential) {
throw new Error('Authentication was cancelled');
}
const verifyResponse = await fetch(
'/api/passkeys/login/verify',
{
method: 'POST',
credentials: 'same-origin',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(credential.toJSON())
}
);
if (!verifyResponse.ok) {
throw new Error('Authentication failed');
}
return await verifyResponse.json();
}
この例は、バックエンドが発行されたチャレンジを短期かつ匿名のログイン取引に関連付け、適切なレート制限を適用し、成功した検証の後にのみ新しい認証済みセッションを確立することを前提としています。
サーバーはクレデンシャルIDを検索し、保存された公開鍵で署名されたアサーションを検証し、チャレンジとオリジンを確認し、ユーザー検証ポリシーを施行する必要があります。
それから初めて、ユーザーのセッションを確立すべきです。
parseRequestOptionsFromJSON()はモダンなWebAuthn APIの一部であり、一般的なブラウザ側統合でバイナリフィールドを手動でデコードする必要がなくなります。
8. 条件付き仲介を使用して既存のログインフォームにパスキーを追加する
WebAuthnの最も有用な機能の一つは条件付き仲介、ときにパスキー自動入力と呼ばれます。
すぐに分離したパスキーダイアログを表示する代わりに、ブラウザはユーザーがログインフィールドと相互作用するとき、保存された他のクレデンシャルとともに利用可能なパスキーを提供できます。
HTML入力は次のように使用できます。
<input
type="text"
name="username"
autocomplete="username webauthn"
>
アプリケーションはサポートを確認できます。
const supported =
await PublicKeyCredential.isConditionalMediationAvailable();
if (supported) {
// Request authentication with mediation: 'conditional'.
}
navigator.credentials.get()を呼び出すとき、アプリケーションは次のを使用します。
{
publicKey,
mediation: 'conditional'
}
発見可能なクレデンシャル自動入力のため、サーバーのオプションはリクエストを特定のクレデンシャルIDリストに制限すべきではありません。
条件付き仲介は、パスワードからの段階的な移行中特に有用です。ユーザーが特定のアカウントにパスキーがあるかどうかを覚える必要がないからです。
ブラウザは、馴染みのあるログイン体験の中で適切なオプションを提示できます。
9. チャレンジとオリジンのチェックが不可欠な理由
パスキーはフィッシング耐性がありますが、アプリケーションが認証プロトコルを無視できるという意味ではありません。
チャレンジはリプレイ攻撃から保護します。
新しいばらつきのあるチャレンジがなければ、攻撃者は以前のセッションからの認証データを再利用しようとするかもしれません。
オリジンとRP IDのチェックは、クレデンシャルが意図されたウェブサイトのコンテキストで使用されていることを確認します。
例えば、example.comのために作成されたパスキーは、examp1e.comのような類似したフィッシングサイトによって簡単に再利用されることはできません。
ブラウザと認証器は、このドメイン結合の重要な部分を強制し、バックエンドは結果の証拠を独立して検証します。
良い実装は、短期のチャレンジを使用し、各チャレンジを一度だけ消費し、単に馴染みのあるようなホスト名を共有する任意のオリジンを単に受け入れないようにします。
MDNは、信頼できる環境でチャレンジを生成し、一般的に約10分より長くはしない短い期間後に無効化するよう推奨しています。
10. 署名カウンタを誤解しないでください
WebAuthn認証器は署名カウンタを含むことができます。
歴史的に、カウンタは潜在的にクローンされた認証器を検出するのに役立ちました。カウンタが予期せず増加しなくなった場合、Relying Partyはそれをリスクシグナルとして考えるかもしれません。
しかし、すべての認証器が意味のあるカウンタを維持するわけではありません。
一部のクレデンシャルは常にゼロを報告します。同期されたクレデンシャルは、複数のデバイスが同じクレデンシルのコピを使用する可能性があるため、カウンタの解釈を複雑にするかもしれません。
W3C仕様は、予期しないカウンタ動作をクローン確実な証明ではなく、可能性のあるシグナルとして明示的に扱います。
そのため、開発者は、カウンタがゼロまたは変更されていないログインを盲目的に拒否すべきではありません。
カウンタは、認証器の動作、WebAuthn検証ライブラリのガイダンス、およびアプリケーションのセキュリティポリシーに従って使用してください。
11. アカウントリカバリはパスキーセキュリティの一部です
リカバリストラテギーなしのパスキー実装は不完全です。
ユーザーがデバイスを紛失したとき、何が起こりますか?
彼らが唯一のパスキーを削除したらどうなりますか?
彼らがクレデンシャルプロバイダーを変更するか、同期されたクレデンシャルにアクセスできない場合はどうなりますか?
賢明な設計では、ユーザーが複数のパスキーを登録し、アカウント設定から管理できるようにします。
管理インターフェースは、認識可能なクレデンシャル名、作成日、利用可能な場合は最近の使用情報を表示するべきです。
ユーザーは、信頼しなくなったクレデンシャルを取り消せるべきです。
しかし、リカバリーハーネスには特に注意が必要です。
攻撃者が弱いメールリカバリプロセスを使用してパスキー認証をバイパスできる場合、全体のアカウントのセキュリティはそのリカバリーパスに等しいです。
高リスクのアカウントについては、より強力なリカバリーバイオレーション、リカバリーコード、追加の登録済み認証器、および機密アカウント変更に関する通知を検討してください。
GoogleのパスキーUXガイダンスは、適切な場所でリカバリーハーネスを確立し、複数のパスキーをサポートすることを推奨しています。
12. 一般的な実装ミス
いくつかのミニフは、それ以外は有望なパスキー統合を繰り返し弱めます。
ブラウザの成功をサーバー認証として扱うこと。 解決されたnavigator.credentials.get()のプロミスは、サーバー側の暗号学的検証を置き換えるものではありません。
JavaScriptでチャレンジを生成すること。 チャレンジは信頼できるサーバーから来て、適切な認証トランザクションにバインドされるべきです。
間違ったRP IDを使用すること。 ドメインのスコープ設定はセキュリティ機能であり、装飾的な設定ではありません。本番、ステージング、ローカル開発環境には意図的な設定が必要です。
すべてのパスキーが同期すると仮定すること。 デバイスに紐付いたクレデンシャルは、エコシステムの重要な部分のままです。
クレデンシャルの取り消しを忘れること。 ユーザーは、紛失または侵害された認証器をアカウントから削除する手段が必要です。
弱いフォールバックを作成すること。 アカウントリカバリーが簡単に悪用できる場合、フィッシング耐性のあるログインはその価値のほとんどを失います。
古いブラウザを無視すること。 モダンなJSON利便メソッドは複雑さを減らしますが、古いブラウザ要件を持つアプリケーションは依然として互換性コードを必要とするかもしれません。
CSRFとセッションプロテクションを省略すること。 登録とクレデンシャル管理の操作は機密性の高いアカウント変更です。他の重要なアカウント操作と同じ保護が必要です。
暗号学的検証を不必要に独自に書くこと。 維持されているWebAuthnサーバーライブラリを実装直接よりも通常は安全な選択肢とします。
13. すべてのウェブサイトがすぐにパスワードを置き換えるべきですか?
必ずしもそうではありません。
パスキーは使いやすさとセキュリティの両方を改善できますが、移行戦略が重要です。
新しいアプリケーションの場合、製品が十分に設計されたリカバリーフローを持ち、対象プラットフォームをサポートしていれば、パスワードレス登録が合理的なデフォルトかもしれません。
何千人ものユーザーを抱える既存アプリケーションの場合、段階的な採用がしばしば安全です。
まず、認証されたユーザーがアカウント設定でパスキーを登録できるようにします。
次に、既存の認証システムと並行してパスキーによるログインを追加します。
サポートされている場所で条件付き仲介を導入します。
登録成功、認証失敗、デバイス互換性、リカバリーリクエストを測定します。
最後に、ユーザーエクスペリエンスとリカバリーハーネスが十分に成熟したら、パスキーを推奨される認証方法にすることを検討します。
段階的な展開は、正当なユーザーをロックアウトすることなく、ブラウザ固有の問題を特定しやすくします。
14. 本番準備チェックリスト
本番でパスキーを有効にする前に、以下を確認してください。
-
All WebAuthn operations run in an appropriate secure context.
-
すべてのWebAuthn操作が適切なセキュアコンテキストで実行される。
-
RP IDs and trusted origins are explicitly configured.
-
RP IDと信頼されたオリジンが明示的に設定される。
-
Challenges are cryptographically random, short-lived and single-use.
-
チャレンジが暗号学的にランダムで、短期であり、一度だけ使用可能である。
-
Registration requires appropriate account authorization.
-
登録には適切なアカウント認可が必要です。
-
Server-side verification follows the WebAuthn specification.
-
サーバー側の検証がWebAuthn仕様に従う。
-
Public keys and credential identifiers are stored safely.
-
公開鍵とクレデンシャル識別子が安全に保存される。
-
Login establishes a session only after successful verification.
-
ログインは成功した検証の後にのみセッションを確立する。
-
User-verification requirements are enforced on the server.
-
ユーザー検証要件がサーバーで施行される。
-
Credential removal and account recovery are protected.
-
クレデンシャル削除とアカウントリカバリーが保護される。
-
Multiple credentials per account are supported where appropriate.
-
適切な場所で、アカウントごとに複数のクレデンシャルがサポートされる。
-
Authentication failures and security-sensitive account changes are monitored.
-
認証失敗とセキュリティ上重要なアカウント変更は監視される。
-
Mobile, desktop, cross-device and hardware-key scenarios are tested.
-
モバイル、デスクトップ、クロスデバイス、ハードウェアキーのシナリオがテストされる。
これらのチェックの方が、フロントエンドが魅力的な生体認証ログインを画面に表示できるかよりも重要です。
Conclusion: passkeys are an authentication architecture, not just a browser feature
結論:パスキーは単なるブラウザ機能ではなく、認証アーキテクチャです
WebAuthnは公開鍵認証を通常のWebアプリケーションで利用可能にします。
モダンブラウザAPIは、以前はパスキー統合を煩雑にしていた多くのシリアライズ作業を削除しました。
しかしブラウザはシステムの一部にすぎません。
実際の実装作業は、チャレンジ管理、サーバー側検証、クレデンシャルストレージ、ドメイン設定、アカウントリカバリー、そして安全なユーザージャーニーにあります。
PHP、JavaScript、Pythonまたはその他のバックエンド環境でモダンなアプリケーションを構築する開発者にとって、パスキーは従来のパスワードにとってますます実用的な代替手段として検討する価値があります。
最良の出発点は、認証システム全体を夜中に置き換えることではありません。
それは、1つの完全で正しく検証された登録とログインのフローを実装し、その周りに安全な移行戦略を構築することです。