1---2name: azure-key-vault3description: Azure Key Vault Skill4---5# Azure Key Vault Skill67This skill provides expert guidance for Azure Key Vault. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.89## How to Use This Skill1011> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file1213> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)1415This skill requires **network access** to fetch documentation content:16- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.17- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.1819## Category Index2021| Category | Lines | Description |22|----------|-------|-------------|23| Troubleshooting | L36-L45 | Diagnosing and fixing Key Vault issues: certificate problems, access policy and Azure Policy failures, Private Link misconfig, and interpreting REST/API error codes. |24| Best Practices | L46-L56 | Best practices for securing keys/secrets, using soft-delete, disaster recovery for Managed HSM, and automating single/dual-credential secret rotation in Azure Key Vault. |25| Decision Making | L57-L63 | Guidance on migrating Key Vault keys and access control (access policies to RBAC) and planning capacity, performance, and scaling for Azure Managed HSM deployments. |26| Limits & Quotas | L64-L74 | Key Vault and Managed HSM limits: throttling, quotas, size/storage constraints, logging behavior, soft-delete rules, and firewall/network configuration. |27| Security | L75-L102 | Securing Azure Key Vault and Managed HSM: auth/RBAC vs access policies, network/firewall/Private Link, HSM/BYOK and attestation, backups, and role/permission management. |28| Configuration | L103-L127 | Configuring Key Vault and Managed HSM for auth, logging, monitoring, alerts, key types/import/rotation, secure key release, governance, and managing secrets/storage keys. |29| Integrations & Coding Patterns | L128-L160 | Code samples and patterns for integrating Key Vault/Managed HSM with apps and services: client libraries, JS key/secret ops, Event Grid/Logic Apps, DigiCert, TLS offload, and SAS retrieval. |30| Deployment | L161-L172 | How to deploy and provision Azure Key Vault and Managed HSM (vaults, keys, secrets) using ARM templates, Bicep, Terraform, Azure CLI, and PowerShell |3132### Troubleshooting33| Topic | URL |34|-------|-----|35| Troubleshoot common Azure Key Vault certificate issues | https://learn.microsoft.com/en-us/azure/key-vault/certificates/faq |36| Understand common Azure Key Vault error codes | https://learn.microsoft.com/en-us/azure/key-vault/general/common-error-codes |37| Diagnose and fix Key Vault Private Link configuration issues | https://learn.microsoft.com/en-us/azure/key-vault/general/private-link-diagnostics |38| Interpret Azure Key Vault REST API error codes | https://learn.microsoft.com/en-us/azure/key-vault/general/rest-error-codes |39| Troubleshoot Azure Policy enforcement on Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/general/troubleshoot-azure-policy-for-key-vault |40| Troubleshoot Azure Key Vault access policy issues | https://learn.microsoft.com/en-us/azure/key-vault/general/troubleshooting-access-issues |4142### Best Practices43| Topic | URL |44|-------|-----|45| Use and manage Azure Key Vault soft-delete safely | https://learn.microsoft.com/en-us/azure/key-vault/general/soft-delete-overview |46| Security best practices for Azure Key Vault keys | https://learn.microsoft.com/en-us/azure/key-vault/keys/secure-keys |47| Disaster recovery procedure for Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/disaster-recovery-guide |48| Apply security best practices to Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/secure-managed-hsm |49| Apply security best practices for Key Vault secrets | https://learn.microsoft.com/en-us/azure/key-vault/secrets/secure-secrets |50| Automate rotation of single-credential secrets in Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/secrets/tutorial-rotation |51| Automate rotation for dual-credential secrets in Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/secrets/tutorial-rotation-dual |5253### Decision Making54| Topic | URL |55|-------|-----|56| Decide how to migrate Azure Key Vault key workloads | https://learn.microsoft.com/en-us/azure/key-vault/general/migrate-key-workloads |57| Migrate Key Vault from access policies to RBAC | https://learn.microsoft.com/en-us/azure/key-vault/general/rbac-migration |58| Plan capacity and scaling for Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/scaling-guidance |5960### Limits & Quotas61| Topic | URL |62|-------|-----|63| Configure and interpret Azure Key Vault logging behavior | https://learn.microsoft.com/en-us/azure/key-vault/general/logging |64| Understand and handle Azure Key Vault throttling limits | https://learn.microsoft.com/en-us/azure/key-vault/general/overview-throttling |65| Review Azure Key Vault and Managed HSM service limits | https://learn.microsoft.com/en-us/azure/key-vault/general/service-limits |66| Configure Managed HSM firewall and networking | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/configure-network-security |67| Review Azure Managed HSM service limits and quotas | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/service-limits |68| Understand soft-delete behavior and constraints in Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/soft-delete-overview |69| Understand Azure Key Vault secret size and storage behavior | https://learn.microsoft.com/en-us/azure/key-vault/secrets/about-secrets |7071### Security72| Topic | URL |73|-------|-----|74| Apply security best practices for Key Vault certificates | https://learn.microsoft.com/en-us/azure/key-vault/certificates/secure-certificates |75| Enable Key Vault access from behind a firewall | https://learn.microsoft.com/en-us/azure/key-vault/general/access-behind-firewall |76| Prepare for Azure Key Vault RBAC default access | https://learn.microsoft.com/en-us/azure/key-vault/general/access-control-default |77| Assign Azure Key Vault access policies via CLI | https://learn.microsoft.com/en-us/azure/key-vault/general/assign-access-policy |78| Configure authentication to Azure Key Vault with Entra ID | https://learn.microsoft.com/en-us/azure/key-vault/general/authentication |79| Configure network security and firewalls for Azure Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/general/network-security |80| Secure Key Vault access with virtual network service endpoints | https://learn.microsoft.com/en-us/azure/key-vault/general/overview-vnet-service-endpoints |81| Integrate Azure Key Vault with Private Link endpoints | https://learn.microsoft.com/en-us/azure/key-vault/general/private-link-service |82| Choose Azure RBAC vs access policies for Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/general/rbac-access-policy |83| Grant Key Vault access to apps using Azure RBAC | https://learn.microsoft.com/en-us/azure/key-vault/general/rbac-guide |84| Apply security best practices to Azure Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/general/secure-key-vault |85| Plan and use HSM-protected keys in Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/keys/hsm-protected-keys |86| Implement BYOK HSM-protected keys in Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/keys/hsm-protected-keys-byok |87| Legacy nCipher BYOK import for Azure Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/keys/hsm-protected-keys-ncipher |88| Manage access control and authorization for Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/access-control |89| Authorize Azure Resource Manager for Managed HSM key operations | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/authorize-azure-resource-manager |90| Back up and restore Azure Managed HSM contents | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/backup-restore |91| Use Managed HSM built-in local RBAC roles | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/built-in-roles |92| Configure secure access and RBAC for Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/how-to-secure-access |93| Implement BYOK for Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/hsm-protected-keys-byok |94| Use key attestation to validate Managed HSM keys | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/key-attestation |95| Configure network security and firewall for Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/network-security |96| Configure Managed HSM private endpoints with Private Link | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/private-link |97| Manage Managed HSM roles and role assignments | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/role-management |9899### Configuration100| Topic | URL |101|-------|-----|102| Configure health and throttling alerts for Azure Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/general/alert |103| Configure authentication and REST requests for Azure Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/general/authentication-requests-and-responses |104| Integrate Azure Key Vault governance with Azure Policy | https://learn.microsoft.com/en-us/azure/key-vault/general/azure-policy |105| Enable and configure Azure Key Vault logging | https://learn.microsoft.com/en-us/azure/key-vault/general/howto-logging |106| Configure monitoring for Azure Key Vault with Azure Monitor | https://learn.microsoft.com/en-us/azure/key-vault/general/monitor-key-vault |107| Reference for Azure Key Vault monitoring metrics and logs | https://learn.microsoft.com/en-us/azure/key-vault/general/monitor-key-vault-reference |108| Use supported key types and algorithms in Azure Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/keys/about-keys-details |109| Implement BYOK key import specification for Azure Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/keys/byok-specification |110| Configure Azure Key Vault key auto-rotation | https://learn.microsoft.com/en-us/azure/key-vault/keys/how-to-configure-key-rotation |111| Author secure key release policies in Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/keys/policy-grammar |112| Configure health and performance alerts for Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/configure-alerts |113| Set up key auto-rotation in Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/key-rotation |114| Enable and use Azure Managed HSM logging | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/logging |115| Monitor Azure Managed HSM with Azure Monitor | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/logging-azure-monitor |116| Configure multi-region replication for Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/multi-region-replication |117| Author secure key release policies for Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/policy-grammar |118| Configure soft-delete and purge protection in Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/recovery |119| Integrate Managed HSM logs with Microsoft Sentinel | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/sentinel |120| Store multiline secrets in Azure Key Vault via CLI and PowerShell | https://learn.microsoft.com/en-us/azure/key-vault/secrets/multiline-secrets |121| Manage storage account keys with Key Vault using Azure CLI | https://learn.microsoft.com/en-us/azure/key-vault/secrets/overview-storage-keys |122| Manage storage account keys with Key Vault using PowerShell | https://learn.microsoft.com/en-us/azure/key-vault/secrets/overview-storage-keys-powershell |123124### Integrations & Coding Patterns125| Topic | URL |126|-------|-----|127| Integrate Azure Key Vault with DigiCert CA | https://learn.microsoft.com/en-us/azure/key-vault/certificates/how-to-integrate-certificate-authority |128| Use Azure Key Vault client libraries across languages | https://learn.microsoft.com/en-us/azure/key-vault/general/client-libraries |129| Send email on Key Vault secret changes with Logic Apps | https://learn.microsoft.com/en-us/azure/key-vault/general/event-grid-logicapps |130| Integrate Azure Key Vault events with Azure Event Grid | https://learn.microsoft.com/en-us/azure/key-vault/general/event-grid-overview |131| Handle Key Vault notifications using Azure Event Grid | https://learn.microsoft.com/en-us/azure/key-vault/general/event-grid-tutorial |132| Back up, delete, and restore keys in JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-backup-delete-restore-key |133| Create and rotate Key Vault keys in JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-create-update-rotate-key |134| Enable or disable Key Vault keys in JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-enable-disable-key |135| Encrypt and decrypt with Key Vault keys in JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-encrypt-decrypt-key |136| Retrieve Azure Key Vault keys in JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-get-key |137| Connect to Azure Key Vault keys with JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-get-started |138| Import keys into Azure Key Vault with JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-import-key |139| List Azure Key Vault keys using JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-list-key-version |140| Sign and verify with Key Vault keys in JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/javascript-developer-guide-sign-verify-key |141| Use Azure Key Vault keys with Go SDK | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-go |142| Use Azure Key Vault keys with Java SDK | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-java |143| Use Azure Key Vault keys client library for .NET | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-net |144| Use Azure Key Vault keys client library for JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-node |145| Use Azure Key Vault Python client library to manage keys | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-python |146| Manage keys within Azure Managed HSM | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/key-management |147| Integrate Managed HSM TLS Offload library with F5 and Nginx | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/tls-offload-library |148| Back up and restore Key Vault secrets in JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/secrets/javascript-developer-guide-backup-secrets |149| Delete and purge Key Vault secrets with JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/secrets/javascript-developer-guide-delete-secret |150| Enable or disable Key Vault secrets using JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/secrets/javascript-developer-guide-enable-disable-secret |151| List and find Key Vault secrets using JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/secrets/javascript-developer-guide-find-secret |152| Retrieve Azure Key Vault secrets with JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/secrets/javascript-developer-guide-get-secret |153| Connect to Key Vault secrets from JavaScript applications | https://learn.microsoft.com/en-us/azure/key-vault/secrets/javascript-developer-guide-get-started |154| Create, update, and rotate Key Vault secrets with JavaScript | https://learn.microsoft.com/en-us/azure/key-vault/secrets/javascript-developer-guide-set-update-rotate-secret |155| Use .NET code to fetch SAS tokens from Key Vault | https://learn.microsoft.com/en-us/azure/key-vault/secrets/storage-keys-sas-tokens-code |156157### Deployment158| Topic | URL |159|-------|-----|160| Deploy Azure Key Vault using ARM templates | https://learn.microsoft.com/en-us/azure/key-vault/general/vault-create-template |161| Deploy Key Vault and key using Bicep | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-bicep |162| Deploy Key Vault and key with ARM template | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-template |163| Provision Key Vault and key using Terraform | https://learn.microsoft.com/en-us/azure/key-vault/keys/quick-create-terraform |164| Provision and activate Managed HSM using Azure CLI | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/quick-create-cli |165| Provision and activate Managed HSM with PowerShell | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/quick-create-powershell |166| Deploy Azure Managed HSM using ARM template | https://learn.microsoft.com/en-us/azure/key-vault/managed-hsm/quick-create-template |167| Deploy Key Vault and secrets using Bicep templates | https://learn.microsoft.com/en-us/azure/key-vault/secrets/quick-create-bicep |168| Deploy Key Vault and secrets with ARM templates | https://learn.microsoft.com/en-us/azure/key-vault/secrets/quick-create-template |