azure-key-vault について
azure-key-vault は、Azure Key Vault と Managed HSM を扱うエージェント向けのガイダンススキルです。セキュリティ、構成、移行、トラブルシューティング、コード連携を、ローカルの参照情報とリモートドキュメントで案内します。
主な機能
- 01Key Vault と Managed HSM のトラブルシューティング
- 02セキュリティとアクセス制御のガイダンス
- 03構成とクォータの参照情報
- 04連携パターンとコード例
- 05デプロイと移行のガイダンス
活用シーン
- 01アクセス ポリシーやネットワークのエラー診断
- 02暗号鍵ワークロードの移行計画
- 03鍵のローテーションと監視の構成
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetch でドキュメントを取得でき、代替手段として fetch_webpage も利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/azure-key-vaultを入力して読み込まれたか確認します。
詳細
Azure Key Vault スキル
このスキルでは、Azure Key Vault に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。
このスキルの使い方
エージェントへの重要事項：関連するセクションを探すには、以下のカテゴリインデックスを使用してください。行の範囲が記載されたカテゴリ（例：
L35-L120）では、指定された行をread_fileで読み取ってください。ファイルへのリンクが記載されたカテゴリ（例：[security.md](security.md)）では、リンク先の参照ファイルをread_fileで読み取ってください。
エージェントへの重要事項：
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールを利用できない場合は、インストールするようユーザーに提案してください：インストールガイド
このスキルでは、ドキュメントコンテンツを取得するためにネットワークアクセスが必要です。
- 推奨：クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用してください。Markdown が返されます。 - 代替手段：クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用してください。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L36-L45 | Key Vault のエラーの診断と修正：REST/API コード、Private Link の構成ミス、アクセス ポリシー／Policy の適用に関する問題、Managed HSM の外部キー管理の失敗。 |
| ベストプラクティス | L46-L52 | Key Vault キーの保護、Managed HSM の災害復旧の処理、準拠性と回復性に優れたキー管理のための BYOK HSM キーの生成／インポートに関するベストプラクティス。 |
| 意思決定 | L53-L63 | アクセス制御モデルの選択、Key Vault API の安全な更新、外部キーや Managed HSM の容量、スケーリング、SLA を含むキーのワークロードの計画／移行に関するガイダンス。 |
| 制限とクォータ | L64-L75 | Key Vault と Managed HSM の制限、クォータ、動作（証明書、シークレット、スロットリング、ログ記録の遅延、IP ファイアウォール／ネットワーク規則、論理削除／復旧、容量の制約）。 |
| セキュリティ | L76-L106 | Azure Key Vault と Managed HSM の保護：認証（Entra ID、RBAC/ABAC、アクセス ポリシー）、ネットワーク／ファイアウォール／プライベート エンドポイント、ゼロトラスト、BYOK/HSM キーの転送、バックアップ／復元、ベストプラクティス。 |
| 構成 | L107-L130 | 監視、ログ記録、アラート、ポリシー、キー／シークレットの種類とローテーション、安全なキーのリリース、BYOK インポート、論理削除／消去保護のための Key Vault と Managed HSM の構成。 |
| 統合とコーディングパターン | L131-L159 | Key Vault とアプリやサービス（Event Grid、Logic Apps、Databricks、Private Link）を統合するパターンとコードサンプル、および .NET、Node.js、Python、JavaScript からキー／シークレットを使用する方法。 |
| デプロイ | L160-L163 | ARM テンプレート、Bicep、Terraform、Azure CLI、PowerShell を使用して Azure Key Vault と Managed HSM（ボールト、キー、シークレット）をデプロイし、プロビジョニングする方法 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Key Vault の一般的なエラーコードを解決する | https://learn.microsoft.com/en-us/azure/key-vault/general/common-error-codes |
| Azure Key Vault の Private Link 構成の問題を診断して修正する | https://learn.microsoft.com/en-us/azure/key-vault/general/private-link-diagnostics |
| Azure Key Vault REST API のエラーコードを解釈する | https://learn.microsoft.com/en-us/azure/key-vault/general/rest-error-codes |
| Key Vault に対する Azure Policy の適用をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/key-vault/general/troubleshoot-azure-policy-for-key-vault |
| Azure Key Vault のアクセス ポリシーの失敗をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/key-vault/general/troubleshooting-access-issues |
| Managed HSM の外部キー管理の失敗をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/external-key-management-troubleshooting |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure Key Vault キーのセキュリティに関するベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/key-vault/keys/secure-keys |
| Azure Managed HSM の障害発生時にディザスターリカバリーを実行する | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/disaster-recovery-guide |
| BYOK HSM キーを生成し、Azure Managed HSM にインポートする | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/hsm-protected-keys-byok |
意思決定
| トピック | URL |
|---|---|
| Key Vault の既定のアクセス制御モデルを選択する | https://learn.microsoft.com/en-us/azure/key-vault/general/access-control-default |
| Azure Key Vault API バージョンを安全に更新する | https://learn.microsoft.com/en-us/azure/key-vault/general/migrate-api-version |
| 暗号化キーのワークロードの移行を計画し、実行する | https://learn.microsoft.com/en-us/azure/key-vault/general/migrate-key-workloads |
| Azure Key Vault をアクセス ポリシーから RBAC に移行する | https://learn.microsoft.com/en-us/azure/key-vault/general/rbac-migration |
| 外部キーから Managed HSM キーへの移行を計画する | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/external-key-management-migration |
| Managed HSM の外部キーに関する SLA と責任を評価する | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/external-key-management-shared-responsibility |
| Azure Managed HSM の容量とスケーリングを計画する | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/scaling-guidance |
制限とクォータ
| トピック | URL |
|---|---|
| Azure Key Vault の証明書の制限と動作を理解する | https://learn.microsoft.com/en-us/azure/key-vault/certificates/faq |
| Azure Key Vault のログ記録の遅延を構成し、解釈する | https://learn.microsoft.com/en-us/azure/key-vault/general/logging |
| Azure Key Vault のスロットリング制限を理解し、管理する | https://learn.microsoft.com/en-us/azure/key-vault/general/overview-throttling |
| Azure Key Vault と Managed HSM のサービス制限を確認する | https://learn.microsoft.com/en-us/azure/key-vault/general/service-limits |
| Managed HSM の IP ファイアウォールとネットワーク セキュリティを構成する | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/configure-network-security |
| Azure Managed HSM のサービス制限とクォータを確認する | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/service-limits |
| Managed HSM リソースで論理的な削除と復旧を使用する | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/soft-delete-overview |
| Azure Key Vault のシークレットのサイズ制限を理解する | https://learn.microsoft.com/en-us/azure/key-vault/secrets/about-secrets |
セキュリティ
構成
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| Terraform を使用した Key Vault とキーのプロビジョニング | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-terraform |
コメント
Markdown 対応