mtls-configuration について
サービスメッシュやゼロトラストネットワークで相互 TLS を設定するためのガイドです。サービス間通信を保護するチーム向けに、証明書階層、ローテーション、障害対応、安全な運用方法を扱います。
主な機能
- 01mTLS ハンドシェイクと証明書階層の説明
- 02証明書ローテーションと期限監視の案内
- 03TLS 障害のトラブルシューティング
- 04PERMISSIVE から STRICT への移行方法
- 05証明書検証と監査の実践方法
活用シーン
- 01サービス間通信の保護
- 02ゼロトラストネットワークの実装
- 03TLS ハンドシェイク障害の診断
- 04証明書ローテーションと期限の管理
- 05マルチクラスター通信の安全な設計
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ wshobson/ agents --skill mtls-configurationインストール後、Claude Code で/mtls-configurationを入力して読み込まれたか確認します。
同梱ファイルreferences/details.md
詳細
mTLS 構成
ゼロトラストなサービスメッシュ通信を実現するための相互 TLS の実装に関する包括的なガイドです。
このスキルを使用する場面
- ゼロトラストネットワーキングの実装
- サービス間通信の保護
- 証明書のローテーションと管理
- TLS ハンドシェイクの問題のデバッグ
- コンプライアンス要件 (PCI-DSS、HIPAA)
- マルチクラスタの安全な通信
中核となる概念
1. mTLS のフロー
┌─────────┐ ┌─────────┐
│ Service │ │ Service │
│ A │ │ B │
└────┬────┘ └────┬────┘
│ │
┌────┴────┐ TLS Handshake ┌────┴────┐
│ Proxy │◄───────────────────────────►│ Proxy │
│(Sidecar)│ 1. ClientHello │(Sidecar)│
│ │ 2. ServerHello + Cert │ │
│ │ 3. Client Cert │ │
│ │ 4. Verify Both Certs │ │
│ │ 5. Encrypted Channel │ │
└─────────┘ └─────────┘
2. 証明書の階層
Root CA (Self-signed, long-lived)
│
├── Intermediate CA (Cluster-level)
│ │
│ ├── Workload Cert (Service A)
│ └── Workload Cert (Service B)
│
└── Intermediate CA (Multi-cluster)
│
└── Cross-cluster certs
テンプレートと詳細な実例
テンプレートの完全なライブラリと詳細な実例は references/details.md にあります。具体的なテンプレートが必要な場合は、そのファイルを参照してください。
ベストプラクティス
推奨事項
- PERMISSIVE から始める - 段階的に STRICT へ移行します
- 証明書の有効期限を監視する - アラートを設定します
- 有効期間の短い証明書を使用する - ワークロードには 24 時間以下を推奨します
- CA を定期的にローテーションする - CA のローテーションを計画します
- TLS エラーをログに記録する - デバッグと監査のためです
非推奨事項
- mTLS を無効にしない - 本番環境での利便性のために無効にしないでください
- 証明書の有効期限を無視しない - ローテーションを自動化してください
- 自己署名証明書を使用しない - 適切な CA 階層を使用してください
- 検証を省略しない - チェーン全体を検証してください
コメント
Markdown 対応