# Authentication Flows

> API Key、JWT、OAuth 2.0、mTLS などの認証方式を比較し、適切なフロー設計と実装方針を整理するスキル。 方式選定、トークン管理、署名戦略、セキュリティ対策を一貫して設計します。 Anchors: • Web Application Security / 適用: 脅威整理 / 目的: 認証フローのリスク把握 • OWASP Authentication Cheat Sheet / 適用: 実装ベストプラクティス / 目的: 安全な実装指針 • RFC 6749 & RFC 7519 / 適用: OAuth/JWT仕様 / 目的: 標準準拠の設計 Trigger: Use when selecting authentication flows (API Key/JWT/OAuth/mTLS), designing token strategy, or validating auth configuration.

- Skill: `majiayu000/authentication-flows` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/authentication-flows`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/authentication-flows/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/authentication-flows

---


# 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仕様ナビ

| Task | 役割 | 入力 | 出力 | 参照先 | 実行タイミング |
| --- | --- | --- | --- | --- | --- |
| 要件整理 | 目的・制約の整理 | 要件情報 | 要件メモ | `references/Level1_basics.md` | Phase 1 |
| 方式選定 | 認証方式の選定 | 要件メモ | 選定メモ | `references/api-key.md` | Phase 2 前半 |
| トークン設計 | 署名と有効期限の設計 | 選定メモ | 設計メモ | `references/jwt.md` | Phase 2 後半 |
| 検証レビュー | 設定の検証 | 設定ファイル | 検証結果 | `scripts/validate-auth-config.mjs` | Phase 3 |

## ベストプラクティス

### すべきこと

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

### 避けるべきこと

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

## リソース参照

### 参照資料

- `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テンプレ

## 変更履歴

| Version | Date       | Changes                                             |
| ------- | ---------- | --------------------------------------------------- |
| 2.1.0   | 2025-12-31 | 18-skills準拠、Task仕様追加、scripts整備            |
| 2.0.0   | 2025-12-31 | 18-skills.md仕様に完全準拠                           |
| 1.0.0   | 2025-12-24 | 初版作成                                            |