About azure-cloud-hsm
A reference skill for agents working with Azure Cloud Hsm, combining local quick-reference material with remote documentation retrieval. It focuses on key management, troubleshooting, security, service limits, and PKCS#11 integration.
Key features
- 01Cluster troubleshooting
- 02Key management practices
- 03Service limits and algorithm references
- 04Identity and network security configuration
- 05PKCS#11 certificate integration
Use cases
- 01Diagnosing user or key synchronization issues
- 02Checking algorithms and capacity limits
- 03Configuring audit logs and certificate storage
MCP support
The skill can retrieve remote documentation through mcp_microsoftdocs tools; its instructions describe fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-cloud-hsmAfter installing, type/azure-cloud-hsmin Claude Code to confirm it loaded.
Details
From the project READMEAzure Cloud Hsm Skill
This skill provides expert guidance for Azure Cloud Hsm. Covers troubleshooting, best practices, limits & quotas, security, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L33-L38 | Diagnosing and fixing Azure Cloud HSM cluster issues, including user/key synchronization problems, common error codes, connectivity failures, and operational faults. |
| Best Practices | L39-L44 | Key lifecycle and access control practices for Cloud HSM keys, plus security hardening guidance (networking, identity, auditing, compliance) for Azure Cloud HSM deployments. |
| Limits & Quotas | L45-L50 | Service capacity limits (objects, transactions), quotas, and which cryptographic algorithms and key sizes are supported by Azure Cloud HSM |
| Security | L51-L60 | Configuring Cloud HSM security: auth methods, network/private link setup, secure user management, and routing/querying audit and security logs via Event Hubs. |
| Integrations & Coding Patterns | L61-L65 | Using PKCS#11 with Azure Cloud HSM to store, access, and manage X.509 certificates, including configuring certificate storage and integration patterns for apps and services. |
Troubleshooting
| Topic | URL |
|---|---|
| Fix user and key sync issues in Azure Cloud HSM clusters | https://learn.microsoft.com/en-us/azure/cloud-hsm/synchronize-users-keys |
| Troubleshoot common Azure Cloud HSM errors and issues | https://learn.microsoft.com/en-us/azure/cloud-hsm/troubleshoot |
Best Practices
| Topic | URL |
|---|---|
| Apply key management best practices in Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/key-management |
| Apply security best practices to Azure Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/secure-cloud-hsm |
Limits & Quotas
| Topic | URL |
|---|---|
| Review Azure Cloud HSM service object and transaction limits | https://learn.microsoft.com/en-us/azure/cloud-hsm/service-limits |
| Review supported algorithms and key sizes in Azure Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/supported-algorithms |
Security
| Topic | URL |
|---|---|
| Configure authentication methods for Azure Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/authentication |
| Integrate Azure Cloud HSM with Azure Private Link | https://learn.microsoft.com/en-us/azure/cloud-hsm/integrate-with-private-link |
| Configure network security for Azure Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/network-security |
| Route Azure Cloud HSM logs to Event Hubs | https://learn.microsoft.com/en-us/azure/cloud-hsm/tutorial-configure-event-hub |
| Configure and query Azure Cloud HSM audit logs | https://learn.microsoft.com/en-us/azure/cloud-hsm/tutorial-hsm-operation-audit-logs |
| Implement secure user management in Azure Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/user-management |
Integrations & Coding Patterns
| Topic | URL |
|---|---|
| Use PKCS#11 API to manage certificates in Azure Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/pkcs-api-certificate-storage |
| Configure PKCS#11 certificate storage with Azure Cloud HSM | https://learn.microsoft.com/en-us/azure/cloud-hsm/tutorial-certificate-storage |