Skip to main content
skill CX Codex

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

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

What 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-code

2Manually: put the files in place

~/.claude/skills/azure-private-link/SKILL.md

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

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →
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 configuring-vpc-endpoints-for-private-aws-service-access aws configuring-vpc-endpoints-for-private-aws-service-access is a Claude Code skill for configuring private access to AWS services through VPC endpoints. It activates for endpoint setup and connectivity troubleshooting. CX Codex +1 7,200installs 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-local Microsoft This skill guides Azure Local planning, deployment, operations, and troubleshooting across Arc, VMs, AKS on Azure Local, SDN, and lifecycle updates. 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 private-connectivity grafana private-connectivity — a skill for Claude Code, Cursor, Codex and other agents that wires Grafana Cloud traffic through AWS PrivateLink, Azure Private Link, or GCP Private Service Connect. CX Codex +1 4,500installs

From the same set144

The whole set →
azure-files Brings expert knowledge on Azure Files development. Covers best practices, architecture, limits, security, cloud tiering, NFS/SMB shares, FSLogix profiles, and RAG integrations. CX Codex +1 206installs azure-cloud-adoption-framework The skill gives the agent indexed references and URLs to Azure Cloud Adoption Framework documentation: strategy, landing zones, governance, security, migration, and SAP/Oracle/AVD adoption scenarios. CX Codex +1 204installs microsoft-foundry-tools microsoft-foundry-tools is a Claude Code skill with expert guidance on Azure AI services, covering architecture, security, quotas, and REST/.NET API integration. CX Codex +1 200installs azure-defender-for-cloud A skill for Claude Code, Codex, Cursor, and other platforms that brings expert guidance on Azure Defender for Cloud. CX Codex +1 200installs azure-table-storage Provides architecture guides, partition key patterns, and RBAC rules for Azure Table Storage development. Useful when designing schemas or scripting PowerShell tasks. CX Codex +1 198installs azure-active-directory-b2c Guides Azure Active Directory B2C setup, custom policies, social identity providers, and CI/CD pipelines. Fetches relevant Microsoft documentation during agent sessions. CX Codex +1 196installs azure-event-grid Get guidance on Azure Event Grid errors, design choices, security, and integrations. Use the skill when working on topics, MQTT brokers, webhook handlers, or related event flows. CX Codex +1 196installs azure-database-mysql azure-database-mysql — a skill for Claude Code supports Azure Database for MySQL development. It activates for Flexible Server design, migrations, configuration, and troubleshooting. CX Codex +1 195installs

Project sponsors

Companies that keep this analytics open