duckduckgo / privacy-configuration

DuckDuckGo Privacy Configuration The configuration files within this repo are used by DuckDuckGo's Apps and Browser Extensions to control which privacy protections are enabled or disabled. In some cases, privacy protections can cause conflicts that affect expected website functionality. Files in the directory can be used to temporarily disable privacy protections or add exceptions for particular sites in order to restore expected site functionality. All feature files contain an property which contains a list of sites on which a feature should be disabled to prevent breaking site functionality. Additionally there is an directory which contains files that may add to these configurations for their respective platforms. This repo also contains the code to build and deploy the configuration files. These files (in the directory once built) are served from https://staticcdn.duckduckgo.com/trackerblocking/config/v4/... Please see the Related Resources section for a list of files used by each platform. Documentation • Config Maintainer Documentation • Config Reviewer Documentation • Privacy Feature Key Mappings • Feature Implementer Documentation • Incremental Rollout Implementation Guide • Writing a Schema for Your Config Feature • Implementation Guidelines: Remote Privacy Configuration/Allowlists • Remote Configuration Change Log **Deprecated Files** Please note the files in the directory, as well as config files, are deprecated. These files are automatically generated and only used by legacy product versions. **Adding Unprotected Entries** Unprotected entries will disable all protections on a given site. This is only used in cases of severe web breakage where a root cause cannot be determined. To add an unprotected entry manually, update the of . Installing Consider using nvm to manage node versions, after installing in the project directory run: From the top-level root folder of this npm workspace, you can run the following npm commands: **Install dependencies**: Will install all the dependencies we need to build and run the project: Building To build locally the files, run: This will generate the configuration files in a compact JSON format. To generate the configuration files with pretty-printed (indented) JSON for easier inspection, use: This is useful for debugging or reviewing the generated output. Linting If you're seeing linting errors in automation run the following: Testing To run the tests locally run the following: Related Resources • Apps and extensions using the privacy configuration: • iOS app • ios-config.json • Android app • android-config.json • WebExtension (for Chrome, Firefox, Edge, Brave, and Opera) • extension-config.json • extension-chrome-config.json • extension-firefox-config.json • extension-edge-config.json • extension-brave-config.json • Safari extension • The Safari extension has only partial remote configuration support, and uses trackers-unprotected-temporary.txt • Mac app • macos-config.json • Windows app (in beta, code not yet open source) • windows-config.json Licensing Copyright 2022 Duck Duck Go, Inc. DuckDuckGo Privacy Configuration is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. If you'd like to license the source for commercial use, please reach out. Questions • **Where can I find out why a particular exception has been added?** We mostly do two kinds of mitigations -- either allowing certain trackers or disabling one or more protections on specific URLs or on certain platforms. If you search in Code for the domain you're interested in, in most cases there will be a key below the exception for it with the URL of either an issue (old process) or a pull request (current process). Within the description of that linked URL we explain why we've added a breakage mitigation to the site in question and exactly what we're allowing or disabling to improve users' experience on the page. • **Why do some exceptions have more documentation than others?** A review of existing systems is ongoing to make this repository the central location for exceptions and bring documentation and mitigations up-to-date. • **How can I contribute to this repository?** If you suspect any website usability issues or breakage, or have concerns about what is/isn't blocked, please open an issue. We are not accepting external pull requests at this time.