In this article
Deploy the DNSFilter Chrome extension version 3.x.x on managed Chromebooks. This version supports Google’s Manifest 3 and validates DNS over HTTPS (DoH).
Caution: Due to Google's Manifest 3, the Chrome extension must be deployed with DoH settings enabled. If Chrome uses its own DoH resolver, DNS requests bypass the system-level DNS, so the extension cannot see the traffic, report it to the dashboard, or apply filtering policies.
Limitations
The Chrome extension has the following limitations:
- The extension can be deployed only with Chromebook-compatible mobile device management (MDM) tools.
- Unmanaged devices cannot sync with the DNSFilter app to apply filtering policies.
- The extension is tested with G Suite deployments but can be deployed with other MDM platforms. See the MDM's support documentation for capabilities and limitations.
- Local domains are configured in the Google Admin dashboard.
Step one: Set the device network hostname
Set the device network hostname template to prevent devices from appearing as “[blank]” in the DNSFilter dashboard. The dashboard then displays the correct device name and client registration.
Step two: Install the Chrome extension
These steps use the Google Admin dashboard, but other MDMs use a similar extension setup.
Add the organization unit (OU)
- From the Google Admin dashboard, navigate to Devices > Chrome > Apps & Extensions > Users & browsers.
- Select the Organizational Unit of users.
- Select Add (➕).
- Select Add Chrome Extension by ID.
- Select From Custom URL.
-
Enter this Extension ID and Custom URL:
Extension ID: ahailcbfmbjeilfjapehbjlclkeffojh Custom URL: https://chromeupdate.dnsfilter.com/chrome-extension/updates.xml
- Select Save to add the OU.
Install the policy
- From the DNSFilter dashboard, navigate to Deployments > Roaming Clients and copy the extension policy:
- Select Install Roaming Client.
- Select the associated Site.
- Select ChromeOS.
- Copy the Policy for extensions.
- Navigate back to Google Admin and select Installation Policy.
- Set it to Force Install + pin to browser toolbar.
- Paste the policy in the Policy for extensions field.
- Toggle on Update URL to Installation URL to help configure future updates.
- Select Save.
The Chrome extension is installed.
Step three: Configure DoH settings
- From the DNSFilter dashboard, navigate to Deployments > Roaming Clients and copy the DNS over HTTPS Template:
- Select Install Roaming Client.
- Select the associated Site.
- Select ChromeOS.
- Copy the DNS over HTTPS Template.
- From the Google Admin dashboard, navigate to Devices > Chrome > Settings.
- Select the OU of users.
- Select Users & browsers.
- Search for "DNS over HTTPS" or "DoH".
- Select DNS-over-HTTPS.
- Set DNS over HTTPS mode to Prefer DNS Over HTTPS, allow insecure fallback.
- Select Save.
- Navigate back to the search results.
- Select DNS-over-HTTPS templates with identifiers.
- Configure the template:
- Select Configuration.
- Paste the template copied from the DNSFilter dashboard under DNS over HTTPS templates.
- Select Save.
DoH settings are configured.
Step four: Upload the CA Root Certificate
🚨 Failure to upload the CA Root Certificate will result in generic error messaging instead of a Block Page when end-users navigate to blocked websites.
- From the DNSFilter Tools SSL Certificate dashboard, download the certificate. Select any OS for the download; the certificate is the same across OS platforms
✍️ For distributors managing both branded and unbranded environments, make sure to align the certificate appropriately to avoid misconfigurations between legacy Whitelabel extensions and branded certificates (or vice versa). - Navigate to the Google Admin dashboard and select Devices.
- Select Networks.
- Select the OU of users.
- Select Add Certificate.
- Upload the certificate.
- Select Enabled for Chromebook.
- Select Save.
The CA Root Certificate is now uploaded. Users will see the block page if they navigate to blocked websites.
Configure local domains to resolve without DoH (optional)
Manage local domains that bypass DNSFilter in the Google Admin dashboard for the Chrome extension.
- From the Google Admin dashboard, navigate to Chrome browser > Settings > User & browser settings.
- Select DNS over HTTPS included and excluded domains.
- Add the excluded domains.
- Select Save.
Traffic to excluded domains is not filtered by DNSFilter policies. The Chromebook uses the original system DNS to resolve queries to these domains.
Related content
Comments
0 comments
Please sign in to leave a comment.