Configure outbound network traffic for Azure HDInsight clusters using Firewall (Preview)

This article provides the steps for you to secure outbound traffic from your HDInsight cluster using Azure Firewall. The steps below assume that you are configuring an Azure Firewall for an existing cluster. If you are deploying a new cluster and behind a firewall, create your HDInsight cluster and subnet first and then follow the steps in this guide.


Azure HDInsight clusters are normally deployed in your own virtual network. The cluster has dependencies on services outside of that virtual network that require network access to function properly.

There are several dependencies that require inbound traffic. The inbound management traffic cannot be sent through a firewall device. The source addresses for this traffic are known and are published here. You can also create Network Security Group (NSG) rules with this information to secure inbound traffic to the clusters.

The HDInsight outbound traffic dependencies are almost entirely defined with FQDNs, which don't have static IP addresses behind them. The lack of static addresses means that Network Security Groups (NSGs) can't be used to lock down the outbound traffic from a cluster. The addresses change often enough that one can't set up rules based on the current name resolution and use that to set up NSG rules.

The solution to securing outbound addresses is to use a firewall device that can control outbound traffic based on domain names. Azure Firewall can restrict outbound HTTP and HTTPS traffic based on the FQDN of the destination or FQDN tags.

Configuring Azure Firewall with HDInsight

A summary of the steps to lock down egress from your existing HDInsight with Azure Firewall are:

  1. Create a firewall.
  2. Add application rules to the firewall
  3. Add network rules to the firewall.
  4. Create a routing table.

Create a new firewall for your cluster

  1. Create a subnet named AzureFirewallSubnet in the virtual network where your cluster exists.
  2. Create a new firewall Test-FW01 using the steps in Tutorial: Deploy and configure Azure Firewall using the Azure portal.

Configure the firewall with application rules

Create an application rule collection that allows the cluster to send and receive important communications.

Select the new firewall Test-FW01 from the Azure portal. Click Rules under Settings > Application rule collection > Add application rule collection.

Title: Add application rule collection

On the Add application rule collection screen, complete the following steps:

  1. Enter a Name, Priority, and click Allow from the Action dropdown menu, and enter the following rules in the FQDN Tags Section :

    Name Source Address FQDN Tag Notes
    Rule_1 * HDInsight and WindowsUpdate Required for HDI services
  2. Add the following rules to the Target FQDNs Section :

    Name Source Address Protocol:Port Target FQDNS Notes
    Rule_2 * https:443 Allows Windows login activity
    Rule_3 * https:443,http:80 <> If your cluster is backed by WASB, then add a rule for WASB. To use ONLY https connections make sure "secure transfer required" is enabled on the storage account.
  3. Click Add.

    Title: Enter application rule collection details

Configure the firewall with network rules

Create the network rules to correctly configure your HDInsight cluster.

  1. Select the new firewall Test-FW01 from the Azure portal.

  2. Click Rules under Settings > Network rule collection > Add network rule collection.

  3. On the Add network rule collection screen, enter a Name, Priority, and click Allow from the Action dropdown menu.

  4. Create the following rules in the IP Addresses section:

    Name Protocol Source Address Destination Address Destination Port Notes
    Rule_1 UDP * * 123 Time service
    Rule_2 Any * DC_IP_Address_1, DC_IP_Address_2 * If you are using Enterprise Security Package (ESP), then add a network rule in the IP Addresses section that allows communication with AAD-DS for ESP clusters. You can find the IP addresses of the domain controllers on the AAD-DS section in the portal
    Rule_3 TCP * IP Address of your Data Lake Storage account * If you are using Azure Data Lake Storage, then you can add a network rule in the IP Addresses section to address an SNI issue with ADLS Gen1 and Gen2. This option will route the traffic to firewall which might result in higher costs for large data loads but the traffic will be logged and auditable in firewall logs. Determine the IP address for your Data Lake Storage account. You can use a powershell command such as [System.Net.DNS]::GetHostAddresses("") to resolve the FQDN to an IP address.
    Rule_4 TCP * * 12000 (Optional) If you are using Log Analytics, then create a network rule in the IP Addresses section to enable communication with your Log Analytics workspace.
  5. Create the following rules in the Service Tags section:

    Name Protocol Source Address Service Tags Destination Port Notes
    Rule_7 TCP * SQL 1433 Configure a network rule in the Service Tags section for SQL that will allow you to log and audit SQL traffic, unless you configured Service Endpoints for SQL Server on the HDInsight subnet which will bypass the firewall.
  6. Click Add to complete creation of your network rule collection.

    Title: Enter application rule collection details

Create and configure a route table

Create a route table with the following entries:

  1. Six addresses from this list of required HDInsight management IP addresses with a next hop of Internet:
    1. Four IP addresses for all clusters in all regions
    2. Two IP addresses that are specific for the region where the cluster is created
  2. One Virtual Appliance route for IP address with the next hop being your Azure Firewall private IP address.

For example, to configure the route table for a cluster created in the US region of "Central US", use following steps:

  1. Sign in to the Azure portal.
  2. Select your Azure firewall Test-FW01. Copy the Private IP address listed on the Overview page. For this example we will use a sample address of
  3. Create a new route table.
  4. Click Routes under Settings.
  5. Click Add to create routes for the IP addresses in the table below.
Route name Address prefix Next hop type Next hop address Internet NA Internet NA Internet NA Internet NA Internet NA Internet NA Virtual appliance

Complete the route table configuration:

  1. Assign the route table you created to your HDInsight subnet by clicking Subnets under Settings and then Associate.
  2. On the Associate subnet screen, select the virtual network that your cluster was created into and the HDInsight Subnet you used for your HDInsight cluster.
  3. Click OK.

Edge-node or custom application traffic

The above steps will allow the cluster to operate without issues. You still need to configure dependencies to accommodate your custom applications running on the edge-nodes, if applicable.

Application dependencies must be identified and added to the Azure Firewall or the route table.

Routes must be created for the application traffic to avoid asymmetric routing issues.

If your applications have other dependencies, they need to be added to your Azure Firewall. Create Application rules to allow HTTP/HTTPS traffic and Network rules for everything else.


Azure Firewall can send logs to a few different storage systems. For instructions on configuring logging for your firewall, follow the steps in Tutorial: Monitor Azure Firewall logs and metrics.

Once you have completed the logging setup, if you are logging data to Log Analytics, you can view blocked traffic with a query such as the following:

AzureDiagnostics | where msg_s contains "Deny" | where TimeGenerated >= ago(1h)

Integrating your Azure Firewall with Azure Monitor logs is useful when first getting an application working when you are not aware of all of the application dependencies. You can learn more about Azure Monitor logs from Analyze log data in Azure Monitor

Access to the cluster

After having the firewall setup successfully, you can use the internal endpoint (https://<clustername> to access the Ambari from within the VNET. To use the public endpoint (https://<clustername> or ssh endpoint (<clustername>, make sure you have the right routes in the route table and NSG rules setup to avoid the assymetric routing issue explained here.

Configure another network virtual appliance


The following information is only required if you wish to configure a network virtual appliance (NVA) other than Azure Firewall.

The previous instructions help you configure Azure Firewall for restricting outbound traffic from your HDInsight cluster. Azure Firewall is automatically configured to allow traffic for many of the common important scenarios. If you want to use another network virtual appliance, you will need to manually configure a number of additional features. Keep the following in mind as your configure your network virtual appliance:

  • Service Endpoint capable services should be configured with service endpoints.
  • IP Address dependencies are for non-HTTP/S traffic (both TCP and UDP traffic).
  • FQDN HTTP/HTTPS endpoints can be placed in your NVA device.
  • Wildcard HTTP/HTTPS endpoints are dependencies that can vary based on a number of qualifiers.
  • Assign the route table that you create to your HDInsight subnet.

Service Endpoint capable dependencies

Azure SQL
Azure Storage
Azure Active Directory

IP Address dependencies

Endpoint Details
*:123 NTP clock check. Traffic is checked at multiple endpoints on port 123
IPs published here These are HDInsight service
AAD-DS private IPs for ESP clusters
*:16800 for KMS Windows Activation
*12000 for Log Analytics

FQDN HTTP/HTTPS dependencies


The list below only gives a few of the most important FQDNs. You can get the full list of FQDNs for configuring your NVA in this file.


Next steps