Dex
DNSFilter logo
Security & Backup

DNSFilter

Run protective DNS from chat - review and change filtering policies, allow/block lists, sites, and roaming clients, with every change held for approval.

Dex connects to DNSFilter, the protective-DNS service, so admins can run web filtering conversationally - review and edit filtering policies, category and application blocks, explicit allow/block lists, sites (networks), roaming clients, collections, block pages, and scheduled policies, and read traffic reports and the DNS query log to confirm whether a domain was blocked, when, and for whom. Employees can ask why a website is blocked and get an answer based on the actual filtering policy instead of filing a ticket. DNSFilter is an MSP global app: one shared API token covers the whole account, and each Dex tenant is confined to its own DNSFilter Organization by organization_id, so an MSP can serve every client from a single connection without crossover.

What Dex does with DNSFilter

Dex handles both admin workflows and employee self-service — all policy-guardrailed and audit-logged.

A

For admins (Dex Pro)

  • List and read filtering policies - blocked categories, allow/block lists, SafeSearch and YouTube posture, and unknown-domain handling
  • Add or remove single domains on a policy allowlist or blocklist, one entry at a time with an audit note
  • Block or unblock content categories and applications on a policy
  • Create, update, and delete policies, and put a policy into temporary permissive mode
  • Manage sites (networks) and their site IPs, roaming clients, collections and their precedence, and block pages
  • Create and manage scheduled (time-of-day) policies
  • Look up how DNSFilter classifies a domain, and read traffic reports and the DNS query log
  • Manage the organization profile, agent settings, and dashboard users
  • Deploy as an MSP global app - one shared API token, each customer confined to its DNSFilter Organization by organization_id
E

For employees (self-service)

  • Ask why a website is blocked and get the specific policy and category that filters it
  • Have Dex classify the domain you are asking about (category and application)
  • Confirm from the query log whether your request was actually blocked and when
  • Request that a domain be allowlisted - held for approval, or handed to IT as a complete ticket

Just ask Dex

Your team types a request in plain language. Dex investigates, plans, and executes — with the right guardrails.

Admin prompts

  • >Why is poker.com blocked, and which policy blocks it?
  • >Allowlist shop.example.com on the Staff policy with a note that IT approved it
  • >Block the Social Media category on the Contractors policy
  • >Which sites are unprotected or have no policy assigned?
  • >Show me the top blocked domains for this organization over the last week

Employee prompts

  • >Why can't I get to this website?
  • >Is this site blocked by our filtering, or is it just down?
  • >Can you allowlist this site for me? Here is the business reason.

Policy actions

Every action Dex can take on DNSFilter is declared, scoped, and guardrailed. Admins control which apply, who approves them, and whether they're limited to self-service.

ActionWhat it does
dnsfilter_list_policiesList the organization's DNS filtering policies
dnsfilter_read_policyRead one filtering policy, including its allow/block lists and blocked categories
dnsfilter_list_networksList the organization's sites (networks) and the policy each one uses
dnsfilter_list_roaming_clientsList installed roaming clients (agents) and their protection state
dnsfilter_list_collectionsList collections (user/device groups) and their policy precedence
dnsfilter_view_reportsRead traffic reports and the DNS query log to confirm whether a domain was blocked, when, and for whom
dnsfilter_lookup_domainLook up how DNSFilter classifies a domain (categories and applications)
dnsfilter_allow_domainAdd a single domain to a policy allowlist - affects every user assigned to that policy
dnsfilter_block_domainAdd a single domain to a policy blocklist
dnsfilter_remove_allowlist_domainRemove a domain from a policy allowlist
dnsfilter_remove_blocklist_domainRemove a domain from a policy blocklist - re-allows a previously blocked domain
dnsfilter_manage_policy_categoriesBlock a content category on a policy - org-wide filtering change
dnsfilter_remove_policy_categoryUnblock a content category on a policy - org-wide filtering change
dnsfilter_manage_policy_applicationsBlock an application on a policy - org-wide filtering change
dnsfilter_unblock_policy_applicationUnblock an application on a policy - org-wide filtering change
dnsfilter_allow_policy_applicationExplicitly allow an application on a policy - org-wide filtering change
dnsfilter_remove_allowed_applicationRemove an application from a policy allow list - org-wide filtering change
dnsfilter_set_permissive_modePut a policy into permissive mode - temporarily relaxes filtering for everyone on that policy
dnsfilter_create_policyCreate a new filtering policy
dnsfilter_update_policyUpdate a policy's settings (SafeSearch, unknown-domain handling, interstitial, YouTube restriction)
dnsfilter_delete_policyDelete a filtering policy - sites and agents using it lose their filtering rules
dnsfilter_create_networkCreate a site (network) - a new IP-identified location for this organization
dnsfilter_manage_networkUpdate an existing site (network), including which policy and block page it uses
dnsfilter_delete_networkDelete a site (network) - that location stops being filtered
dnsfilter_create_site_ipRegister a public IP address against a site - that IP starts resolving through DNSFilter
dnsfilter_manage_roaming_clientUpdate a roaming client: assign its policy, scheduled policy or tags
dnsfilter_manage_roaming_client_settingsChange a roaming client's agent-side settings
dnsfilter_delete_roaming_clientRemove a roaming client record - that device stops being filtered
dnsfilter_create_collectionCreate a collection (user/device group) that carries its own policy
dnsfilter_manage_collectionUpdate an existing collection, including policy precedence (order)
dnsfilter_add_collection_memberAdd a user to a collection - that user picks up the collection's policy
dnsfilter_remove_collection_memberRemove a user from a collection - that user falls back to a broader policy
dnsfilter_create_block_pageCreate a block page (branding, contact address, redirect URL)
dnsfilter_manage_block_pageUpdate an existing block page (branding, contact address, redirect URL)
dnsfilter_create_scheduled_policyCreate a scheduled (time-of-day) policy
dnsfilter_manage_scheduled_policyUpdate an existing scheduled (time-of-day) policy
dnsfilter_manage_org_settingsUpdate the organization's DNSFilter profile and agent settings
dnsfilter_manage_org_usersInvite or manage the organization's DNSFilter dashboard users

How to configure DNSFilter

Onboarding takes minutes. Dex validates your credentials before saving them.

Setup steps

  1. 1
    In the DNSFilter dashboard, go to Account Settings > API Keys and create an API token for Dex.
  2. 2
    On an MSP account, create the token under an MSP-level admin so every sub-organization is reachable.
  3. 3
    In Dex, enable the DNSFilter integration and paste the API token, leaving organization_id blank on the MSP-master connection.
  4. 4
    On the MSP-master connection, run GET /v1/organizations/all to find each customer's numeric Organization ID.
  5. 5
    Set the numeric Organization ID on each tenant's own connection to confine every read and write to that customer. Dex validates the token and organization with a live call before saving.

Credentials required

api_key
DNSFilter API token from Account Settings > API Keys - inherits the permissions of the user who created it, so on an MSP account create it under an MSP-level admin
organization_id
This tenant's numeric DNSFilter Organization ID - leave blank on the MSP-master connection, set it on each tenant connection to confine access to that organization

Requirements

  • A DNSFilter account with API access and an API token
  • On an MSP account, a token created under an MSP-level admin so sub-organizations are reachable
  • The numeric DNSFilter Organization ID for each tenant, found via GET /v1/organizations/all on the MSP-master connection
  • DNSFilter is an MSP global app: one shared token, each tenant scoped per organization by organization_id

See Dex run DNSFilter

Book a 30-minute walkthrough with our team and see how autonomous IT works in your environment — or get started for free.