Authentication Flows

概要

複数の認証方式を比較し、最適なフローとトークン戦略を設計する。 詳細は references/ に外部化し、必要時に参照する。

• 方式別ガイドは references/api-key.md, references/jwt.md, references/oauth2.md, references/mtls.md
• 実装例は assets/ を利用

ワークフロー

Phase 1: 要件整理

目的: 認証要件と制約を整理する

アクション:

1. references/Level1_basics.md で基礎概念を確認
2. 対象システムの要件と制約を整理
3. セキュリティ要件と脅威を洗い出す

Task: agents/analyze-auth-requirements.md

Phase 2: 方式選定と設計

目的: 認証方式とトークン戦略を決定する

アクション:

1. references/api-key.md / references/jwt.md / references/oauth2.md / references/mtls.md を比較
2. トークン構造・署名・有効期限方針を決定
3. assets/jwt-service-template.ts / assets/oauth2-client-template.ts を参照

Task:

• agents/select-auth-method.md
• agents/design-token-strategy.md

Phase 3: 検証と記録

目的: 設定の妥当性を検証し記録する

アクション:

1. scripts/validate-auth-config.mjs で設定検証
2. scripts/validate-skill.mjs で構造検証
3. scripts/log_usage.mjs で改善記録を残す

Task: agents/validate-auth-implementation.md

Task仕様ナビ

ベストプラクティス

すべきこと

• 要件と制約を先に整理する
• トークン有効期限と更新戦略を明記する
• 方式選定の理由を記録する
• 標準仕様に準拠した設定を採用する

避けるべきこと

• シークレットのハードコード
• 暗号化無しの認証情報送信
• 複数方式の無計画な混在
• 検証無しで設計を確定する

リソース参照

参照資料

• references/Level1_basics.md: 基本概念
• references/Level2_intermediate.md: 実装パターン
• references/Level3_advanced.md: 脅威と最適化
• references/Level4_expert.md: エンタープライズ運用
• references/api-key.md: API Key
• references/jwt.md: JWT
• references/oauth2.md: OAuth 2.0
• references/mtls.md: mTLS
• references/legacy-skill.md: 旧版要約（移行時のみ参照）

スクリプト

• scripts/validate-auth-config.mjs: 設定検証
• scripts/validate-skill.mjs: スキル構造検証
• scripts/log_usage.mjs: 実行ログ記録

テンプレート

• assets/jwt-service-template.ts: JWTテンプレ
• assets/oauth2-client-template.ts: OAuthテンプレ

変更履歴