What is a private endpoint - Azure Private Link

In this article

1. Private endpoint properties
2. Private-link resource
3. Network security of private endpoints
4. Access to a private-link resource using approval workflow
5. DNS configuration
6. Limitations
7. Next steps

A private endpoint is a network interface that uses a private IP address from your virtual network. This network interface connects you privately and securely to a service that's powered by Azure Private Link. By enabling a private endpoint, you're bringing the service into your virtual network.

The service could be an Azure service such as:

• Azure Storage
• Azure Cosmos DB
• Azure SQL Database
• Your own service, using Private Link service.

Private endpoint properties

A private endpoint specifies the following properties:

• Pending: The connection was created manually and is pending approval by the private-link resource owner.
• Rejected: The connection was rejected by the private-link resource owner.
• Disconnected: The connection was removed by the private-link resource owner. The private endpoint becomes informative and should be deleted for cleanup.
  |

As you're creating private endpoints, consider the following:

• Private endpoints enable connectivity between the customers from the same:

  • Virtual network
  • Regionally peered virtual networks
  • Globally peered virtual networks
  • On-premises environments that use VPN or Express Route
  • Services that are powered by Private Link

• Network connections can be initiated only by clients that are connecting to the private endpoint. Service providers don't have a routing configuration to create connections into service customers. Connections can be established in a single direction only.

• A read-only network interface is automatically created for the lifecycle of the private endpoint. The interface is assigned a dynamic private IP address from the subnet that maps to the private-link resource. The value of the private IP address remains unchanged for the entire lifecycle of the private endpoint.

• The private endpoint must be deployed in the same region and subscription as the virtual network.

• The private-link resource can be deployed in a different region than the one for the virtual network and private endpoint.

• Multiple private endpoints can be created with the same private-link resource. For a single network using a common DNS server configuration, the recommended practice is to use a single private endpoint for a specified private-link resource. Use this practice to avoid duplicate entries or conflicts in DNS resolution.

• Multiple private endpoints can be created on the same or different subnets within the same virtual network. There are limits to the number of private endpoints you can create in a subscription. For more information, see Azure limits.

• The subscription that contains the private link resource must be registered with the Microsoft network resource provider. The subscription that contains the private endpoint must also be registered with the Microsoft network resource provider. For more information, see Azure Resource Providers.

Private-link resource

A private-link resource is the destination target of a specified private endpoint. The following table lists the available resources that support a private endpoint:

Note

You can create private endpoints only on a General Purpose v2 (GPv2) storage account.

Network security of private endpoints

When you use private endpoints, traffic is secured to a private-link resource. The platform validates network connections, allowing only those that reach the specified private-link resource. To access more subresources within the same Azure service, more private endpoints with corresponding targets are required. In the case of Azure Storage, for instance, you would need separate private endpoints to access the file and blob subresources.

Private endpoints provide a privately accessible IP address for the Azure service, but do not necessarily restrict public network access to it. All other Azure services require additional access controls, however. These controls provide an extra network security layer to your resources, providing protection that helps prevent access to the Azure service associated with the private-link resource.

Private endpoints support network policies. Network policies enable support for Network Security Groups (NSG), User Defined Routes (UDR), and Application Security Groups (ASG). For more information about enabling network policies for a private endpoint, see Manage network policies for private endpoints. To use an ASG with a private endpoint, see Configure an application security group (ASG) with a private endpoint.

Access to a private-link resource using approval workflow

You can connect to a private-link resource by using the following connection approval methods:

• Automatically approve: Use this method when you own or have permissions for the specific private-link resource. The required permissions are based on the private-link resource type in the following format:

Microsoft.<Provider>/<resource_type>/privateEndpointConnectionsApproval/action

• Manually request: Use this method when you don't have the required permissions and want to request access. An approval workflow is initiated. The private endpoint and later private-endpoint connections are created in a Pending state. The private-link resource owner is responsible to approve the connection. After it's approved, the private endpoint is enabled to send traffic normally, as shown in the following approval workflow diagram:

Over a private-endpoint connection, a private-link resource owner can:

• Review all private-endpoint connection details.
• Approve a private-endpoint connection. The corresponding private endpoint is enabled to send traffic to the private-link resource.
• Reject a private-endpoint connection. The corresponding private endpoint is updated to reflect the status.
• Delete a private-endpoint connection in any state. The corresponding private endpoint is updated with a disconnected state to reflect the action. The private-endpoint owner can delete only the resource at this point.

Note

Only private endpoints in an Approved state can send traffic to a specified private-link resource.

Connect by using an alias

An alias is a unique moniker that's generated when a service owner creates a private-link service behind a standard load balancer. Service owners can share this alias offline with consumers of your service.

The consumers can request a connection to a private-link service by using either the resource URI or the alias. To connect by using the alias, create a private endpoint by using the manual connection approval method. To use the manual connection approval method, set the manual request parameter to True during the private-endpoint create flow. For more information, see New-AzPrivateEndpoint and az network private-endpoint create.

Note

This manual request can be auto approved if the consumer's subscription is allow-listed on the provider side. To learn more, go to controlling service access.

DNS configuration

The DNS settings that you use to connect to a private-link resource are important. Existing Azure services might already have a DNS configuration you can use when you're connecting over a public endpoint. To connect to the same service over private endpoint, separate DNS settings, often configured via private DNS zones, are required. Ensure that your DNS settings are correct when you use the fully qualified domain name (FQDN) for the connection. The settings must resolve to the private IP address of the private endpoint.

The network interface associated with the private endpoint contains the information that's required to configure your DNS. The information includes the FQDN and private IP address for a private-link resource.

For complete, detailed information about recommendations to configure DNS for private endpoints, see Private endpoint DNS configuration.

Limitations

The following information lists the known limitations to the use of private endpoints:

Network security group

NSG more considerations

• Outbound traffic denied from a private endpoint isn't a valid scenario, as the service provider can't originate traffic.

• The following services may require all destination ports to be open when using a private endpoint and adding NSG security filters:

  • Azure Cosmos DB - For more information, see Service port ranges.

UDR

Application security group

Next steps

• For more information about private endpoints and Private Link, see What is Azure Private Link?.
• To get started with creating a private endpoint for a web app, see Quickstart: Create a private endpoint by using the Azure portal.