Agent skill
fido2
FIDO2/WebAuthn/パスキー関連の実装・設定・ドキュメント・テストを扱う時に使用。パスキー登録、認証、管理、アテステーション検証に関する作業で自動的に呼び出される。
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/fido2
SKILL.md
FIDO2/WebAuthn コンテキスト
idp-serverにおけるFIDO2/WebAuthn/パスキー実装のコンテキスト情報。
アーキテクチャ概要
クライアント (sample-web)
│
├── navigator.credentials.create() / get()
│
▼
idp-server (認可フロー内)
│
├── WebAuthn4jRegistrationManager (登録)
├── WebAuthn4jAuthenticationManager (認証)
│
▼
WebAuthn4j ライブラリ (内部統合)
重要: 外部FIDO2サーバーではなく、WebAuthn4jライブラリを内部統合。
主要ファイル
実装 (Java)
| ファイル | 役割 |
|---|---|
libs/idp-server-webauthn4j-adapter/.../WebAuthn4jRegistrationManager.java |
登録処理・アテステーション検証 |
libs/idp-server-webauthn4j-adapter/.../WebAuthn4jAuthenticationManager.java |
認証処理・署名検証 |
libs/idp-server-webauthn4j-adapter/.../WebAuthn4jConfiguration.java |
設定パース |
libs/idp-server-webauthn4j-adapter/.../WebAuthn4jManagerFactory.java |
Manager生成 |
ドキュメント (How-to)
| ファイル | 内容 |
|---|---|
documentation/.../fido2/01-registration.md |
パスキー登録設定 |
documentation/.../fido2/02-authentication.md |
パスキー認証設定 |
documentation/.../fido2/03-management.md |
パスキー管理API |
documentation/.../fido2/04-attestation-verification.md |
アテステーション検証 |
E2Eテスト
| ファイル | 内容 |
|---|---|
e2e/src/tests/usecase/mfa/mfa-05-fido2.test.js |
FIDO2基本フロー |
e2e/src/tests/usecase/mfa/mfa-06-fido2-attestation-verification.test.js |
アテステーション検証 |
e2e/src/lib/fido/fido2.js |
テスト用FIDO2ヘルパー |
サンプルアプリ
| ファイル | 内容 |
|---|---|
sample-web/src/components/PasskeyRegistration.tsx |
登録UI |
sample-web/src/components/PasskeyAuthentication.tsx |
認証UI |
sample-web/src/components/UserInfo.tsx |
デバイス一覧表示 |
WebAuthn4j関数マッピング
| interaction | function | 用途 |
|---|---|---|
fido2-registration-challenge |
webauthn4j_registration_challenge |
登録チャレンジ発行 |
fido2-registration |
webauthn4j_registration |
登録完了・検証 |
fido2-authentication-challenge |
webauthn4j_authentication_challenge |
認証チャレンジ発行 |
fido2-authentication |
webauthn4j_authentication |
認証完了・検証 |
設定パラメータ
基本設定
{
"rp_id": "example.com",
"origin": "https://example.com",
"rp_name": "My Service",
"require_resident_key": true,
"user_verification_required": true
}
アテステーション検証
| モード | 設定 | 用途 |
|---|---|---|
| なし | attestation_preference: "none" |
開発・一般向け |
| TrustStore | trust_store_path: "/path/to/truststore.p12" |
特定ベンダー限定 |
| FIDO MDS | mds.enabled: true |
本番・高セキュリティ |
複数Origin対応
{
"rp_id": "example.com",
"allowed_origins": [
"https://app.example.com",
"https://www.example.com"
]
}
認証ポリシー設定例
{
"success_conditions": {
"any_of": [
[{ "path": "$.password-authentication.success_count", "operation": "gte", "value": 1 }],
[{ "path": "$.fido2-authentication.success_count", "operation": "gte", "value": 1 }]
]
}
}
パスキー一覧取得
パスキー一覧は ID Token / Userinfo の authentication_devices クレーム から取得。
前提設定
- 認可サーバー:
custom_claims_scope_mapping: true - クライアント:
scope: "openid claims:authentication_devices" - 認可リクエスト:
scope=openid+claims:authentication_devices
よくある作業パターン
新機能追加
WebAuthn4j*Manager.javaに処理追加WebAuthn4jConfiguration.javaに設定追加- E2Eテスト追加
- ドキュメント更新
設定変更
04-attestation-verification.mdで設定例確認WebAuthn4jConfiguration.javaでパース確認- E2Eテストで動作確認
$ARGUMENTS
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?