Skip to main content
skill CX Codex

azure-payment-hsm — Claude Code skill: setup and install

azure-payment-hsm is a Claude Code skill for configuring Azure Payment HSM and diagnosing deployment issues. It activates for work on VNets, FastPath, payShield Manager, traffic routing, or HA/DR design.

CC-BY-4.0 161 installs ★ 818 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-payment-hsm -a claude-code
Open on GitHub

What azure-payment-hsm does

The skill guides Azure Payment HSM configuration, security, performance SKU choices, architecture, and troubleshooting. Its local index points to documentation on network peering, FastPath, traffic inspection, SSH access, and high-availability and disaster-recovery topologies.

Fetching detailed documentation requires network access. The skill uses mcp_microsoftdocs:microsoft_docs_fetch, with fetch_webpage as a fallback. Its scope is Azure Payment HSM; it does not cover Azure Cloud HSM, Azure Dedicated HSM, Azure Key Vault, or Azure Security.

What it helps with

  • diagnose an Azure Payment HSM deployment failure
  • configure peering, FastPath, or traffic routing
  • design a high-availability and disaster-recovery topology
  • choose a performance SKU or configure payShield Manager access

Example prompts for the agent

  • Diagnose this Azure Payment HSM deployment failure and find a fix.
  • Help configure peering and FastPath for Payment HSM.
  • Design a high-availability and disaster-recovery topology for Azure Payment HSM.

How to install azure-payment-hsm

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-payment-hsm -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-payment-hsm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-payment-hsm/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-payment-hsm

How do I install azure-payment-hsm in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-payment-hsm -a claude-code. The skill file is at ~/.claude/skills/azure-payment-hsm/SKILL.md.

What does azure-payment-hsm do?

It provides guidance on Azure Payment HSM configuration, network design, security, performance SKUs, and deployment troubleshooting.

What does azure-payment-hsm need to work?

It needs network access and mcp_microsoftdocs:microsoft_docs_fetch to retrieve documentation. fetch_webpage is the fallback.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-payment-hsm
description: Expert knowledge for Azure Payment Hsm development including troubleshooting, best practices, decision making, architecture & design patterns, security, and configuration. Use when configuring Payment HSM VNets/peering, FastPath, payShield Manager access, SKUs, HA/DR topologies, or traffic routing, and other Azure Payment Hsm related development tasks. Not for Azure Cloud Hsm (use azure-cloud-hsm), Azure Dedicated HSM (use azure-dedicated-hsm), Azure Key Vault (use azure-key-vault), Azure Security (use azure-security).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-09-20"
  generator: "docs2skills/1.0.0"
---
# Azure Payment Hsm Skill

This skill provides expert guidance for Azure Payment Hsm. Covers troubleshooting, best practices, decision making, architecture & design patterns, security, and configuration. 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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 | L34-L38 | Diagnosing and resolving common Azure Payment HSM deployment issues, including provisioning failures, configuration problems, and known platform limitations or workarounds. |
| Best Practices | L39-L43 | Guidance on inspecting, monitoring, and routing network traffic to Azure Payment HSM, including using firewalls, NSGs, and network appliances for secure traffic control. |
| Decision Making | L44-L49 | Guidance on choosing/changing Azure Payment HSM performance SKUs, and understanding support options, roles, and responsibilities for operating the service. |
| Architecture & Design Patterns | L50-L55 | Designing Azure Payment HSM architectures: HA/DR patterns, device lifecycle management, supported topologies, deployment constraints, and planning resilient HSM solutions. |
| Security | L56-L62 | Configuring secure SSH access, understanding Payment HSM compliance/certifications, and applying detailed security controls and best practices for Azure Payment HSM. |
| Configuration | L63-L74 | Configuring Azure Payment HSM networking and access: VNets/peering, FastPath, ARM/CLI deployment, IP layout (split/reused VNets), provider registration, and payShield Manager browser access. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Resolve known issues with Azure Payment HSM deployments | https://learn.microsoft.com/en-us/azure/payment-hsm/known-issues |

### Best Practices
| Topic | URL |
|-------|-----|
| Inspect and route network traffic for Azure Payment HSM | https://learn.microsoft.com/en-us/azure/payment-hsm/inspect-traffic |

### Decision Making
| Topic | URL |
|-------|-----|
| Select and change Azure Payment HSM performance SKUs | https://learn.microsoft.com/en-us/azure/payment-hsm/change-performance-level |
| Use Azure Payment HSM support and understand responsibilities | https://learn.microsoft.com/en-us/azure/payment-hsm/support-guide |

### Architecture & Design Patterns
| Topic | URL |
|-------|-----|
| Design high availability and DR for Azure Payment HSM | https://learn.microsoft.com/en-us/azure/payment-hsm/deployment-scenarios |
| Plan solution topologies and constraints for Payment HSM | https://learn.microsoft.com/en-us/azure/payment-hsm/solution-design |

### Security
| Topic | URL |
|-------|-----|
| Configure SSH access to Azure Payment HSM payShield manager | https://learn.microsoft.com/en-us/azure/payment-hsm/access-payshield-manager-ssh |
| Understand Payment HSM compliance certifications and scope | https://learn.microsoft.com/en-us/azure/payment-hsm/certification-compliance |
| Secure Azure Payment HSM with detailed controls | https://learn.microsoft.com/en-us/azure/payment-hsm/secure-payment-hsm |

### Configuration
| Topic | URL |
|-------|-----|
| Configure browser access to payShield Manager for Payment HSM | https://learn.microsoft.com/en-us/azure/payment-hsm/access-payshield-manager |
| Configure Payment HSM IPs in different VNets via ARM | https://learn.microsoft.com/en-us/azure/payment-hsm/create-different-ip-addresses |
| Configure Azure Payment HSM across separate VNets | https://learn.microsoft.com/en-us/azure/payment-hsm/create-different-vnet |
| Deploy Payment HSM with split VNets via ARM template | https://learn.microsoft.com/en-us/azure/payment-hsm/create-different-vnet-template |
| Configure FastPathEnabled feature flag and tag for Payment HSM | https://learn.microsoft.com/en-us/azure/payment-hsm/fastpathenabled |
| Configure VNet peering and fastpath for Payment HSM | https://learn.microsoft.com/en-us/azure/payment-hsm/peer-vnets |
| Manage Azure Payment HSM resources with Azure CLI | https://learn.microsoft.com/en-us/azure/payment-hsm/quickstart-cli |
| Register Azure Payment HSM resource providers and features | https://learn.microsoft.com/en-us/azure/payment-hsm/register-payment-hsm-resource-providers |
| Reuse existing virtual networks for Azure Payment HSM deployment | https://learn.microsoft.com/en-us/azure/payment-hsm/reuse-vnet |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for Cloud: AWS, Azure, GCP →
azure-security-keyvault-keys-java Microsoft azure-security-keyvault-keys-java — a skill for managing Azure Key Vault keys from Java: RSA and EC creation, encrypt, sign, HSM-backed keys. Useful when the agent writes Azure SDK code. CX Codex +1 ★ 3,232repo stars azure-security-lab-terraform reason-machines azure-security-lab-terraform guides an agent through deploying a Terraform lab in Azure: hub-spoke VNets, Azure Firewall Basic, NSGs and Key Vault. Useful when you want real network controls to practise on without wiring them by hand. CX Codex +1 134installs azure-kubernetes Microsoft Plans and configures Azure Kubernetes Service clusters, covering SKU choice, networking, security, observability, and upgrade planning. CX Codex +1 ★ 3,232repo stars azure-infra-engineer VoltAgent The azure-infra-engineer subagent reviews and changes Azure infrastructure with security, reliability, and rollback in mind. Delegate work on resources, networking, identity, or automation. CX Codex ★ 6,505repo stars payment-pci-security vtex payment-pci-security enforces PCI DSS requirements and Secure Proxy routing when building payment connectors that handle card authorization, token exchange, and post-auth requests. CX Codex +1 1,100installs payment-gateway-integration aj-geddes payment-gateway-integration — a Claude Code skill that wires Stripe, PayPal and Square into backends: payments, subscriptions, webhooks, refunds. Also works in Codex, Cursor, Copilot, Gemini CLI and OpenCode. CX Codex +1 531installs

From the same set144

The whole set →
azure-relay This skill guides Azure Relay setup, error diagnosis, and Hybrid Connections work. It fits projects using .NET or Node.js relay clients. CX Codex +1 162installs azure-dedicated-hsm Hands the agent a working map of Azure Dedicated HSM: cluster sizing, networking, secure configuration and migration, with links into Microsoft Learn. CX Codex +1 162installs azure-osconfig This skill guides Azure OSConfig development, from diagnosing agent and Azure IoT Hub issues to configuring Windows security and Linux devices. CX Codex +1 161installs azure-open-datasets A reference skill for Azure Open Datasets limits: throttling on non-Spark downloads, quota ceilings and retry handling, pulled from Microsoft Learn docs. CX Codex +1 161installs azure-immersive-reader A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that brings Azure AI Immersive Reader expertise to the agent. Covers JS SDK integration, Entra auth setup, read-aloud configuration, and language support. CX Codex +1 161installs azure-import-export This skill guides work on Azure Import/Export jobs, from diagnosing failures to checking service limits and configuring encryption keys. Use it while building or troubleshooting these jobs. CX Codex +1 161installs azure-fluid-relay Adds Azure Fluid Relay guidance to Claude Code: a service for syncing state across clients in real time. Use it when building collaborative apps with JWT auth, deploying to Static Web Apps, or managing Fluid Relay containers. CX Codex +1 160installs azure-external-attack-surface-management Skill with expert knowledge for Azure External Attack Surface Management: inventory filters by ASN, domains, hosts, IPs, pages, SSL certs, and data export to analytics. CX Codex +1 152installs

Project sponsors

Companies that keep this analytics open