Skip to content

Commit afad62c

Browse files
authored
Merge pull request #104192 from sumeetmittal/patch-42
Update the Service page with additional info
2 parents 3258482 + df707d8 commit afad62c

File tree

1 file changed

+17
-2
lines changed

1 file changed

+17
-2
lines changed

articles/private-link/private-link-service-overview.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ A Private Link service specifies the following properties:
5050
|Load Balancer Frontend IP Configuration (loadBalancerFrontendIpConfigurations) | Private Link service is tied to the frontend IP address of a Standard Load Balancer. All traffic destined for the service will reach the frontend of the SLB. You can configure SLB rules to direct this traffic to appropriate backend pools where your applications are running. Load balancer frontend IP configurations are different than NAT IP configurations. |
5151
|NAT IP Configuration (ipConfigurations) | This property refers to the NAT (Network Address Translation) IP configuration for the Private Link service. The NAT IP can be chosen from any subnet in a service provider's virtual network. Private Link service performs destination side NAT-ing on the Private Link traffic. This ensures that there is no IP conflict between source (consumer side) and destination (service provider) address space. On the destination side (service provider side), the NAT IP address will show up as Source IP for all packets received by your service and destination IP for all packets sent by your service. |
5252
|Private endpoint connections (privateEndpointConnections) | This property lists the private endpoints connecting to Private Link service. Multiple private endpoints can connect to the same Private Link service and the service provider can control the state for individual private endpoints. |
53+
|TCP Proxy V2 (EnableProxyProtocol) | This property lets the service provider use tcp proxy v2 to retrieve connection information about the service consumer. Service Provider is responsible for setting up receiver configs to be able to parse the proxy protocol v2 header. |
5354
|||
5455

5556

@@ -90,14 +91,28 @@ Consumers having exposure (controlled by visibility setting) to your Private Lin
9091

9192
The action of approving the connections can be automated by using the auto-approval property on the Private Link service. Auto-Approval is an ability for service providers to preapprove a set of subscriptions for automated access to their service. Customers will need to share their subscriptions offline for service providers to add to the auto-approval list. Auto-approval is a subset of the visibility array. Visibility controls the exposure settings whereas auto-approval controls the approval settings for your service. If a customer requests a connection from a subscription in the auto-approval list, the connection is automatically approved and the connection is established. Service providers don’t need to manually approve the request anymore. On the other hand, if a customer requests a connection from a subscription in the visibility array and not in the auto-approval array, the request will reach the service provider but the service provider has to manually approve the connections.
9293

94+
## Getting connection Information using TCP Proxy v2
95+
96+
When using private link service, the source IP address of the packets coming from private endpoint is network address translated (NAT) on the service provider side using the NAT IP allocated from provider's virtual network. Hence the applications receive the allocated NAT IP address instead of actual source IP address of the service consumers. If your application needs actual source IP address from consumer side, you can enable Proxy protocol on your service and retrieve the information from the proxy protocol header. In addition to source IP address, proxy protocol header also carries the LinkID of the private endpoint. Combination of source IP address and LinkID can help service providers uniquely identify their consumers. For more information on Proxy Protocol, visit here.
97+
98+
This information is encoded using a custom Type-Length-Value (TLV) vector as follows:
99+
100+
Custom TLV details:
101+
102+
|Field |Length (Octets) |Description |
103+
|---------|---------|----------|
104+
|Type |1 |PP2_TYPE_AZURE (0xEE)|
105+
|Length |2 |Length of value|
106+
|Value |1 |PP2_SUBTYPE_AZURE_PRIVATEENDPOINT_LINKID (0x01)|
107+
| |4 |UINT32 (4 bytes) representing the LINKID of the private endpoint. Encoded in little endian format.|
108+
109+
93110
## Limitations
94111

95112
The following are the known limitations when using the Private Link service:
96113
- Supported only on Standard Load Balancer
97114
- Supports IPv4 traffic only
98115
- Supports TCP traffic only
99-
- Create and Manage experience from Azure portal is not supported
100-
- Clients connection information using proxy protocol is not available to service provider
101116

102117
## Next steps
103118
- [Create a private link service using Azure PowerShell](create-private-link-service-powershell.md)

0 commit comments

Comments
 (0)