Skip to main content

Application deployment using MDM Integrators Without File Addition

General guide

1. Obtain a personal authKey from SafeDNS support in your Personal Account in the form of a String (Base64 encoding is handled on our side). Example format: MGNjYnYyYWItMTQxNy00MjVlqTkzNjEtMDMzY2I2MTU4YzVi.

2. Install the SafeDNS Agent Enterprise application in the Integrator's Personal Account by adding the .ipa file to the application catalog (in the future, we may pass verification and distribute the application through ABM and the app catalog).

3. Then, configure the app settings depending on the integrator's IDE, such as App Config, Managed Configuration (SimpleMDM) or Managed App Configuration (Jamf Pro).

4. Wait for the application to be deployed on the devices. After successful installation, the application will be configured with the authKey that the client (IT admin) added to the App Configuration.

5. Once the initial setup is complete and the device is registered in the SafeDNS Dashboard, create a Custom Configuration Profile in the Integrator's menu. This profile should include our DNSProxy.mobileconfig with the AppBundleIdentifier: com.safedns.agent and ProviderBundleIdentifier: com.safedns.agent.dnsProxy. Then, this profile is deployed to the devices. After the profile is installed, a new DNS Proxy Server section will appear in the smartphone's settings with SafeDNS parameters, initiating the traffic interception, redirection, and filtering module.

The filtering process may take 5-7 minutes to start.


SimpleMDM example

1. Obtain a personal authKey from SafeDNS support in your Personal Account in the form of a String (Base64 encoding is handled on our side). Example format: MGNjYnYyYWItMTQxNy00MjVlqTkzNjEtMDMzY2I2MTU4YzVi.

MDM Integrators Without File Addition guide 1.png

2. Install the SafeDNS Agent Enterprise application in the Integrator's Personal Account by adding the .ipa file to the application catalog (in the future, we may pass verification and distribute the application through ABM and the app catalog).

MDM Integrators Without File Addition guide 2.png

3. Configure the app settings depending on the integrator's IDE, such as App Config, or Managed Configuration.

SimpleMDM example

MDM Integrators Without File Addition guide 3.png

4. Add the authKey from SafeDNS.

MDM Integrators Without File Addition guide 4.png

5. Wait for the application to be deployed on the devices.
After successful installation, the application will be configured with the authKey that the client (IT admin) added to the App Configuration.

MDM Integrators Without File Addition guide 5.png

6. After the application is installed on the devices, complete the full configuration of the app.

Once the initial setup is complete and the device is registered in the SafeDNS Dashboard, create a Custom Configuration Profile in the Integrator's Personal Account. This profile should include DNS-Proxy details mentioned above, or you can simply upload the custom DNSProxy.mobileconfig profile. Depending on the connection speed and profile propagation on the devices, a DNS-Proxy section with our settings will be added to the Device Management and VPN menu in the device settings. After this, the application and filtering module will synchronize, and filtering will begin based on the configuration settings in the SafeDNS.com Personal Account.

The filtering process may take 5-7 minutes to start.