Skip to content

Commit 0450f86

Browse files
committed
add tabs
1 parent cb3e21c commit 0450f86

File tree

1 file changed

+15
-10
lines changed

1 file changed

+15
-10
lines changed

articles/firewall/dns-settings.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: firewall
55
author: vhorne
66
ms.service: firewall
77
ms.topic: how-to
8-
ms.date: 05/14/2024
8+
ms.date: 06/21/2024
99
ms.author: victorh
1010
ms.custom: devx-track-azurepowershell
1111
---
@@ -21,17 +21,19 @@ A DNS server maintains and resolves domain names to IP addresses. By default, Az
2121
> [!NOTE]
2222
> For instances of Azure Firewall that are managed by using Azure Firewall Manager, the DNS settings are configured in the associated Azure Firewall policy.
2323
24-
### Configure custom DNS servers - Azure portal
24+
### Configure custom DNS servers
25+
26+
#### [Portal](#tab/browser)
2527

2628
1. Under Azure Firewall **Settings**, select **DNS Settings**.
2729
2. Under **DNS servers**, you can type or add existing DNS servers that were previously specified in your virtual network.
2830
3. Select **Apply**.
2931

3032
The firewall now directs DNS traffic to the specified DNS servers for name resolution.
3133

32-
:::image type="content" source="media/dns-settings/dns-servers.png" alt-text="Screenshot showing settings for D N S servers.":::
34+
:::image type="content" source="../firewall/media/dns-settings/dns-servers.png" alt-text="Screenshot showing settings for DNS servers.":::
3335

34-
### Configure custom DNS servers - Azure CLI
36+
#### [CLI](#tab/azure-devops-cli)
3537

3638
The following example updates Azure Firewall with custom DNS servers by using the Azure CLI.
3739

@@ -45,7 +47,7 @@ az network firewall update \
4547
> [!IMPORTANT]
4648
> The command `az network firewall` requires the Azure CLI extension `azure-firewall` to be installed. You can install it by using the command `az extension add --name azure-firewall`.
4749
48-
### Configure custom DNS servers - Azure PowerShell
50+
#### [PowerShell](#tab/powershell)
4951

5052
The following example updates Azure Firewall with custom DNS servers by using Azure PowerShell.
5153

@@ -56,14 +58,15 @@ $azFw.DNSServer = $dnsServers
5658
5759
$azFw | Set-AzFirewall
5860
```
61+
---
5962

6063
## DNS proxy
6164

6265
You can configure Azure Firewall to act as a DNS proxy. A DNS proxy is an intermediary for DNS requests from client virtual machines to a DNS server.
6366

6467
If you want to enable FQDN (fully qualified domain name) filtering in network rules, enable DNS proxy and update the virtual machine configuration to use the firewall as a DNS proxy.
6568

66-
:::image type="content" source="media/dns-settings/dns-proxy-2.png" alt-text="D N S proxy configuration using a custom D N S server.":::
69+
:::image type="content" source="media/dns-settings/dns-proxy-2.png" alt-text="D N S proxy configuration using a custom DNS server.":::
6770

6871
If you enable FQDN filtering in network rules, and you don't configure client virtual machines to use the firewall as a DNS proxy, then DNS requests from these clients might travel to a DNS server at a different time or return a different response compared to that of the firewall. It’s recommended to configure client virtual machines to use the Azure Firewall as their DNS proxy. This puts Azure Firewall in the path of the client requests to avoid inconsistency.
6972

@@ -88,7 +91,7 @@ DNS proxy configuration requires three steps:
8891
2. Optionally, configure your custom DNS server or use the provided default.
8992
3. Configure the Azure Firewall private IP address as a custom DNS address in your virtual network DNS server settings. This setting ensures DNS traffic is directed to Azure Firewall.
9093

91-
#### Configure DNS proxy - Azure portal
94+
#### [Portal](#tab/browser)
9295

9396
To configure DNS proxy, you must configure your virtual network DNS servers setting to use the firewall private IP address. Then enable the DNS proxy in the Azure Firewall **DNS settings**.
9497

@@ -109,9 +112,9 @@ To configure DNS proxy, you must configure your virtual network DNS servers sett
109112
4. Review the **DNS servers** configuration to make sure that the settings are appropriate for your environment.
110113
5. Select **Save**.
111114

112-
:::image type="content" source="media/dns-settings/dns-proxy.png" alt-text="Screenshot showing settings for the D N S proxy.":::
115+
:::image type="content" source="../firewall/media/dns-settings/dns-proxy.png" alt-text="Screenshot showing settings for the DNS proxy.":::
113116

114-
#### Configure DNS proxy - Azure CLI
117+
#### [CLI](#tab/azure-devops-cli)
115118

116119
You can use the Azure CLI to configure DNS proxy settings in Azure Firewall. You can also use it to update virtual networks to use Azure Firewall as the DNS server.
117120

@@ -137,7 +140,7 @@ az network firewall update \
137140
--enable-dns-proxy true
138141
```
139142

140-
#### Configure DNS proxy - Azure PowerShell
143+
#### [PowerShell](#tab/powershell)
141144

142145
You can use Azure PowerShell to configure DNS proxy settings in Azure Firewall. You can also use it to update virtual networks to use Azure Firewall as the DNS server.
143146

@@ -163,6 +166,8 @@ $azFw.DNSEnableProxy = $true
163166
164167
$azFw | Set-AzFirewall
165168
```
169+
---
170+
166171
### High availability failover
167172

168173
DNS proxy has a failover mechanism that stops using a detected unhealthy server and uses another DNS server that is available.

0 commit comments

Comments
 (0)