A step-by-step guide to getting started with the DNS Filter Integration with Gradient MSP
To connect and configure the DNSFilter integration, please click to navigate to the following:
Generate Vendor API Keys
- Login to the DNSFilter dashboard and navigate to your account icon > select Account
- Scroll to API Keys
- Select + Create New API Key
- Enter a key Name. This name is not editable after the key is created
- Select an Expiration from the drop down menu
- Select Create
- Copy the API key. This is the only time the key is available, and the Dismiss option will not function until the key is copied
- Select Dismiss to return to the API key dashboard
Note: You may need to contact DNSFilter support to generate an API Token.
Connect DNSFilter
- Login to Gradient.
- Navigate to the Integrations tab.
- Select the DNSFilter integration and click Connect.
- Enter the API Key details retrieved from the previous steps.
- Click Authenticate.
- Once successfully authenticated, accounts and services will be generated, and the integration will be updated to a pending status. You can click the status refresh button or simply refresh your browser if you are unable to proceed to the next step.
Map Accounts and Services
Note: If you need further details on account and service mapping, click here.
-
Map Accounts and Services
- When setting up the integration for the first time, accounts are automatically matched if there's an exact match between your vendor and PSA.
- For accounts not automatically matched:
- Use the filter button beside the account names on the right, or
- Use the search bar on the left to find PSA accounts.
- Drag and drop the PSA accounts from the left to match them with vendor accounts on the right.
-
Proceed to Service Mapping
- Once accounts are mapped, click "Next" to access the Service Mapping step.
- Align services or products from your PSA, displayed on the left, with the corresponding vendor services or SKUs on the right. For ConnectWise PSA users, search by Product ID.
- Ensure at least one account and one service mapping is completed to finish the configuration.
- After mapping the services, click "Next".
-
Finalize Configuration
- Review your service configurations and click "Finish" to complete the setup.
- This will initiate a sync. The "Sync Status" indicator at the top-right will start spinning, showing that a sync is in progress.
- Once the sync is complete, the "Refresh" button will light up pink, indicating the sync is complete. Click that button to see the vendor usage data populated.
- Use the filter or sort options to jump to the connected services and start reviewing and approving usage!