mcpField
A
azure-dedicated-hsm

azure-dedicated-hsm

github.com/microsoftdocsSecurity796160 installsUpdated 3d ago
Repository

About azure-dedicated-hsm

azure-dedicated-hsm is an Agent skill for teams deploying and operating Azure Dedicated HSM. It brings together local references and fetched documentation on troubleshooting, architecture, security, provisioning, and migration.

Key features

  1. 01Deployment troubleshooting
  2. 02Architecture and high availability
  3. 03Network and security guidance
  4. 04PowerShell and Azure CLI provisioning
  5. 05ExpressRoute IP SKU migration

Use cases

  1. 01Diagnosing HSM deployment issues
  2. 02Planning network and failover topology
  3. 03Provisioning HSM instances
  4. 04Planning migration to successor services

MCP support

The skill can fetch documentation through mcp_microsoftdocs:microsoft_docs_fetch; it also documents a webpage-fetch fallback.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-dedicated-hsm

After installing, type/azure-dedicated-hsmin Claude Code to confirm it loaded.

Details

From the project README

Azure Dedicated HSM Skill

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

CategoryLinesDescription
TroubleshootingL34-L39Diagnosing and fixing common Azure Dedicated HSM issues, including deployment failures, connectivity, configuration, and operational problems during setup and usage.
Decision MakingL40-L44Guidance on Dedicated HSM retirement, choosing successors (Managed/Cloud HSM), and planning/migrating ExpressRoute IPs and HSM workloads to new SKUs or services.
Architecture & Design PatternsL45-L51Guidance on designing Dedicated HSM deployments: sizing and topology, high availability and failover patterns, and secure networking (VNet, subnets, routing, and connectivity).
SecurityL52-L57Physical security controls for Dedicated HSM hardware and best‑practice configuration guidance (networking, access, policies) to securely deploy and operate HSMs.
Integrations & Coding PatternsL58-L65Scripts and step-by-step guidance for provisioning and deploying Azure Dedicated HSM instances using PowerShell and Azure CLI.
DeploymentL66-L69Guidance for migrating the ExpressRoute gateway IP SKU used with Azure Dedicated HSM, including steps, prerequisites, and configuration considerations.
Troubleshooting
TopicURL
Resolve common issues with Azure Dedicated HSMhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/faq
Troubleshoot Azure Dedicated HSM deployments and usagehttps://learn.microsoft.com/en-us/azure/dedicated-hsm/troubleshoot
Decision Making
TopicURL
Plan migration from Azure Dedicated HSM to Managed or Cloud HSMhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/migration-guide
Architecture & Design Patterns
TopicURL
Design deployment architecture for Azure Dedicated HSMhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/deployment-architecture
Design high availability for Azure Dedicated HSMhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/high-availability
Plan networking architecture for Azure Dedicated HSMhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/networking
Security
TopicURL
Understand physical security of Azure Dedicated HSM deviceshttps://learn.microsoft.com/en-us/azure/dedicated-hsm/physical-security
Secure configuration for Azure Dedicated HSMhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/secure-dedicated-hsm
Integrations & Coding Patterns
TopicURL
Create Azure Dedicated HSM using PowerShellhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/quickstart-create-hsm-powershell
Create Azure Dedicated HSM using Azure CLIhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/quickstart-hsm-azure-cli
Deploy Azure Dedicated HSM with Azure CLIhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/tutorial-deploy-hsm-cli
Deploy Azure Dedicated HSM with PowerShellhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/tutorial-deploy-hsm-powershell
Deployment
TopicURL
Migrate Dedicated HSM ExpressRoute gateway IP SKUhttps://learn.microsoft.com/en-us/azure/dedicated-hsm/migration-basic-standard

Comments

Markdown supported