Branch preview: these instructions describe the current setup flow. Provider availability depends on the integrations enabled for your portal. Production verification is pending.
Before you start
In DNSFilter, open Account Settings > Security > API Keys and create a key for a dedicated user with the required read access. Copy the key immediately; it is shown only once.Set up the connection
- In Connect, enter the API key.
- Select Test connection, then Save and continue. For an existing connection, test changed credentials and select Save changes.
- Open Choose data and review Sync roaming clients and Sync blocked threats. Each switch saves immediately. Roaming clients can link to devices by hostname; blocked threats come from query-log records for the last seven days.
- In Import or match companies, link DNSFilter organizations to portal companies. Those mappings determine where sites, clients, policies, and traffic belong.
- Continue to Review and inspect the available data before completing setup.
Troubleshooting
- No organizations or data: confirm API read access and wait for organization discovery.
- A company has no data: check its organization mapping before changing filters.
- No roaming clients or blocked threats: confirm the relevant sync option is enabled and saved. No blocked events in the seven-day window does not prove the integration failed.
- Wrong devices linked: inspect hostnames and the organization-to-company mapping before importing or remapping records.