Catalog
MicrosoftDocs/azure-payment-hsm

MicrosoftDocs

azure-payment-hsm

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/FastPath, payShield Manager access, HA/DR topologies, SKUs, or traffic inspection, and other Azure Payment Hsm related development tasks. Not for Azure Dedicated HSM (use azure-dedicated-hsm), Azure Cloud Hsm (use azure-cloud-hsm), Azure Key Vault (use azure-key-vault), Azure Information Protection (use azure-information-protection).

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

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

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 Security setup for Payment HSM: configuring SSH/payShield manager access, understanding compliance certifications/scope, and applying hardening and security best practices.
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
Apply security best practices to Azure Payment HSM 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
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

62/100

Grade

C

Adequate

Safety

78

Quality

55

Clarity

72

Completeness

45

Summary

This skill provides expert guidance for Azure Payment HSM development, covering troubleshooting, best practices, architecture & design patterns, security, and configuration. It acts as a structured knowledge gateway that uses network access to fetch Microsoft Learn documentation on demand via `mcp_microsoftdocs` or `fetch_webpage` tools, with a category index directing agents to relevant topics.

Detected Capabilities

network access (fetch_webpage, mcp_microsoftdocs)remote documentation retrievalread_file operations for referenced contentmetadata version checking

Trigger Keywords

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

configure payment hsm networksazure payment hsm troubleshootingpayment hsm high availabilitypayshield manager accesspayment hsm security hardeninghsm vnet peeringpayment hsm sku selection

Risk Signals

INFO

Network access to external endpoints (learn.microsoft.com)

skill description, all URLs
INFO

Requires external tools (mcp_microsoftdocs) for functionality

compatibility section
INFO

Documentation URLs point to Microsoft Learn (trusted domain)

all category sections

Referenced Domains

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

github.comlearn.microsoft.com

Use Cases

  • Configuring Azure Payment HSM virtual networks, FastPath, and VNet peering for deployment
  • Resolving Azure Payment HSM provisioning failures and known platform issues
  • Designing high-availability and disaster recovery topologies for Payment HSM
  • Setting up SSH and payShield Manager access with proper security hardening
  • Selecting appropriate Payment HSM performance SKUs and understanding support responsibilities
  • Implementing network traffic inspection and control using NSGs and firewalls

Quality Notes

  • Strength: Clear categorical organization with line-range references and structured table layout guides agents efficiently to relevant content
  • Strength: Explicit requirement declaration for network access and tool availability with fallback mechanism (mcp_microsoftdocs → fetch_webpage)
  • Strength: Metadata staleness check prevents agents from using outdated guidance
  • Strength: Well-defined scope with explicit out-of-scope references (azure-dedicated-hsm, azure-cloud-hsm, azure-key-vault, azure-information-protection)
  • Weakness: Category index references line ranges (L34-L38, etc.) that are not present in the actual SKILL.md content — the categories section ends at L74 with only URL tables, no detailed content blocks
  • Weakness: No concrete examples, troubleshooting trees, or decision frameworks — purely documentation link aggregation without added agent-facing guidance
  • Weakness: Compatibility section mentions 'local quick-reference content' but none is present; the skill is entirely documentation-reference based
  • Weakness: No error handling guidance for network failures, timeout conditions, or fallback scenarios beyond tool availability
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-payment-hsm in your dev environment

Command Palette

Search for a command to run...