| name | .claude/skills/authentication-docs/SKILL.md |
| description | API認証・認可フローの図解とドキュメント化、
トークン取得手順の明確な説明のための知識とテンプレート
📚 リソース参照:
このスキルには以下のリソースが含まれています。
必要に応じて該当するリソースを参照してください:
- `.claude/skills/authentication-docs/resources/oauth2-flows.md`: OAuth 2.0各種フロー(Authorization Code、Client Credentials等)の詳細解説
- `.claude/skills/authentication-docs/resources/token-management.md`: トークン取得・更新・有効期限管理
- `.claude/skills/authentication-docs/resources/security-best-practices.md`: 認証セキュリティベストプラクティス
- `.claude/skills/authentication-docs/templates/auth-quickstart.md`: 認証クイックスタートガイドテンプレート
- `.claude/skills/authentication-docs/templates/oauth2-diagrams.md`: OAuth 2.0フローシーケンス図テンプレート(Mermaid形式)
- `.claude/skills/authentication-docs/scripts/generate-auth-flow-diagram.sh`: 認証フロー図自動生成スクリプト
- `.claude/skills/authentication-docs/scripts/test-auth-endpoint.sh`: 認証エンドポイントテストスクリプト
|
| version | 1.0.0 |
Authentication Docs スキル
概要
API認証・認可メカニズムの効果的なドキュメント化手法を提供します。
OAuth 2.0フロー、API Key認証、JWT取得手順などを
開発者が理解しやすい形式で文書化します。
知識ドメイン
1. 認証方式
- API Key認証（ヘッダー/クエリ）
- Bearer Token認証
- Basic認証
- OAuth 2.0各種フロー
- OpenID Connect
2. OAuth 2.0フロー
- Authorization Code Flow（+ PKCE）
- Client Credentials Flow
- Device Code Flow
- Implicit Flow（非推奨）
3. トークン管理
- アクセストークン取得
- リフレッシュトークン使用
- トークン有効期限管理
- スコープと権限
4. セキュリティ考慮
- シークレット管理
- CORS設定
- レート制限
- 監査ログ
5. 図解・可視化
- シーケンス図（Mermaid）
- フロー図
- 状態遷移図
リソース
| ファイル |
内容 |
resources/oauth2-flows.md |
OAuth 2.0各フローの詳細解説 |
resources/token-management.md |
トークン取得・更新・管理 |
resources/security-best-practices.md |
認証セキュリティベストプラクティス |
テンプレート
| ファイル |
用途 |
templates/auth-quickstart.md |
認証クイックスタートガイド |
templates/oauth2-diagrams.md |
OAuth 2.0フロー図テンプレート |
使用方法
このスキルを使用して：
1. 認証方式の選択と説明
2. OAuth 2.0フローの図解作成
3. トークン取得手順のステップバイステップガイド
4. セキュリティ考慮事項の文書化
適用対象
- API認証ドキュメント
- OAuth 2.0統合ガイド
- SDKクイックスタート
- セキュリティガイドライン
関連スキル
| スキル |
パス |
関連性 |
| .claude/skills/openapi-specification/SKILL.md |
.claude/skills/openapi-specification/SKILL.md |
OpenAPIセキュリティスキーム定義 |
| .claude/skills/request-response-examples/SKILL.md |
.claude/skills/request-response-examples/SKILL.md |
認証リクエスト/レスポンス例 |
| .claude/skills/api-documentation-best-practices/SKILL.md |
.claude/skills/api-documentation-best-practices/SKILL.md |
APIドキュメント全体のベストプラクティス |
変更履歴
| バージョン |
日付 |
変更内容 |
| 1.0.0 |
2025-11-27 |
初版リリース。OAuth 2.0フロー、トークン管理、セキュリティベストプラクティスを追加 |