Configuring DNS settings within identity providers (IdPs) has been deprecated in AppGate ZTNA systems. This section describes how to migrate these settings using auto-configuration or manually, and how to confirm your DNS settings are working after migration.
These steps assume you already have the necessary entitlements in place.
Migrating using auto-configuration
Users with one IdP and DNS configuration can migrate their settings to their Site configuration. To migrate your settings:
Go to Sites (System > Sites).
Select the Site that the DNS server is on, which would be the Site that the existing entitlement is using.
In the DNS Resolving section, add the settings from your IdP to the fields provided:
Click +Add under DNS Servers to add the address of your server.
Select Enable auto-configuration and click +Add next to Match Domains.
NOTE
If you previously used search domains instead of match domains, you do not have to move them over unless you want to use your DNS server for a specific domain. Search domains are a Windows-specific legacy feature to support short domain resolution.To migrate using a search domain, contact AppGate Support.
Add the domain of your server to the Domain field. If you have multiple match domains, use the copy-paste function to copy them from the IdP and paste them here. If you want to use your DNS server for every domain, enter
defaultin this field.Click Save.
Return to your IdP and select it to edit the settings.
Remove the DNS settings and click Save.
Validating the migration using auto-configuration
If you used auto-configuration to migrate your DNS settings, confirm they are working by completing the following steps:
Wait for clients to connect to the system.
Go to Active Sessions (Usage > Active Sessions).
Select your session.
In the Active Session Details page, the automatic entitlement for the DNS resolver appears in the Entitlements tab.
Follow the steps in Validating the manual DNS policy migration.
Once this is complete, you no longer need the entitlement to the DNS server or the access policy for that entitlement.
NOTE
For these settings to take effect, users must obtain new entitlement tokens. Go to Active Sessions (Usage > Active Sessions) or Registered Devices (Usage > Registered Devices) and select Renew Tokens.
Migrating DNS settings manually with a DNS policy
Several situations make auto-configuration a poor fit for migrating DNS settings. For example:
If you have multiple IdPs with different DNS configurations, create a DNS policy for each IdP and remove the DNS settings from the IdPs.
If you have a single IdP or multiple IdPs with the same DNS configuration, but you have DNS policies already. For instance, one that allows one user or group of users access to a resource, and a second policy for a different group of users to a different resource. If the existing DNS policies already cover all your users, then you do not need to alter the DNS settings in the policies. If you have DNS policies that cover only some of your users, with IdP settings for the remainder. In that case you will need to create a new policy to cover that remainder.
If you have a single IdP or multiple IdPs with the same DNS configuration, and Block local DNS requests enabled in the IdP, create DNS policies with those settings and select Block local DNS requests in the policy instead.
To configure DNS settings in a policy:
Go to Policies (Access > Policies).
Create a new DNS policy or select one to edit.
In the Edit Policy page, go to DNS Settings.
Add the entitlement that allows traffic to the DNS server (same as for IDP DNS).
Select +Add next to DNS Configurations to add your match domains and DNS servers. Enter
defaultin the Match Domain field if you want to use your DNS server for every domain.
NOTE
If you previously used search domains instead of match domains, you do not have to move them over unless you want to use your DNS server for a specific domain. Search domains are a Windows-specific legacy feature to support short domain resolution.To migrate using a search domain, contact AppGate Support.
Optionally, check the Block local DNS requests checkbox.
Complete any other configuration fields and click Save.
Validating the manual DNS policy migration
To confirm the DNS settings migration was successful:
Wait for clients to connect to the system.
If you are using the built-in LogServer OpenSearch dashboard, navigate to Audit Logs (Usage > Audit Logs).
In your OpenSearch dashboard, select Open from the top menu and select Controller Audit logs.
In the event_type column, look for items with the “authorization_succeeded” event type.
Select a result with that event type. In the Field column, scroll to find “dns_settings.domain” and “dns_settings.servers” and confirm that the domain and servers originate from your DNS policies.
If dns_settings.domain and dns_settings.servers are empty, the migration was unsuccessful. If some users have content in those fields but other users do not, the migration was also unsuccessful.
NOTE
Some users may not have access to Audit Logs if they lack privileges for the built-in LogServer OpenSearch dashboard or are using their own SIEM through the LogForwarder.
When you have confirmed that your migration is successful:
Go to Identity Providers (Identity > Identity Providers).
Remove the DNS settings from the IdPs from which they were migrated and click Save.