Configure Private Link for Azure Health Data Services

Private Link enables you to access Azure Health Data Services over a private endpoint. Private Link is a network interface that connects you privately and securely using a private IP address from your virtual network. With Private Link, you can access our services securely from your virtual network as a first party service without having to go through a public Domain Name System (DNS). This article describes how to create, test, and manage your Private Endpoint for Azure Health Data Services.

Note

Neither Private Link nor Azure Health Data Services can be moved from one resource group or subscription to another once Private Link is enabled. To make a move, delete the Private Link first, and then move Azure Health Data Services. Create a new Private Link after the move is complete. Next, assess potential security ramifications before deleting the Private Link.

If you're exporting audit logs and metrics that are enabled, update the export setting through Diagnostic Settings from the portal.

Prerequisites

Before you create a private endpoint, the following Azure resources must be created first:

  • Resource Group – The Azure resource group that contains the virtual network and private endpoint.
  • Workspace – The logical container for FHIR® and DICOM® service instances.
  • Virtual Network – The virtual network to which your client services and private endpoint is connected.

For more information, see Private Link Documentation.

Create private endpoint

To create a private endpoint, a user with Role-based access control (RBAC) permissions on the workspace or the resource group where the workspace is located can use the Azure portal. Using the Azure portal is recommended as it automates the creation and configuration of the Private DNS Zone. For more information, see Private Link Quick Start Guides.

Private link is configured at the workspace level, and is automatically configured for all FHIR and DICOM services within the workspace.

There are two ways to create a private endpoint. Auto Approval flow allows a user that has RBAC permissions on the workspace to create a private endpoint without a need for approval. Manual Approval flow allows a user without permissions on the workspace to request that owners of the workspace or resource group approve the private endpoint.

Note

When an approved private endpoint is created for Azure Health Data Services, public traffic to it is automatically disabled.

Auto approval

Ensure the region for the new private endpoint is the same as the region for your virtual network. The region for the workspace can be different.

Screenshot showing image of the Azure portal Basics Tab.

For the resource type, search and select Microsoft.HealthcareApis/workspaces from the drop-down list. For the resource, select the workspace in the resource group. The target subresource, healthcareworkspace, is automatically populated.

Screenshot showing image of the Azure portal Resource tab.

Manual approval

For manual approval, select the second option under Resource, Connect to an Azure resource by resource ID or alias. For the resource ID, enter subscriptions/{subcriptionid}/resourceGroups/{resourcegroupname}/providers/Microsoft.HealthcareApis/workspaces/{workspacename}. For the Target subresource, enter healthcareworkspace as in Auto Approval.

Screen image of the Manual Approval Resources tab.

After the deployment is complete, select the Private Link resource in the resource group. Open DNS configuration from the settings menu. You can find the DNS records and private IP addresses for the workspace, and FHIR and DICOM services.

Screenshot showing image of the Azure portal DNS Configuration.

After the deployment is complete, browse to the new resource group that is created as part of the deployment. You should see two private DNS zone records and one for each service. If you have more FHIR and DICOM services in the workspace, more DNS zone records are created for them.

Screenshot showing image of Private Link FHIR Mapping.

Select Virtual network links from the Settings. Notice that the FHIR service is linked to the virtual network.

Screenshot showing image of Private Link virtual network Link FHIR.

Similarly, you can see the private link mapping for the DICOM service.

Screenshot showing image of Private Link DICOM Mapping.

Also, you can see the DICOM service is linked to the virtual network.

Screenshot showing image of Private Link virtual network Link DICOM.

Test private endpoint

To verify that your service isn’t receiving public traffic after disabling public network access, select the /metadata endpoint for your FHIR service, or the /health/check endpoint of the DICOM service, and you'll receive the message 403 Forbidden.

It can take up to 5 minutes after updating the public network access flag before public traffic is blocked.

Important

Every time a new service gets added into the Private Link enabled workspace, wait for the provisioning to complete. Refresh the private endpoint if DNS A records are not getting updated for the newly added service(s) in the workspace. If DNS A records are not updated in your private DNS zone, requests to a newly added service(s) will not go over Private Link.

To ensure your Private Endpoint can send traffic to your server:

  1. Create a virtual machine (VM) that is connected to the virtual network and subnet your Private Endpoint is configured on. To ensure your traffic from the VM is only using the private network, disable the outbound internet traffic using the network security group (NSG) rule.
  2. Remote Desktop Protocols (RDP) into the VM.
  3. Access your FHIR server’s /metadata endpoint from the VM. You should receive the capability statement as a response.

Note

FHIR® is a registered trademark of HL7 and is used with the permission of HL7.

DICOM® is the registered trademark of the National Electrical Manufacturers Association for its Standards publications relating to digital communications of medical information.