Agent-Skills azure-firewall

Expert knowledge for Azure Firewall development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when choosing Firewall SKUs, designing hub-spoke/forced tunneling, configuring DNAT/SNAT/app rules, TLS inspection, or DNS proxy, and other Azure Firewall related development tasks. Not for Azure Web Application Firewall (use azure-web-application-firewall), Azure Firewall Manager (use azure-firewall-manager), Azure Virtual Network (use azure-virtual-network), Azure Virtual WAN (use azure-virtual-wan).

install
source · Clone the upstream repo
git clone https://github.com/MicrosoftDocs/Agent-Skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/MicrosoftDocs/Agent-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/azure-firewall" ~/.claude/skills/microsoftdocs-agent-skills-azure-firewall && rm -rf "$T"
manifest: skills/azure-firewall/SKILL.md
source content

Azure Firewall Skill

This skill provides expert guidance for Azure Firewall. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,

L35-L120
), use
read_file
with the specified lines. For categories with file links (e.g.,
[security.md](security.md)
), use
read_file
on the linked reference file

IMPORTANT for Agent: If

metadata.generated_at
is more than 3 months old, suggest the user pull the latest version from the repository. If
mcp_microsoftdocs
tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use
    mcp_microsoftdocs:microsoft_docs_fetch
    with query string
    from=learn-agent-skill
    . Returns Markdown.
  • Fallback: Use
    fetch_webpage
    with query string
    from=learn-agent-skill&accept=text/markdown
    . Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L43Diagnosing Azure Firewall issues using known limitations, packet captures, and Sentinel log analysis for malware detection and traffic investigation.
Best PracticesL44-L51Best practices for Azure Firewall DNS proxy/caching, performance tuning, rule optimization with Policy Analytics, and hardening/security configuration guidance.
Decision MakingL52-L60Guidance on choosing Azure Firewall SKUs (Basic/Standard/Premium), comparing features and performance, and planning or changing deployments based on throughput and requirements.
Architecture & Design PatternsL61-L73Designing Azure Firewall network architectures: hub-and-spoke, forced tunneling, load balancer integration, hybrid/AVD/M365 protection, and DNAT for overlapping/private IP networks.
Limits & QuotasL74-L83Azure Firewall capacity limits, SNAT port scaling (multi-IP, NAT Gateway/V2), prescaling ranges, FAQs on quotas/behavior, and configuring TCP session idle timeouts
SecurityL84-L97Azure Firewall security setup: compliance, RBAC/permissions, Azure Policy, TLS inspection and CA chains, threat intel, DNAT, AKS and hybrid network protection, and portal deployment.
ConfigurationL98-L119Configuring Azure Firewall policies, rules (DNAT/SNAT/app), IP Groups, DNS/proxy/FTP, maintenance windows, monitoring/logging, and advanced Premium/PowerShell management.
Integrations & Coding PatternsL120-L124Configuring Azure Firewall to securely access Azure Storage via SFTP, including required rules, network paths, and integration patterns for SFTP traffic.
DeploymentL125-L132How to deploy Azure Firewall (including Premium) with IP Groups using Bicep/ARM/Terraform, and integrate with Azure DDoS Protection, including basic configuration steps

Troubleshooting

TopicURL
Detect and investigate malware using Sentinel with Azure Firewall logshttps://learn.microsoft.com/en-us/azure/firewall/detect-malware-with-sentinel
Diagnose Azure Firewall known issues and limitationshttps://learn.microsoft.com/en-us/azure/firewall/firewall-known-issues
Troubleshoot Azure Firewall using packet capturehttps://learn.microsoft.com/en-us/azure/firewall/packet-capture

Best Practices

TopicURL
Understand Azure Firewall DNS proxy behavior and cachinghttps://learn.microsoft.com/en-us/azure/firewall/dns-details
Optimize Azure Firewall performance with tuning guidelineshttps://learn.microsoft.com/en-us/azure/firewall/firewall-best-practices
Optimize Azure Firewall rules with Policy Analyticshttps://learn.microsoft.com/en-us/azure/firewall/policy-analytics
Apply security best practices to Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/secure-firewall

Decision Making

TopicURL
Choose and change Azure Firewall Standard vs Premium SKUhttps://learn.microsoft.com/en-us/azure/firewall/change-sku
Select the appropriate Azure Firewall SKUhttps://learn.microsoft.com/en-us/azure/firewall/choose-firewall-sku
Deploy Azure Firewall Basic with portal and policyhttps://learn.microsoft.com/en-us/azure/firewall/deploy-firewall-basic-portal-policy
Compare Azure Firewall features across SKUshttps://learn.microsoft.com/en-us/azure/firewall/features-by-sku
Plan Azure Firewall performance and SKU throughputhttps://learn.microsoft.com/en-us/azure/firewall/firewall-performance

Architecture & Design Patterns

TopicURL
Architect multi-hub and spoke routing with Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/firewall-multi-hub-spoke
Design Azure Firewall forced tunneling architectureshttps://learn.microsoft.com/en-us/azure/firewall/forced-tunneling
Integrate Azure Firewall with Standard Load Balancerhttps://learn.microsoft.com/en-us/azure/firewall/integrate-lb
Use Azure Firewall Management NIC for control traffichttps://learn.microsoft.com/en-us/azure/firewall/management-nic
Architect Azure Firewall protection for Azure Virtual Desktophttps://learn.microsoft.com/en-us/azure/firewall/protect-azure-virtual-desktop
Design Azure Firewall protection for Microsoft 365 traffichttps://learn.microsoft.com/en-us/azure/firewall/protect-office-365
Secure hybrid networks with Azure Firewall and policyhttps://learn.microsoft.com/en-us/azure/firewall/tutorial-hybrid-portal-policy
Architect Azure Firewall in hybrid network topologieshttps://learn.microsoft.com/en-us/azure/firewall/tutorial-hybrid-ps
Use private IP DNAT for overlapped Azure networkshttps://learn.microsoft.com/en-us/azure/firewall/tutorial-private-ip-dnat

Limits & Quotas

TopicURL
Azure Firewall multi‑IP deployment limits and quotashttps://learn.microsoft.com/en-us/azure/firewall/deploy-multi-public-ip-powershell
Azure Firewall FAQs on limits and behaviorhttps://learn.microsoft.com/en-us/azure/firewall/firewall-faq
Scale Azure Firewall SNAT ports with NAT Gatewayhttps://learn.microsoft.com/en-us/azure/firewall/integrate-with-nat-gateway
Integrate Azure Firewall with NAT Gateway V2 for SNAT scalinghttps://learn.microsoft.com/en-us/azure/firewall/integrate-with-nat-gateway-v2
Configure Azure Firewall prescaling capacity rangeshttps://learn.microsoft.com/en-us/azure/firewall/prescaling
Manage Azure Firewall TCP session idle timeoutshttps://learn.microsoft.com/en-us/azure/firewall/tcp-session-behavior

Security

TopicURL
Understand Azure Firewall compliance certificationshttps://learn.microsoft.com/en-us/azure/firewall/compliance-certifications
Enforce Azure Firewall security using Azure Policyhttps://learn.microsoft.com/en-us/azure/firewall/firewall-azure-policy
Configure TLS inspection certificates for Firewall Premiumhttps://learn.microsoft.com/en-us/azure/firewall/premium-certificates
Deploy Enterprise CA chain for Azure Firewall Premiumhttps://learn.microsoft.com/en-us/azure/firewall/premium-deploy-certificates-enterprise-ca
Protect AKS clusters using Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/protect-azure-kubernetes-service
Azure Firewall roles, permissions, and required accesshttps://learn.microsoft.com/en-us/azure/firewall/roles-permissions
Configure Azure Firewall threat intelligence filteringhttps://learn.microsoft.com/en-us/azure/firewall/threat-intel
Deploy and configure Azure Firewall in portalhttps://learn.microsoft.com/en-us/azure/firewall/tutorial-firewall-deploy-portal
Configure Azure Firewall DNAT for inbound filteringhttps://learn.microsoft.com/en-us/azure/firewall/tutorial-firewall-dnat
Configure Azure Firewall for hybrid network securityhttps://learn.microsoft.com/en-us/azure/firewall/tutorial-hybrid-portal

Configuration

TopicURL
Create and manage Azure Firewall IP Groupshttps://learn.microsoft.com/en-us/azure/firewall/create-ip-group
Set customer-controlled maintenance windows for Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/customer-controlled-maintenance
Deploy and configure Azure Firewall policy via PowerShellhttps://learn.microsoft.com/en-us/azure/firewall/deploy-ps-policy
Bulk manage Azure Firewall rules with PowerShellhttps://learn.microsoft.com/en-us/azure/firewall/deploy-rules-powershell
Configure and monitor Azure Firewall DNAT ruleshttps://learn.microsoft.com/en-us/azure/firewall/destination-nat-rules
Configure DNS servers and DNS proxy for Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/dns-settings
Use Azure Firewall Policy Draft and Deploymenthttps://learn.microsoft.com/en-us/azure/firewall/draft-deploy
Configure Azure Firewall explicit proxy modehttps://learn.microsoft.com/en-us/azure/firewall/explicit-proxy
Analyze Azure Firewall data using workbookshttps://learn.microsoft.com/en-us/azure/firewall/firewall-workbook
Configure FTP modes and security on Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/ftp-support
Configure and use IP Groups in Azure Firewall ruleshttps://learn.microsoft.com/en-us/azure/firewall/ip-groups
Configure monitoring and logging for Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/monitor-firewall
Use Azure Firewall monitoring data and logs with Azure Monitorhttps://learn.microsoft.com/en-us/azure/firewall/monitor-firewall-reference
Implement Azure Firewall Premium advanced featureshttps://learn.microsoft.com/en-us/azure/firewall/premium-features
Track Azure Firewall rule changes with Resource Graphhttps://learn.microsoft.com/en-us/azure/firewall/rule-set-change-tracking
Configure SNAT private IP ranges in Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/snat-private-range
Configure Azure Firewall application rules with SQL FQDNshttps://learn.microsoft.com/en-us/azure/firewall/sql-fqdn-filtering
Configure Azure Firewall DNAT policy for inbound traffichttps://learn.microsoft.com/en-us/azure/firewall/tutorial-firewall-dnat-policy

Integrations & Coding Patterns

TopicURL
Access Azure Storage via SFTP through Azure Firewallhttps://learn.microsoft.com/en-us/azure/firewall/firewall-sftp

Deployment

TopicURL
Deploy and configure Azure Firewall Premium environmentshttps://learn.microsoft.com/en-us/azure/firewall/premium-deploy
Deploy Azure Firewall and IP Groups using Bicephttps://learn.microsoft.com/en-us/azure/firewall/quick-create-ipgroup-bicep
Deploy Azure Firewall and IP Groups via ARM templatehttps://learn.microsoft.com/en-us/azure/firewall/quick-create-ipgroup-template
Deploy Azure Firewall and IP Groups using Terraformhttps://learn.microsoft.com/en-us/azure/firewall/quick-create-ipgroup-terraform
Deploy Azure Firewall with Azure DDoS Protectionhttps://learn.microsoft.com/en-us/azure/firewall/tutorial-protect-firewall-ddos