Catalog
MicrosoftDocs/azure-dedicated-hsm

MicrosoftDocs

azure-dedicated-hsm

Expert knowledge for Azure Dedicated HSM development including troubleshooting, decision making, architecture & design patterns, and security. Use when deploying Dedicated HSMs, configuring VNets/ExpressRoute, planning HA/failover, or migrating to Managed/Cloud HSM, and other Azure Dedicated HSM related development tasks. Not for Azure Cloud Hsm (use azure-cloud-hsm), Azure Key Vault (use azure-key-vault), Azure Payment Hsm (use azure-payment-hsm).

v1.0Latest
New~1.0kUpdated Jun 26, 2026

Azure Dedicated HSM Skill

This skill provides expert guidance for Azure Dedicated HSM. Covers troubleshooting, decision making, architecture & design patterns, and security. 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), 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 file

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

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category Lines Description
Troubleshooting L32-L37 Diagnosing and fixing Azure Dedicated HSM deployment, configuration, usage, and support issues, including common errors and steps to resolve failed or misconfigured HSM instances.
Decision Making L38-L44 Guidance on Dedicated HSM retirement, choosing successors (Managed/Cloud HSM), and planning/migrating ExpressRoute IPs and HSM workloads to new SKUs or services.
Architecture & Design Patterns L45-L51 Guidance on designing Dedicated HSM deployments: sizing and topology, high availability and failover patterns, and secure networking (VNet, subnets, routing, and connectivity).
Security L52-L56 Physical security controls for Dedicated HSM devices and best-practice guidance for securing, configuring, and operating Azure Dedicated HSM in production environments.

Troubleshooting

Topic URL
Resolve common Azure Dedicated HSM usage and support questions https://learn.microsoft.com/en-us/azure/dedicated-hsm/faq
Troubleshoot Azure Dedicated HSM deployment and configuration issues https://learn.microsoft.com/en-us/azure/dedicated-hsm/troubleshoot

Decision Making

Topic URL
Migrate Dedicated HSM ExpressRoute Basic IP to Standard SKU https://learn.microsoft.com/en-us/azure/dedicated-hsm/migration-basic-standard
Plan migration from Azure Dedicated HSM to Managed or Cloud HSM https://learn.microsoft.com/en-us/azure/dedicated-hsm/migration-guide
Understand Azure Dedicated HSM retirement and successors https://learn.microsoft.com/en-us/azure/dedicated-hsm/overview

Architecture & Design Patterns

Topic URL
Design deployment architecture for Azure Dedicated HSM https://learn.microsoft.com/en-us/azure/dedicated-hsm/deployment-architecture
Design high availability for Azure Dedicated HSM https://learn.microsoft.com/en-us/azure/dedicated-hsm/high-availability
Plan networking architecture for Azure Dedicated HSM https://learn.microsoft.com/en-us/azure/dedicated-hsm/networking

Security

Topic URL
Understand physical security of Azure Dedicated HSM devices https://learn.microsoft.com/en-us/azure/dedicated-hsm/physical-security
Apply security best practices to Azure Dedicated HSM https://learn.microsoft.com/en-us/azure/dedicated-hsm/secure-dedicated-hsm
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Safety

82

Quality

65

Clarity

78

Completeness

62

Summary

This skill provides expert guidance for Azure Dedicated HSM deployment, architecture, troubleshooting, and security decisions. It functions as a reference skill that directs agents to fetch Microsoft Learn documentation via network APIs (mcp_microsoftdocs or fetch_webpage) and combines remote content with locally-indexed quick-reference tables organized by category.

Detected Capabilities

network requestremote documentation fetchfile readreference indexing

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure dedicated hsmhsm troubleshootinghsm migrationhsm architecturehsm networkinghsm high availabilityhsm security

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Troubleshoot Azure Dedicated HSM deployment and configuration failures
  • Plan migration from Dedicated HSM to Managed or Cloud HSM
  • Design high-availability and failover patterns for Dedicated HSM
  • Architect secure VNet and ExpressRoute connectivity for HSM instances
  • Apply physical and operational security best practices to Dedicated HSM
  • Understand Dedicated HSM retirement timeline and successor selection

Quality Notes

  • Skill is well-structured with clear category index and metadata timestamp for staleness detection
  • Explicitly documents fallback behavior when preferred MCP tools are unavailable, improving resilience
  • Includes helpful agent-facing instructions on when to use mcp_microsoftdocs vs. fetch_webpage with appropriate query strings
  • Missing: no reference files (security.md, architecture.md, troubleshooting.md) are actually present in the file manifest—only LICENSE is included, which limits local reference capability
  • Missing: the skill mentions 'local quick-reference content' in the introduction but provides only URLs in tables, not actual content for offline reference
  • Missing: no error handling guidance for cases where documentation fetch fails or network is unavailable beyond suggesting tool installation
  • Missing: no example outputs or expected agent workflows described—unclear what 'done' looks like after using this skill
  • Missing: no limitations documented regarding which HSM products/versions are covered (though name and description clarify scope well)
  • Category index references line ranges (L32-L37, L38-L44, etc.) but the skill content has no such lines—appears to be a template artifact or documentation error
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-dedicated-hsm in your dev environment

Command Palette

Search for a command to run...