api-gateway-and-edge-security について
公開クライアントやパートナーに API を提供する際の、API ゲートウェイとエッジセキュリティを設計するスキルです。認可、リクエスト検証、レート制限、脅威対策、監視と、セキュリティレビュー向けの確認項目を扱います。
主な機能
- 01ルート単位の認証と認可
- 02エッジでのリクエストとスキーマ検証
- 03IP・トークン・テナント別レート制限
- 04WAF・ボット・不正利用対策
- 05監査ログと異常アラート
- 06セキュリティ証跡と終了条件
活用シーン
- 01外部利用者向け API の公開準備
- 02複数 API への一貫したエッジポリシー適用
- 03認可とトークンライフサイクルの確認
- 04セキュリティ・コンプライアンスレビューの証跡収集
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/api-gateway-and-edge-securityを入力して読み込まれたか確認します。
詳細
API ゲートウェイとエッジセキュリティ
使用する場面
- パブリッククライアントやパートナーに API を公開する場合
- ガバナンスのためにエッジポリシーの一元管理が必要な場合
ワークフロー
- ルートレベルの認証と認可の要件を定義します。
- エッジでリクエストの検証とスキーマの適用を設定します。
- IP、トークン、テナントを考慮したレート制限を適用します。
- WAF、ボット対策、不正利用検知のルールを追加します。
- セキュリティ監査ログと異常アラートを出力します。
必須チェック
- 不正なトラフィックがバックエンドの呼び出し前にブロックされること
- 機密性の高いヘッダーとペイロードのフィールドがサニタイズされること
- バーストトラフィック発生時にも、レート制限によって下流サービスが保護されること
判断フレームワーク
- アクセス判断の信頼できる情報源として、サーバー側の認可を適用します。
- デフォルトでは、最小権限のスコープとロールマッピングを使用します。
- トークンを使用する場合は、検証、ローテーション、失効の動作を明確に定義します。
- 外部 ID プロバイダーが関与する場合は、障害時とフォールバック時の動作を定義します。
よくある正当化と反論
- 「クライアント側のチェックで十分です。」 -> クライアントのロジックは回避可能なため、バックエンドの境界でチェックを適用します。
- 「広範なスコープのほうが管理しやすいです。」 -> 広範なスコープは影響範囲とコンプライアンスリスクを拡大します。
- 「監査ログは後から追加できます。」 -> 監査証跡が欠けていると、インシデント対応やコンプライアンス対応が妨げられます。
エビデンスパック
- 不正なアクセス試行や不正形式のアクセス試行に対するネガティブテストケース
- オーナーの承認を得たスコープと権限のマッピング
- トークン／セッションのライフサイクルフローと失効動作の証明
- 機密性の高い操作に関する監査およびセキュリティ監視のエビデンス
終了基準
- エッジセキュリティの態勢が適用可能であり、監視されていること
- API 利用者に一貫したエラーとクォータの動作が提供されること
コメント
Markdown 対応