azure-private-link — Claude Code skill: configure Azure Private Link
Skill for Azure Private Link development with guides on architecture, security, and configuration. Activates when setting up private endpoints, DNS zones, Network Security Perimeters, and Azure Firewall rules.
CC-BY-4.0 199 installs ★ 818 updated 2026-11-09
npx skills add MicrosoftDocs/Agent-Skills --skill azure-private-link -a claude-codeWhat azure-private-link does
Covers best practices, architecture patterns, quotas, and configuration for Azure Private Link. Includes guidance on DNS setup for private endpoints, choosing perimeter access modes, cost optimization, and hybrid network design.
Requires network access to fetch documentation via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage. If the mcp_microsoftdocs tool is unavailable, install it from the MicrosoftDocs/mcp repository. Distinct from other Azure skills by focusing on private channels and security perimeters rather than virtual networks, load balancers, or application gateways.
Part of Microsoft Docs Agent Skills, licensed under CC-BY-4.0.
What it helps with
- configure DNS and name resolution for private endpoints
- design a private link architecture for hybrid networks
- set up RBAC for Network Security Perimeter operations
- inspect and control private endpoint traffic via Azure Firewall
- choose access modes and optimize costs
Example prompts for the agent
- Design a DNS infrastructure for private endpoints using Azure Private Resolver
- What security practices apply when configuring Network Security Perimeters for Private Link
- How to inspect private endpoint traffic and enforce Azure Firewall rules
How to install azure-private-link
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-private-link -a claude-code2Manually: put the files in place
~/.claude/skills/azure-private-link/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-private-link/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-private-link -a codex2Manually: put the files in place
.agents/skills/azure-private-link/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-private-link -a cursor2Manually: put the files in place
.cursor/skills/azure-private-link/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-private-link2Manually: put the files in place
.github/skills/azure-private-link/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-private-link -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-private-linkManually: put the files in place
.devin/skills/azure-private-link/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-private-link -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-private-link
How do I install azure-private-link in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-private-link -a claude-code in your terminal, then check ~/.claude/skills/azure-private-link/SKILL.md.
What does the azure-private-link skill provide?
Expert guidance for Azure Private Link development: DNS best practices, architecture patterns, private endpoint and NSP configuration, RBAC setup, and traffic inspection with Azure Firewall.
Do I need mcp_microsoftdocs to use this skill?
Using mcp_microsoftdocs:microsoft_docs_fetch is recommended for fetching documentation, but the skill falls back to fetch_webpage with accept=text/markdown. Install the MCP server from MicrosoftDocs/mcp if neither is available.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-private-link description: Expert knowledge for Azure Private Link development including best practices, decision making, architecture & design patterns, limits & quotas, security, and configuration. Use when configuring Private Endpoints, DNS zones, NSPs, Azure Firewall rules, or Azure Private Resolver, and other Azure Private Link related development tasks. Not for Azure Virtual Network (use azure-virtual-network), Azure Virtual Network Manager (use azure-virtual-network-manager), Azure Load Balancer (use azure-load-balancer), Azure Application Gateway (use azure-application-gateway). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-11-08" generator: "docs2skills/1.0.0" --- # Azure Private Link Skill This skill provides expert guidance for Azure Private Link. Covers best practices, decision making, architecture & design patterns, limits & quotas, 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 | |----------|-------|-------------| | Best Practices | L34-L38 | DNS design and configuration guidance for private endpoints, including zone setup, name resolution patterns, split-horizon DNS, and avoiding common DNS misconfigurations with Private Link | | Decision Making | L39-L44 | Guidance on choosing perimeter access modes and designing Azure Private Link setups, focusing on security tradeoffs, cost optimization, and migration/transition considerations. | | Architecture & Design Patterns | L45-L49 | Designing DNS architectures for Private Endpoints using Azure Private Resolver, including name resolution patterns, forwarding rules, and integration with on-premises or hybrid networks | | Limits & Quotas | L50-L56 | Limits, quotas, and behaviors for Private Link/Endpoints, including per‑resource availability checks, VNet endpoint scaling, and common limit-related FAQs. | | Security | L57-L64 | RBAC setup for Private Link and Network Security Perimeters, security best practices, and inspecting/controlling Private Endpoint traffic with Azure Firewall. | | Configuration | L65-L85 | Configuring Azure Private Link, endpoints, DNS, NSPs, policies, monitoring, and IPv4/IPv6 connectivity using portal, CLI, PowerShell, and Terraform. | ### Best Practices | Topic | URL | |-------|-----| | Apply DNS integration best practices for Azure Private Endpoints | https://learn.microsoft.com/en-us/azure/private-link/private-endpoint-dns-integration | ### Decision Making | Topic | URL | |-------|-----| | Choose and transition Azure network security perimeter access modes | https://learn.microsoft.com/en-us/azure/private-link/network-security-perimeter-transition | | Optimize Azure Private Link design for cost and security | https://learn.microsoft.com/en-us/azure/private-link/private-link-cost-optimization | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Design DNS infrastructure for Private Endpoints with Azure Private Resolver | https://learn.microsoft.com/en-us/azure/private-link/tutorial-dns-on-premises-private-resolver | ### Limits & Quotas | Topic | URL | |-------|-----| | Check Azure Private Link service availability by resource | https://learn.microsoft.com/en-us/azure/private-link/availability | | Increase Azure Private Endpoint virtual network limits | https://learn.microsoft.com/en-us/azure/private-link/increase-private-endpoint-vnet-limits | | Azure Private Link limits, behaviors, and FAQs | https://learn.microsoft.com/en-us/azure/private-link/private-link-faq | ### Security | Topic | URL | |-------|-----| | Configure RBAC permissions for Azure Network Security Perimeter operations | https://learn.microsoft.com/en-us/azure/private-link/network-security-perimeter-role-based-access-control-requirements | | Configure RBAC permissions for Azure Private Link | https://learn.microsoft.com/en-us/azure/private-link/rbac-permissions | | Apply security best practices to Azure Private Link | https://learn.microsoft.com/en-us/azure/private-link/secure-private-link | | Inspect and control Private Endpoint traffic using Azure Firewall | https://learn.microsoft.com/en-us/azure/private-link/tutorial-inspect-traffic-azure-firewall | ### Configuration | Topic | URL | |-------|-----| | Configure service tag access in Azure Network Security Perimeter | https://learn.microsoft.com/en-us/azure/private-link/configure-network-security-perimeter-service-tag | | Configure cross-perimeter links for Azure NSPs | https://learn.microsoft.com/en-us/azure/private-link/configure-perimeter-link | | Configure Azure Private Link service Direct Connect | https://learn.microsoft.com/en-us/azure/private-link/configure-private-link-service-direct-connect | | Configure standard service endpoints using Azure CLI | https://learn.microsoft.com/en-us/azure/private-link/configure-service-endpoint-standard-cli | | Configure standard service endpoints in Azure portal | https://learn.microsoft.com/en-us/azure/private-link/configure-service-endpoint-standard-portal | | Configure standard service endpoints with PowerShell | https://learn.microsoft.com/en-us/azure/private-link/configure-service-endpoint-standard-powershell | | Configure Azure Private Link service endpoint with Terraform | https://learn.microsoft.com/en-us/azure/private-link/configure-service-endpoint-standard-terraform | | Create and manage network security perimeters with Azure CLI | https://learn.microsoft.com/en-us/azure/private-link/create-network-security-perimeter-cli | | Create and manage a network security perimeter in portal | https://learn.microsoft.com/en-us/azure/private-link/create-network-security-perimeter-portal | | Configure subnet network policies for private endpoints | https://learn.microsoft.com/en-us/azure/private-link/disable-private-endpoint-network-policy | | Configure privateLinkServiceNetworkPolicies for Private Link | https://learn.microsoft.com/en-us/azure/private-link/disable-private-link-service-network-policy | | Configure and manage Azure Private Endpoint properties | https://learn.microsoft.com/en-us/azure/private-link/manage-private-endpoint | | Reference for Azure Private Link monitoring data | https://learn.microsoft.com/en-us/azure/private-link/monitor-private-link-reference | | Enable and store Network Security Perimeter diagnostic logs | https://learn.microsoft.com/en-us/azure/private-link/network-security-perimeter-diagnostic-logs | | Configure and use Azure Network Security Perimeter metrics | https://learn.microsoft.com/en-us/azure/private-link/network-security-perimeter-metrics | | Configure DNS zones for Azure Private Endpoints | https://learn.microsoft.com/en-us/azure/private-link/private-endpoint-dns | | Configure SNAT bypass tags for Private Endpoint traffic via NVA | https://learn.microsoft.com/en-us/azure/private-link/private-link-disable-snat | | Configure Azure Private Link over IPv6 connectivity | https://learn.microsoft.com/en-us/azure/private-link/private-link-ipv6 |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills