maxxcrawford / doh-rollout Goto Github PK

Note - This repository has been archived as of Tuesday, January 7th, 2020. The DNS-over-HTTPS extension has been migrated to the Firefox browser as of Release 72. Please file any issues regarding this extension through Bugzilla.

This is a WebExtension + Experimental API to gradually roll out DNS-over-HTTP to Firefox users.

1. Install web-ext npm install -g web-ext
2. Install the dependencies npm install
3. Build the addon npm run build

1. web-ext run --verbose -f Nightly

OR

1. Run a non-release build (Nightly or Aurora) version 61+.
2. Set extensions.legacy.enabled to true in about:config
3. Navigate to about:debugging, choose "Load Temporary Add-on" and select a file from this project:
   • Select manifest.json
   • Select src/web-ext-artifacts/dns_over_https-${VERSION}.zip

You should see a new entry in the list of extensions titled "DoH Rollout".

To see the banner create a new boolean pref doh-rollout.enabled in about:config and set to true.

This will run heuristics against your network settings to determine if DoH can safely be enabled. If it can, it will trigger a doorhanger notification announcing that is has been enabled.

To check if DoH is turned on, check the value of pref network.trr.mode. If it is enabled, it will be set to 2.

Telemetry will be sent each time heuristics are evaluated.

• web-ext
• Firefox 61+

See the guidelines for contributing to this project – including on how best to report an issue with this project.

This project is governed by a Code Of Conduct.

To disclose potential a security vulnerability please see our security documentation.

This module is licensed under the Mozilla Public License, version 2.0.

• What’s next in making Encrypted DNS-over-HTTPS the Default September 9, 2019
• DNS-over-HTTPS (DoH) Update – Detecting Managed Networks and User Choice July 31, 2019
• DNS-over-HTTPS (DoH) Update – Recent Testing Results and Next Steps April 2, 2019
• Next Steps in DNS-over-HTTPS Testing November 11, 2018
• DNS over HTTPS (DoH) – Testing on Beta September 13, 2018