This article explains how to configure DNS Proxy with the honour-pbf option to intelligently steer DNS queries based on SD-WAN policy decisions.
This is useful when DNS queries for:
need to follow the same SD-WAN path selection logic used for application traffic.
The goal is to ensure DNS queries are forwarded over the optimal path determined by SD-WAN policy (PBF), rather than being statically tied to a single SNAT egress path.
Overview
A DNS Proxy profile provides split DNS functionality.
Typically, DNS Proxy is configured to:
By default, the path used to send the DNS query is determined by the SNAT pool associated with the DNS Proxy resolver.
Default Behavior
If the SNAT pool is associated with a specific WAN interface (for example, LBO1), DNS queries can only be sent through that interface.
This means:
What honour-pbf Does
When honour-pbf is enabled in the DNS Proxy policy, the DNS Proxy performs an SD-WAN policy lookup before forwarding the DNS query.
This allows the DNS query to follow the same Policy-Based Forwarding (PBF) logic as application traffic.
Result
DNS Proxy can now:
This ensures DNS queries for SaaS applications (such as Office365, Salesforce, Dropbox) are sent over the same preferred path that application traffic will later use.
Why This Matters
In traditional DNS steering, the DNS query and the application session are handled independently.
This can create sub-optimal traffic behavior.
Example Problem
For Salesforce traffic:
This can result in:
Strict DNS Path Affinity
To solve this, enable Strict DNS Path Affinity.
Strict DNS Path Affinity ensures that:
How It Works
When enabled, Versa creates cache entries that bind:
Subsequent application sessions are then pinned to the same path.
This ensures:
Use Case
DNS Proxy with honour-pbf enabled should:

Traffic Steering Requirements
Office365 and Salesforce
Dropbox

Configuration
Step 1: Enable Application Detection and Application Steering
Enable:
Under Session Pinning, enable:
This enables Strict DNS Path Affinity.
What This Does
Versa creates Client Route Cache (CRC) entries to preserve DNS-to-application path affinity.
Example:
Subsequent HTTP/HTTPS sessions matching the CRC entry will use the same path.

Benefit
This ensures:
are sent over the same WAN path.
Note
CRC entries are created only when DNS Proxy is configured with honour-pbf.
Step 2: Create SNAT Pool
Navigate to:
Configurations → Object & Connectors → Objects → SNAT Pool
Create an SNAT pool for DNS Proxy.
CLI Configuration
set orgs org-services Customer2 objects snat dns-proxy-pool egress-networks [ CUST2 ]
set orgs org-services Customer2 objects snat dns-proxy-pool routing-instance Customer2-LAN-VR

Step 3: Create DNS Proxy Profile
Navigate to:
Configurations → Networking → DNS → Proxy Profiles

Create a DNS Proxy Profile with:
This ensures DNS resolution remains available regardless of path selection.


CLI Configuration
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external mode fail-over
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver dns-profile-external mode round-robin
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver dns-profile-external servers external address 8.8.8.8
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver dns-profile-external servers external port 53
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver dns-profile-external servers external monitor true
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver dns-profile-external snat-pool dns-proxy-pool
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver ExternalViaHUB site-name CUST2-HUB1
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver ExternalViaHUB mode fail-over
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver ExternalViaHUB servers externalviaHUB address 8.8.8.8
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver ExternalViaHUB servers externalviaHUB port 53
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver ExternalViaHUB servers externalviaHUB monitor true
set orgs org-services Customer2 dns-proxy proxy-profiles dns-profile-external resolver ExternalViaHUB snat-pool dns-proxy-pool
Step 4: Create DNS Proxy Redirection Policy
Navigate to:
Configurations → Networking → DNS → Policies
Configure a redirection policy to:


Matching Criteria
Leave DNS Headers Match as default to match all DNS queries, or specify selective domains for redirection.
Important
Enable:
This is mandatory for DNS Proxy to consult SD-WAN policy before forwarding DNS traffic.
CLI Configuration
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External match dns-header-matches opcode query qtype-domain-match match1 domain-name .*.office.com
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External match dns-header-matches opcode query qtype-domain-match match2 domain-name .*.salesforce.com
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External match dns-header-matches opcode query qtype-domain-match match3 domain-name .*.dropbox.com
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External match source user user-type any
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External match source zones [ Intf-CUST2-Zone ]
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External set action proxy profile dns-profile-external
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External set action proxy honour-pbf true
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External set lef profile-default false
set orgs org-services Customer2 dns-proxy redirection-policy Default-Policy rules Rule-External set lef profile Default-Logging-Profile
Step 5: Create SD-WAN Policy
Create SD-WAN policy rules that define application-aware PBF behavior for:
These SD-WAN rules determine which path DNS queries and application traffic should use.
Example Behavior
Note
These DNS Proxy configurations also apply to SaaS DIA optimization over LBO and CBO.
Verification
DNS Proxy Profile Status
admin@CUST2-BRANCH1-cli> show orgs org-services Customer2 dns-proxy profile-monitor proxy-profile dns-profile-external
PROFILE NAME RESOLVER NAME SERVER NAME STATUS
--------------------------------------------------------------------
dns-profile-external dns-profile-external external UP
ExternalViaHUB externalviaHUB UP
DNS Proxy Statistics
admin@CUST2-BRANCH1-cli> show orgs org-services Customer2 dns-proxy statistics proxy-profiles dns-profile-external
FAILED
SESS FAILED FAILED
NO FAILED SESS SESS TOTAL TOTAL TOTAL TOTAL
SUCCESSFUL FAILED DEST SESS NO SERVER PKT BYTES PKT BYTES
PROFILE NAME SESS SESS SERVER NO MEM SNAT FAIL SENT SENT RCVD RCVD
------------------------------------------------------------------------------------------------------
dns-profile-external 22111 0 0 0 0 0 0 0 0 0
DNS Redirection Policy Statistics
admin@CUST2-BRANCH1-cli> show orgs org-services Customer2 dns-proxy statistics redirection-policy Default-Policy rules Rule-External
TCP UDP
HIT HIT HIT PBF CACHE
RULE NAME COUNT COUNT COUNT HONOURED HIT
-----------------------------------------------------
Rule-External 22390 0 22390 17905 0
Interpretation
Operational Verification
Domain Application Cache (DAC)
DAC entries bind:
This is used to map DNS domains to applications.

Application Route Cache (ARC)
ARC entries bind:
This allows Versa to classify subsequent traffic correctly.



Client Route Cache (CRC)
CRC entries bind:
CRC is created because Domain App Cache session pinning is enabled.
This ensures:
remain identical.

Note
Office365 and Salesforce sessions should follow the same path indicated in CRC.
Traffic Flow Validation
Office365 and Salesforce
Expected result:
This confirms:


Dropbox
Expected result:
This confirms Dropbox traffic follows SD-WAN policy preference.
Note
CRC entries should reflect the same path used by Dropbox sessions.
![]()

Key Takeaways
Best Practices
Summary
Enabling DNS Proxy with honour-pbf integrates DNS resolution with SD-WAN path selection logic.
This ensures:
This is the recommended approach for SaaS-aware DNS steering in Versa SD-WAN.