malhuda/AdguardKnowledgeBase
1
0
Fork 0
mirror of https://github.com/AdguardTeam/AdguardKnowledgeBase.git synced 2025-02-20 11:13:10 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Grammar Updates to the General Folder (#1026)

Browse Source 
* Grammar changes

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update docs.en.md

* Update 01.general/01.adguard-ad-filters/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/01.adguard-ad-filters/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/18.stealth-mode/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/18.stealth-mode/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/18.stealth-mode/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/18.stealth-mode/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/05.adguard-filter-policy/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/05.adguard-filter-policy/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/05.adguard-filter-policy/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Update 01.general/05.adguard-filter-policy/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

* Apply suggestions from code review

* Update 01.general/18.stealth-mode/docs.en.md

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>

Co-authored-by: nataMai <93381653+nataMai@users.noreply.github.com>
This commit is contained in:
Fisherman-Ulysses 2022-03-15 02:18:09 +08:00 committed by GitHub
parent 9fe4fc472d
commit e31057ee4e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
18 changed files with 233 additions and 234 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
01.general/01.adguard-ad-filters/docs.en.md
View File

@ -14,7 +14,7 @@ visible: true
<a name="introduction"></a>
## Introduction
This article is about filters that we create to be used in AdGuard and other ad blocking software (e.g. uBlock Origin). Every filter represents a set of rules in text format which are used by AdGuard apps and programs to filter advertising and privacy-threatening content (such as banners, pop-ups, trackers etc.). Rules specific for a particular Internet segment (German filter, Russian filter etc.), or serving a specific purpose (Social media filter, Tracking Protection filter etc.) are combined into one list — filter — and can be enabled/disabled all at once.
This article is about the filters we create to use in AdGuard and other ad-blocking software (e.g., uBlock Origin). Filters are sets of rules in text format used by AdGuard apps and programs to filter out advertising and privacy-threatening content such as banners, pop-ups, or trackers. Filters contain lists of rules based on their purpose. Language filters include rules for corresponding language segments of the Internet (e.g., the German filter). Task-based filters group rules that fulfil a specific task, such as the Social media filter or the Tracking Protection filter. Enabling or disabling a filter makes it easier to work with the entire list of rules at once.
<a name="policy"></a>
## AdGuard Filters Policy
@ -24,17 +24,17 @@ Our filter policy is available [here](https://kb.adguard.com/general/adguard-fil
<a name="contribute"></a>
## Contributing to AdGuard filters
We are blessed to have a community that does not only love AdGuard, but also gives back. A lot of people volunteer in various ways to make other users' experience with AdGuard better, and you can join them! We, on our part, can only be happy to reward the most active members of the community. So, what can you do?
We are blessed with a unique community that not only loves AdGuard but also gives back. Many people volunteer in various ways to make AdGuard's user experience better for everybody. You are welcome to join the band and make a difference. We will do our part and happily reward the most active community. So, what can you do?
### Report Issues
We rely on the community to let us know about issues with our filters. This way we can be most efficient with our time and keep filters constantly updated. To submit a report, please use this [web reporting tool](https://agrd.io/report).
We rely on the community to let us know about issues with our filters. It helps us use our time more efficiently and keep filters constantly updated. To submit a report, please use this [web reporting tool](https://agrd.io/report).
### Suggest Filtering Rules
You will find a lot of open issues in the [GitHub filter repository](https://github.com/AdguardTeam/AdguardFilters/issues). Each references a problem with some website — a missed ad, a false positive etc. — choose any one and suggest your own rules in comments. AdGuard filter engineers will review your suggestions, and if they find them correct, your rules will be added to AdGuard filters.
You will find many open issues in the [GitHub filter repository](https://github.com/AdguardTeam/AdguardFilters/issues). Each one refers to a problem with a website, such as a missed ad or a false positive. Pick one of them and suggest your own rules in the comments. AdGuard filter engineers will review your suggestions and, if approved, your rules will be added to AdGuard filters.
Here is the [official documentation](https://kb.adguard.com/general/how-to-create-your-own-ad-filters) on AdGuard filtering rules syntax. You'll need to read it before you'll be able to create your own filtering rules.
Here is the [official documentation](https://kb.adguard.com/general/how-to-create-your-own-ad-filters) on the syntax of AdGuard filtering rules. Please read it carefully; it will help you create your own filtering rules.
### Other ways to contribute

8
01.general/02.how-to-create-your-own-ad-filters/docs.en.md
View File

@ -117,13 +117,13 @@ visible: true
<a id="introduction"></a>
## Introduction
A filter is a set of filtering rules applied to specific content (banners, popups, etc). AdGuard has a list of standard filters created by our team. Our team constantly improves and updates them, and we hope our filters meet the needs of most of our users.
A filter is a set of filtering rules applied to specific content, such as banners or pop-ups. Our standard filters are created by our team; we constantly improve and update them, and we hope that our filters meet the needs of most of our users.
At the same time, AdGuard allows you to create your own custom filters, using the same type of rules that we have in our filters.
At the same time, AdGuard allows you to create your own custom filters using the same types of rules that we have in our filters.
To describe the syntax of our filtering rules we use [Augmented BNF for Syntax Specifications](https://tools.ietf.org/html/rfc5234), but we do not always strictly follow this specification.
To describe the syntax of our filtering rules, we use [Augmented BNF for Syntax Specifications](https://tools.ietf.org/html/rfc5234), but we do not always strictly follow this specification.
> AdGuard syntax is originally based on syntax of Adblock Plus rules, but it was extended with new types of rules for better ad filtering. Some parts of this article's content about the rules common to both AdGuard and ABP was taken from [this article](https://adblockplus.org/en/filters).
> Originally, the AdGuard's syntax was based on the syntax of Adblock Plus rules. Later, we extended it with new types of rules for better ad filtering. Some parts of this article about the rules common to both AdGuard and ABP were taken from [this article](https://adblockplus.org/en/filters).
<a id="comments"></a>
## Comments

88
01.general/05.adguard-filter-policy/docs.en.md
View File

@ -6,54 +6,54 @@ taxonomy:
visible: true
---
When discussing AdGuard ad filters, there is often one topic that causes disputes – whether shall AdGuard block this or that ad. By framing the rules we stick to special criteria. Our criteria are much similar to [EasyList Policy](https://easylist.to/pages/policy.html), which we find correct and appropriate. Nevertheless, we've made some changes to it.
When discussing AdGuard ad filters, there is often one topic that causes disputes – whether AdGuard should block this or that ad. By framing the rules, we stick to special criteria. Our criteria are very similar to [EasyList Policy](https://easylist.to/pages/policy.html), which we find correct and appropriate. Nevertheless, we've made some changes to it.
![](https://cdn.adguard.com/public/Adguard/Common/page_filtering.png)
## Terminology
Throughout this text, we use terms **first party** and **third party**.
Throughout this text, we use the terms **first party** and **third party**.
A first party is a website that a user is intentionally and knowingly visiting and the set of resources on the web operated by the same organization. In practice, we consider resources to belong to the same party if they are part of the same registrable domain: a public suffix plus one additional label. Example: `site.example`, `www.site.example`, and `s.u.b.site.example` are all the same party since `site.example` is their shared registrable domain.
A "first party" is a website that a user visits intentionally and knowingly and a set of resources on the web operated by the same organization. In practice, we consider resources to belong to the same party if they are part of the same registrable domain: a public suffix plus one additional label. Example: `site.example`, `www.site.example`, and `s.u.b.site.example` belong to the same party because `site.example` is their common registrable domain.
A third party is any party that does not fall within the definition of first party above. Interactions with other parties are considered third-party, even if the user is transiently informed in context (for example, in the form of a redirect). Merely hovering over, muting, pausing, or closing a given piece of content does not constitute an intention to interact.
A "third party" is any party that does not fall within the definition of the first party above. Interactions with other parties are considered third-party, even if the user is transiently informed in context (for example, in the form of a redirect). Merely hovering over, muting, pausing, or closing a given piece of content does not constitute an intention to interact.
## Common criteria
These equally apply to rules in all filters.
- Rules that often cause problems with work of some websites will be deleted.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month.
- Rules that often cause problems with the work of some websites will be deleted.
- Website-specific rules will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if available) or by other means, such as social media following. A website’s traffic is considered sufficient when it has 30 thousand monthly visitors.
## Ad filters
This part describes AdGuard Base filter, Mobile ads filter and following language-specific filters: Russian, German, Dutch, Spanish/Portuguese, Japanese, Turkish, Chinese, French.
This part describes the AdGuard Base filter, the Mobile Ads filter and the following language-specific filters: Russian, German, Dutch, Spanish/Portuguese, Japanese, Turkish, Chinese, French.
##### What shall these filters block?
- These filters shall block ads wherever possible.
- Ads shall be blocked regardless of reasons and goals of such ad.
- We will block ads caused by malicious apps or extensions that inject ads. Please note that we do it only on condition that you will specify how to install this app or extension.
- These filters will block ads wherever possible. 
- Ads should be blocked regardless of their reasons and goals.
- We will block ads caused by malicious apps or extensions that inject ads. Please note that we do it only on the condition that you specify how to install this app or extension.
##### Limitations and Exceptions
If a rule is subject to the list of limitations described below, then it won’t be added to main filters.
If a rule is subject to the list of limitations described below, then it won’t be added to the main filters.
- Websites’ own ads are not to be removed on purpose. On the other side it shouldn’t be unblocked, because such unblocking can cause displaying of third-party ads.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month.
- Anti-adblock scripts will be blocked only if they limit functionality of the website or interfere with its use.
- Anti-adblock scripts will not be blocked in cases when it is prohibited by Law.
- Rules that often cause problems with work of some websites will be deleted.
- Websites’ own ads are not to be removed on purpose. On the other hand, it shouldn’t be unblocked because such unblocking can cause the display of third-party ads.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example, social media following. A website’s traffic is considered sufficient when it has 30 thousand monthly visitors.
- Anti-adblock scripts will be blocked only if they limit the functionality of the website or interfere with its use.
- Anti-adblock scripts will not be blocked in cases when it is prohibited by law.
- Rules that often cause problems with the work of some websites will be deleted.
## Tracking Protection filter
##### What shall be blocked with this filter?
##### What will be blocked with this filter?
- This filter shall block all trackers that collect users' personal data.
We define **tracking** as collection of data regarding an individual’s identity or activity across one or more websites. Even if such data is not believed to be personally identifiable, it’s still tracking.
We define **tracking** as the collection of data regarding an individual’s identity or activity across one or more websites. Even if such data is not believed to be personally identifiable, it’s still tracking.
**Tracker** is an online script that has tracking as its only purpose, or as one of its purposes.
@ -61,75 +61,71 @@ We define **tracking** as collection of data regarding an individual’s identit
If a rule is subject to the list of limitations described below, then it won’t be added to this filter.
- Rules that cause problems with functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month.
- Rules that cause problems with the functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example, social media following. A website’s traffic is considered sufficient when it has 30 thousand monthly visitors.
## AdGuard URL Tracking filter
##### What shall be blocked with this filter?
##### What will be blocked with this filter?
- This filter shall strip all tracking parameters from URLs.
- This filter will strip all tracking parameters from URLs.
We define **tracking** as collection of data regarding an individual’s identity or activity across one or more websites. Even if such data is not believed to be personally identifiable, it’s still tracking.
We define **tracking** as the collection of data regarding an individual’s identity or activity across one or more websites. Even if such data is not believed to be personally identifiable, it’s still tracking.
##### Limitations and Exceptions
If a rule is subject to the list of limitations described below, then it won’t be added to this filter.
- Rules that would risk lowering user's security level will be removed.
- Rules that cause problems with functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month.
- Rules that would risk lowering a user's security level will be removed. 
- Rules that cause problems with the functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example, social media following. A website’s traffic is considered sufficient when it has 30 thousand monthly visitors.
## Social Media filter
##### What shall be blocked with this filter?
##### What will be blocked with this filter?
- Filter shall block social media widgets (on third-party websites) such as: “Like” and “Share” buttons, recommendation widgets and more.
- This filter will block social media widgets (on third-party websites) such as "Like" and "Share" buttons, recommendation widgets, and more.
##### Limitations and Exceptions
If a rule is subject to the list of limitations described below, then it won’t be added to this filter.
- Rules that block widgets that are a part of website’s functionality. Such as “Comments”, “Embedded Post”, “Surveys” widgets or authorization via social networks.
- Rules that block links to website’s communities in social networks.
- Rules that cause problems with functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month.
- Rules that block widgets that are a part of a website’s functionality, such as "Comments," "Embedded Post," "Surveys," or widgets that require authorization via social networks.
- Rules that block links to a website’s communities in social networks.
- Rules that cause problems with the functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example, social media following. A website’s traffic is considered sufficient when it has 30 thousand monthly visitors.
## Annoyances filter
##### What shall be blocked with this filter?
##### What will be blocked with this filter?
- This filter shall block elements on the page that are not ads but obstruct view and make it harder to see the actual content of the website. Such elements as cookie notices, third-party widgets, in-page popups, email subscription forms, banners with special offers and aggressively placed social media widgets.
- This filter will block elements on the page that are not ads but obstruct the view and make it harder to see the actual content of the website. Such elements as cookie notices, third-party widgets, in-page popups, email subscription forms, banners with special offers, and aggressively placed social media widgets.
#### Limitations and Exceptions
If a rule is subject to the list of limitations described below, then it won’t be added to this filter.
- Rules that block elements that are essential for the websites' functioning (e.g. authorization forms) will not be blocked even if they satisfy other requirements.
- Rules that cause problems with functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month.
- Rules that cause problems with the functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example, social media following. A website’s traffic is considered sufficient when it has 30 thousand monthly visitors.
## Filter unblocking search ads and self-promotion
Unlike other filters, this filter **unblocks** certain ads. More about it in [this Knowledge Base article](https://kb.adguard.com/en/general/search-ads-and-self-promotion).
Unlike other filters, this one **unblocks** certain ads. More about it in [this Knowledge Base article](https://kb.adguard.com/en/general/search-ads-and-self-promotion).
##### What shall be unblocked with this filter?
##### What will be unblocked with this filter?
- Search ads (ads that you see among the results when using an online search engine).
- Websites' self-promotion (when an ad on a website is promoting this very website or other websites/social media/etc closely related to it).
#### Limitations and Exceptions
- Rules that cause problems with functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month.
- Rules that cause problems with the functioning of websites will be removed.
- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example, social media following. A website’s traffic is considered sufficient when it has 30 thousand monthly visitors.
## Quality requirements for filtering rules
- The rules should be as efficient as possible in terms of performance.
- Exception rules shall be as much specific as possible, in order to avoid unnecessary unblocking.
- CSS and JS injection rules shall be used as rarely as possible, and only in case when ad blocking is impossible without them.
- Exception rules should be as specific as possible in order to avoid unnecessary unblocking.
- CSS and JS injection rules shall be used as rarely as possible, and only in cases when ad blocking is impossible without them.

8
01.general/06.userscripts/docs.en.md
View File

@ -23,13 +23,13 @@ visible: true
## Introduction
First, let's get it clear. What is a userscript? Userscripts (we also call them 'extensions' sometimes) de-facto are mini-programs written in Javascript. They modify or extend functionality of one or more websites. Many AdGuard users must be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra.
First, let's get it clear. What is a userscript? Userscripts (we also call them "extensions" sometimes) are, de-facto, mini-programs written in Javascript. They modify or extend the functionality of one or more websites. Many AdGuard users must already be familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra.
<a name="products"></a>
### Supported apps
AdGuard can significantly broaden website functionality working as a user script manager. You can add your custom scripts or manage existing ones in our three products: [AdGuard for Windows](https://kb.adguard.com/en/windows/features/extensions), [AdGuard for Android](https://kb.adguard.com/en/android/overview#extensions-support) and [AdGuard for Mac](https://kb.adguard.com/en/macos/overview#extensions).
Working as a user script manager, AdGuard can significantly broaden website functionality. You can add your custom scripts or manage existing ones in our three products: [AdGuard for Windows](https://kb.adguard.com/en/windows/features/extensions), [AdGuard for Android](https://kb.adguard.com/en/android/overview#extensions-support) and [AdGuard for Mac](https://kb.adguard.com/en/macos/overview#extensions).
<a name="scripts"></a>
@ -37,7 +37,7 @@ AdGuard can significantly broaden website functionality working as a user script
> ### ATTENTION
>
> These userscripts come directly from AdGuard developers and we can guarantee that they will be effective and safe. Keep in mind that whenever you download a userscript from an unknown source you expose yourself to a risk. Some scripts can be harmful to your computer. Always get new scripts only from sources you trust 100%. Further are [some examples](#repo) of popular sites with scripts.
> These userscripts come directly from AdGuard developers, and we can guarantee that they will be effective and safe. Keep in mind that whenever you download a userscript from an unknown source, you expose yourself to a risk. Some scripts can be harmful to your computer. Always get new scripts only from sources you trust 100%. Furthermore, [some examples](#repo) of popular sites with scripts.
* **AdGuard Extra** - An extension that blocks advertising in difficult cases when the usual filter-based approach is not enough.
@ -53,7 +53,7 @@ AdGuard can significantly broaden website functionality working as a user script
## Where can you get more userscripts?
Userscripts are mostly created by enthusiasts, that is why you need to be careful when installing a new one. But nevertheless, there is a great variety of interesting scripts that can really make the use of some websites more convenient.
Userscripts are mostly created by enthusiasts, which is why you need to be careful when installing a new one. But nevertheless, there is a great variety of interesting scripts that can really make the use of some websites more convenient.
Here we will describe some of the most popular userscript catalogs.

22
01.general/07.how-ad-blocking-works/docs.en.md
View File

@ -18,7 +18,7 @@ visible: true
## Introduction
There are many different AdGuard ad blocker products for various platforms, each has its one unique features. But what unites them all is that they block ads and trackers. This article describes how ad blocking works from inside.
There are many different AdGuard ad blocker products for various platforms, each with their own unique features. But what unites them all is that they block ads and trackers. This article describes how ad blocking works from the inside. 
> We don't cover DNS filtering here. It's a different way of blocking ads, with its own advantages and disadvantages. Follow this link to [learn more about DNS filtering](https://kb.adguard.com/en/general/dns-filtering).
@ -26,7 +26,7 @@ There are many different AdGuard ad blocker products for various platforms, each
## General principle
At the core of any ad blocker lie filter lists, also called filters. Filters are literally lists of rules written in a special syntax. Ad blockers can understand this complex syntax. They interpret filtering rules and perform actions with web traffic based on what the rules tell them to do: block specific elements, alter web pages in certain ways, etc.
At the core of any ad blocker lie filter lists, also called filters. Filters are literally lists of rules written in a special syntax. Ad blockers can understand this complex syntax. They interpret filtering rules and perform actions on web traffic based on what the rules tell them to do: block specific elements, alter web pages in certain ways, etc.
<img src="https://cdn.adguard.com/public/Adguard/Blog/manifestv3/adblockingworks.png" style="max-width: 750px; border: 1px solid #efefef;">
@ -36,15 +36,15 @@ At the core of any ad blocker lie filter lists, also called filters. Filters are
To better understand ad blocking, it's important to know the underlying principles of how filters work.
Filtering rules, which filters consist of, aren't created automatically. They are a product of filter maintainers' work, both professionals and volunteers. They use browsers' developer consoles and other tools (like AdGuard's Filtering log) to determine what rule would block a particular ad or tracker. This is a very simplified description of the process, as some ads are especially hard to block, require multiple rules, multiple iterations, and the use of complex syntax.
Filtering rules, which filters consist of, aren't created automatically. They are a product of filter maintainers' work, both as professionals and as volunteers. They use browsers' developer consoles and other tools (like AdGuard's filtering log) to determine what rules would block a particular ad or tracker. This is a very simplified description of the process, as some ads are especially hard to block and require multiple rules, multiple iterations, and the use of complex syntax.
And even when a rule finally gets added to the filter, it doesn't mean that it stays there forever. Ads change, ways to serve the same ads on the same websites change, and so filter rules have to change too. Sometimes rules get obsolete, sometimes a new ad appears, sometimes a new filtering rule is needed to block the same ad. Filters are often maintained by a single person, but even for a team of maintainers it's impossible to constantly monitor the entire web. This is why many ad blockers have tools to help users easily report any filter-related issues they encounter.
And even when a rule finally gets added to the filter, it doesn't mean that it stays there forever. Ads change, ways to serve the same ads on the same websites change, and so filter rules have to change too. Sometimes rules get obsolete, sometimes a new ad appears, and sometimes a new filtering rule is needed to block the same ad. Filters are often maintained by a single person, but even for a team of maintainers, it's impossible to constantly monitor the entire web. This is why many ad blockers have tools to help users easily report any filter-related issues they encounter.
<img src="https://cdn.adguard.com/public/Adguard/Blog/manifestv3/filtersupdates.png" style="max-width: 750px; border: 1px solid #efefef;">
AdGuard users [have access to a special web reporting tool](https://reports.adguard.com/new_issue.html). Thanks to user complaints, filter developers can focus on correcting their filter lists and not on scouring the Internet for new and old unblocked ads.
Filters can do more than just block ads. There are filters that block tracking, social media widgets, annoyances like cookie notices, etc. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have a huge database.
Filters can do more than just block ads. There are filters that block tracking, social media widgets, and annoyances like cookie notices, etc. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have a huge database.
> We develop and maintain [our own set of filter lists](https://kb.adguard.com/en/general/adguard-ad-filters) that can be used with AdGuard or other ad blockers.
@ -53,7 +53,7 @@ Filters can do more than just block ads. There are filters that block tracking,
## Types of filtering rules
There are many types of filtering rules that serve different purposes. Depending on the ad blocker you use, and especially on your OS, certain types of rules may not by supported.
There are many types of filtering rules that serve different purposes. Depending on the ad blocker you use, and especially on your OS, certain types of rules may not be supported.
<a name="basic"></a>
@ -61,22 +61,22 @@ There are many types of filtering rules that serve different purposes. Depending
To be displayed on a web page or in an app, the ad has to be loaded from a server first. To do so, the browser or the app needs to send a web request. The most basic way of preventing an ad from appearing on your screen is to block this request so it never reaches the server, and thus there's no reply.
Basically, all AdGuard ad blocker products can block web requests (according to the active filter rules). This method is very effective at stopping the ad but shows some drawbacks, the most obvious one is that whatever place the ad was taking up will be left empty or occupied by an ad leftover.
Basically, all AdGuard ad blocker products can block web requests according to the active filter rules. This method is very effective at stopping the ad, but it has some drawbacks. The most obvious one is that whatever place the ad was taking up will be left empty or occupied by an ad leftover.
<a name="cosmetic"></a>
### Cosmetic filtering rules
Every web page has a DOM ("document object model"), basically an HTML document that contains the page's structure and all its elements. Ads on the page are also elements and therefore reflected in the DOM. Ad blockers can remove parts of the DOM, and filtering rules help them understand which parts are ads and should be removed, and which shouldn't be messed with.
Every web page has a DOM ("document object model"), which is basically an HTML document that contains the page's structure and all its elements. Ads on the page are also elements and therefore reflected in the DOM. Ad blockers can remove parts of the DOM, and filtering rules help them understand which parts are ads and should be removed, and which shouldn't be messed with.
This method allows to avoid whitespaces and ad leftovers mentioned above, but also to perform other, more complicated tasks.
This method allows you to avoid the whitespace and ad leftovers mentioned above, but also perform other, more complicated tasks.
<a name="html"></a>
### HTML filtering rules
In most cases, the aforementioned basic and cosmetic rules are enough to filter ads. But sometimes it is necessary to change the HTML code of the page itself before it is loaded. This is when you need filtering rules for HTML content. These rules allow to indicate the HTML elements to be cut out before the browser even loads the page.
In most cases, the aforementioned basic and cosmetic rules are enough to filter ads. But sometimes it is necessary to change the HTML code of the page itself before it is loaded. This is when you need filtering rules for HTML content. This rule allows us to indicate the HTML elements to be cut out before the browser even loads the page.
This kind of rules is quite complicated and demands that the ad blocker possesses certain rights, so not all platforms support it. Such rules work only in AdGuard apps for Windows, Mac, and Android, and for AdGuard Firefox add-on.
This kind of rule is quite complicated and demands that the ad blocker possess certain rights, so not all platforms support it. Such rules work only in the AdGuard apps for Windows, Mac, and Android, and for the AdGuard Firefox add-on.
> There are more types of filtering rules, but they require even more technical knowledge to understand how they operate. If you're interested, [you can find the exhaustive guide on filtering rules in the linked article](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters).

27
01.general/08.how-malware-protection-works/docs.en.md
View File

@ -22,9 +22,9 @@ visible: true
## Introduction
Every day tens of thousands of people fall victims to virus attacks or fraud on the Internet. To protect AdGuard users from such threats, we have added special filters to the program, that protect you from malicious and phishing websites.
Every day, tens of thousands of people fall victim to virus attacks or fraud on the Internet. To protect AdGuard users from such threats, we have added special filters to the program that protect you from malicious and phishing websites.
At the moment we have categorized more than 15 million sites, and our filters contain about 1.5 million phishing and malware sites. Just think about it: 10% of all known sites can be dangerous for you! Inexperienced user can easily become a victim of fraudsters or hackers. We hope that the use of protection against malicious websites will help you avoid all hazards that you may encounter.
At the moment, we have categorized more than 15 million sites, and our filters contain about 1.5 million phishing and malware sites. Just think about it: 10% of all known sites can be dangerous for you! Inexperienced users can easily become victims of fraudsters or hackers. We hope that the use of protection against malicious websites will help you avoid all hazards that you may encounter.
@ -32,8 +32,7 @@ At the moment we have categorized more than 15 million sites, and our filters co
## How does a check work?
Method and quality of a check depends on what product you use. If you are using one of our browser extensions, then AdGuard inspects only those pages that you visit. If you are using AdGuard for Windows, Mac, or Android, then in addition to the page itself, we check each object loaded on it, giving you the best protection.
The method and quality of a check depend on what product you use. If you are using one of our browser extensions, then AdGuard inspects only those pages that you visit. If you are using AdGuard for Windows, Mac, or Android, in addition to the page itself, we check each object loaded on it, giving you the best protection.
@ -41,9 +40,9 @@ Method and quality of a check depends on what product you use. If you are using
#### AdGuard for Windows, Mac, and Android
We use the protocol [Safe Browsing API version 2.2](https://code.google.com/p/google-safe-browsing/wiki/Protocolv2Spec) for the work with our filters. This protocol allows us to keep your personal data absolutely safe. Our server knows nothing about the websites that you visit. We use hash prefixes for checks, not the opened URLs.
We use the protocol [Safe Browsing API version 2.2](https://code.google.com/p/google-safe-browsing/wiki/Protocolv2Spec) for our work with filters. This protocol allows us to keep your personal data absolutely safe. Our server knows nothing about the websites that you visit. We use hash prefixes for checks, not the opened URLs.
An approximate algorithm of the Browsing Security module functioning is shown on the example of AdGuard for Windows in the picture below.
An approximate algorithm of the functioning of the Browsing Security module is shown in the example of AdGuard for Windows in the picture below.
![Functioning algorithm of Browsing Security module](https://images.adguard.com/public/Adguard/En/Articles/safebrowsing_adguard_for_windows.png)
@ -52,11 +51,11 @@ An approximate algorithm of the Browsing Security module functioning is shown on
#### AdGuard Browser extensions
Browser extensions work differently, using the so called [_Lookup API_](https://github.com/AdguardTeam/AdguardForAndroid/issues/162) to do the check of pages that you visit. Every time you visit any website, local client exchanges information with our backend server in a form of hashes and hash prefixes. For those who are interested in the process on a deeper level, the link above will be helpful. As a result of that exchange, local client determines if the website belongs to the database of potentially dangerous websites or not.
Browser extensions work differently, using the so-called [_Lookup API_](https://github.com/AdguardTeam/AdguardForAndroid/issues/162) to do the check of pages that you visit. Every time you visit any website, a local client exchanges information with our backend server in the form of hashes and hash prefixes. For those who are interested in the process on a deeper level, the link above will be helpful. As a result of that exchange, the local client determines if the website belongs to the database of potentially dangerous websites or not.
We bring to your attention that we never get any information that could allow us to determine which websites you visit and use that data in any way.
An approximate algorithm of the Browsing Security module functioning is shown in the picture below.
An approximate algorithm of the functioning of the Browsing Security module is shown in the picture below.
![Functioning algorithm of Browsing Security module in AdGuard browser extensions.](https://images.adguard.com/public/Adguard/En/Articles/safebrowsing_extension.png)
@ -66,7 +65,7 @@ An approximate algorithm of the Browsing Security module functioning is shown in
## AdGuard filters
Currently we support the work of two AdGuard filters. One of them is aimed at protecting you against phishing and fraudulent websites. Another at protection against malicious websites, visiting of which can lead to virus infection.
Currently, we support the work of two AdGuard filters. One of them is aimed at protecting you against phishing and fraudulent websites. Another protection against malicious websites, visiting which can lead to a virus infection.
@ -76,7 +75,7 @@ Currently we support the work of two AdGuard filters. One of them is aimed at pr
_Phishing_ — is a type of online fraud aimed at gaining access to confidential data of users - username and password. If you are interested in this topic, we suggest that you read [this article at Wikipedia](http://en.wikipedia.org/wiki/Phishing).
Apart from phishing sites, this filter also contains different fraudulent sites. All kinds of "scam", selling of nonexistent content, and such.
Apart from phishing sites, this filter also contains different fraudulent sites. All kinds of "scams", selling of nonexistent content, and such.
@ -92,7 +91,7 @@ This filter contains links to pages that lead to the execution of malicious code
## How do we fill up our filters?
Our filters are constantly filled up with new addresses. Since most of the work is automated, you can be sure that new malware and phishing addresses fall into our database as quickly as possible.
Our filters are constantly filled with new addresses. Since most of the work is automated, you can be sure that new malware and phishing addresses fall into our database as quickly as possible.
@ -100,7 +99,7 @@ Our filters are constantly filled up with new addresses. Since most of the work
#### AdGuard Browsing Security Community
An important tool for maintaining the highest level of filtering is a mechanism: _AdGuard Browsing Security Community_. Any user of our products - be it AdGuard for Windows or browser extension - can become a member of the community and help us in making of AdGuard filters.
An important tool for maintaining the highest level of filtering is a mechanism: _AdGuard Browsing Security Community_. Any user of our products - be it AdGuard for Windows or browser extension - can become a member of the community and help us in the making of AdGuard filters.
In the picture below we described an algorithm of Browsing Security Community work:
@ -112,7 +111,7 @@ In the picture below we described an algorithm of Browsing Security Community wo
#### Want to help?
We will gladly accept any help! If you want to send us a complaint to a phishing or malware site, you can do it via [technical support](mailto:support@adguard.com), or [on our Forum](http://forum.adguard.com/).
We will gladly accept any help! If you want to send us a complaint about a phishing or malware site, you can do it via [technical support](mailto:support@adguard.com), or [on our Forum](http://forum.adguard.com/).
@ -120,4 +119,4 @@ We will gladly accept any help! If you want to send us a complaint to a phishing
#### False-positive responses
Occasionally some websites that are not dangerous fall into AdGuard filters. We tried to reduce the percentage of false-positives, but, nevertheless, they can occur. If you come across this behavior of AdGuard, please send us a complaint against the false-positive alarm. You can submit such complaints via our [technical support](mailto:support@adguard.com) or on [our Forum](http://forum.adguard.com/).
Occasionally, some websites that are not dangerous fall into AdGuard's filters. We tried to reduce the percentage of false-positives, but, nevertheless, they occur. If you come across this behavior from AdGuard, please send us a complaint about the false-positive alarm. You can submit such complaints via our [technical support](mailto:support@adguard.com) or on [our Forum](http://forum.adguard.com/).

40
01.general/09.license-key/docs.en.md
View File

@ -18,7 +18,7 @@ visible: true
<a name="key"></a>
#### What is AdGuard license key?
License key is a unique symbol sequence that activates AdGuard. License key is required for AdGuard’s work after trial period's expiration. There are two types of licenses available:
A license key is a unique symbol sequence that activates AdGuard. A license key is required for AdGuard to work after the trial period's expiration. There are two types of licenses available:
1. **Personal** - This license key allows you to activate AdGuard on **any three** devices.
@ -146,15 +146,15 @@ In the small window you will see 3 functions:
<a id="activation_info"></a>
#### Transferring license to another device
Once the program is activated with a license key, the license key is “bound” to the device on which activation was held. License key may be activated on a limited number of devices. If the license key is already used on the maximum possible number of devices, you need to reset it before using this key again. You can do it in your [AdGuard Account](#account-functions).
Once the program is activated with a license key, the license key is "bound" to the device on which activation was held. A license key may be activated on a limited number of devices. If the license key is already used on the maximum possible number of devices, you need to reset it before using this key again. You can do it in your [AdGuard Account](#account-functions).
<a id="recovery"></a>
## How to recover my license key?
You can easily find out which license keys belong to you in your [AdGuard Account](#account).
You can easily find which license keys belong to you in your [AdGuard Account](#account).
The binding of your license key with your account is held with your email address, which was used for purchasing of AdGuard.
The binding of your license key with your account is held with your email address, which was used for the purchase of AdGuard.
**Please note** that it is often not enough to just find out what your license key is. If it was already used on another computer, it’s necessary to unbind it from that computer through the [AdGuard Account](#account) before using it again.
@ -162,13 +162,13 @@ The binding of your license key with your account is held with your email addres
<a id="account"></a>
## How to register the AdGuard Account?
If you purchased the AdGuard License key – your Account is already registered with your email which was used by the purchase. You were to receive an email on the automatic registration of your Personal account and the link for its activation. If you haven’t received this email or forgot your password you can [recover your password](http://adguard.com/recovery_password.html).
If you purchased an AdGuard license key, your account is already registered with the email that was used for the purchase. You will receive an email with information about the automatic registration of your personal account, as well as a link to activate it. If you haven’t received this email or forgot your password, you can [recover your password](http://adguard.com/recovery_password.html).
If you don’t have AdGuard Account, we suggest you register it by clicking [this link](http://adguard.com/register.html).
If you don’t have an AdGuard account, we suggest you register it by clicking [this link](http://adguard.com/register.html).
AdGuard Account gives you an opportunity to manage your license keys and their binding with your computers.
An AdGuard account gives you an opportunity to manage your license keys and their binding with your computers.
Find more on functions of the Account [below](#account-functions).
Find more about the functions of the account [below](#account-functions).
<a id="account-functions"></a>
@ -179,13 +179,13 @@ When you enter the AdGuard [personal account](https://adguard.com/en/login.html)
This is how you can manage your AdGuard licenses and subscriptions.
#### Renew or upgrade
You can renew your key for another year, switch to Lifetime protection or make your license Family (thus adding more devices to it).
You can renew your key for another year, switch to a lifetime protection, or upgrading to the family package (thus adding more devices to it).
#### Unbind from the device
If the license key is activated on one or more computers you will see the list of these devices under the license key. License key can be activated on a limited number of devices, before using it again you will have to unbind it from one of the computers.
If the license key is activated on one or more computers, you will see the list of these devices under the license key. A license key can be activated on a limited number of devices. Before using it again, you will have to unbind it from one of the computers.
To unbind the license key from the device just click the cross icon next to that device as it's shown on this picture:
To unbind the license key from the device, just click the cross icon next to that device, as shown in this picture:
<img src="https://cdn.adguard.com/public/Adguard/kb/newscreenshots/En/General/unbind-en.png?" max-width="900" />
@ -197,37 +197,37 @@ To do so, find the subscription you need to manage and click on the card icon ne
<a name="renewal"></a>
## What to do after the key was renewed?
Once you have renewed AdGuard for another year - you will need to restart the program/app or go to the 'License' section and refresh the license status for changes to take effect.
Once you have renewed AdGuard for another year, you will need to restart the program/app or go to the 'License' section and refresh the license status for changes to take effect.
<a id="payment"></a>
#### Payment options
You can purchase an AdGuard license on our website. To do so:
You can purchase an AdGuard license on our website. To do so,
1\. Go to the [payment page](http://adguard.com/license.html).
2\. Depending on whether you want to prolong an existing license key or to purchase a new one, choose the appropriate option.
2\. Depending on whether you want to prolong an existing license key or purchase a new one, choose the appropriate option.
3\. Choose the license type. Currently, we have **two** different license types - **Personal** and **Family**.
3\. Choose the license type. Currently, we have **two** different license types: - **Personal** and **Family**. 
4\. Choose the preferred currency, license period and the number of devices you want to use AdGuard on.
4\. Choose the preferred currency, license period, and the number of devices you want to use AdGuard on.
5\. Enter and confirm your email address.
_**Attention!** Please, pay close attention to the email address you enter. The license key will be sent to this address, and it will be used to automatically create your AdGuard personal account. Make sure you don't make any typos._
_**Attention!** Please pay close attention to the email address you enter. The license key will be sent to this address, and it will be used to automatically create your AdGuard personal account. Make sure you don't make any typos._
6\. Choose the payment method.
We offer the possibility to pay with a credit card or PayPal.
We accept credit card payments as well as PayPal payments.
#### License key activation
The purchased license key will be sent to the indicated email address. You need to activate your AdGuard with this license key. The detailed instruction on how to do it is available [here](#activation).
The purchased license key will be sent to the indicated email address. You will need to activate your AdGuard with this license key. The detailed instructions on how to do it are available [here](#activation).
<a id="refund"></a>
## Refund policy
To get a refund, contact our [support team](mailto:support@adguard.com) and indicate what payment option you used. Note that refunds may be rejected if you've purchased the license key more than 60 days ago.
To get a refund, contact our [support team](mailto:support@adguard.com) and indicate what payment option you used. Note that a refund may be denied if you've purchased the license key more than 60 days ago.

26
01.general/10.why-is-adguard-better/docs.en.md
View File

@ -6,33 +6,33 @@ taxonomy:
visible: true
---
AdGuard is often compared with well-known browser-extensions - Adblock and Adblock Plus. In this article we describe what main advantages of AdGuard are that its competitors don't have.
AdGuard is often compared with well-known browser-extensions like Adblock and Adblock Plus. In this article, we will describe the main advantages of AdGuard that its competitors don't have.
Adguard’s advantages are largely due to the limitations that are imposed on browser-based extensions. Adblock and Adblock Plus technologically are not able to remove all the ads on the page. That’s because AdGuard processes page even before it is loaded into the browser, removing all advertising elements. Extensions work on a different principle based on ad blocking capabilities of a browser. That is why an additional page [post-processing](http://adguard.com/en/how-ads-blocked.html#cosmetic) step is required for hiding the blocked elements. If you've ever used Adblock, then you surely noticed how the hiding banners “blink”.
AdGuard apps' advantages are largely due to the limitations that are imposed on browser-based extensions. Adblock and Adblock Plus, technologically, are not able to remove all the ads on the page. That’s because AdGuard processes a page even before it is loaded into the browser, removing all advertising elements. Extensions work on a different principle based on the ad-blocking capabilities of a browser. That is why an additional page [post-processing](http://adguard.com/en/how-ads-blocked.html#cosmetic) step is required to hide the blocked elements. If you've ever used Adblock, then you surely noticed how the hidden banners "blink".
![](banner.png)
The second advantage of AdGuard is that it is a separate program, not a browser extension. AdGuard can block ads in any browser. Whatever browser you use, whether it's Google Chrome, Mozilla Firefox, Opera, Internet Explorer or Yandex… - with AdGuard you will forget about irritating online ads.
The second advantage of AdGuard is that it is a separate program, not a browser extension. AdGuard can block ads in any browser. Whatever browser you use, whether it's Google Chrome, Mozilla Firefox, Opera, Internet Explorer, or Yandex, with AdGuard you will forget about irritating online ads.
If you use a rare browser - it can be a problem for Adblock and Adblock Plus because these extensions exist only for the most popular browsers. With AdGuard you won’t have these problems, you can easily add your browser to the protected list.
If you use a rare browser, it can be a problem for Adblock and Adblock Plus because these extensions exist only for the most popular browsers. With AdGuard, you won’t have these problems. You can easily add your browser to the protected list.
![](add_app_en.png)
And that’s not all. AdGuard can block ads in Skype, uTorrent and many other common programs. Just add them to the list of browsers and restart.
And that’s not all. AdGuard can block ads in Skype, uTorrent, and many other common programs. Just add them to the list of browsers and restart.
Apart from blocking ads, AdGuard gives you a lot of additional tools. Perhaps the most important of them is the Phishing Filter. This module operates with the help of a constantly updated database of malicious and phishing sites. AdGuard uses two main sources: the list of Google Safe Browsing and AdGuard’s own lists. We are constantly monitoring data on the safety of websites and quickly improve our filters.
Apart from blocking ads, AdGuard gives you a lot of additional tools. Perhaps the most important of them is the phishing filter. This module operates with the help of a constantly updated database of malicious and phishing sites. AdGuard uses two main sources: the list of Google Safe Browsing and AdGuard’s own lists. We are constantly monitoring data on the safety of websites and quickly improve our filters.
![](warning.png)
Some users use AdGuard instead of an antivirus, some with it. In any case, AdGuard seriously increases the security of your computer on the network.
Some users use AdGuard instead of an antivirus program, some with it. In any case, AdGuard seriously increases the security of your computer on the network.
There is a popular misconception that Adblock and Adblock Plus almost do not consume resources. But is it really so?
There is a popular misconception that Adblock and Adblock Plus almost never consume resources. But is it really so?
To check this we will use the Task Manager in Google Chrome browser.
To check this, we will use the Task Manager in the Google Chrome browser.
![](task%20manager.png)
Note that even in the most simple settings and one single filter enabled, extensions consume 100 megabytes of RAM. AdGuard consumes almost the same amount of resources while offering much more features.
Note that even in the most simple settings with one single filter enabled, extensions consume 100 megabytes of RAM. AdGuard consumes almost the same amount of resources while offering many more features.
To sum up:
@ -40,8 +40,8 @@ To sum up:
**2. AdGuard really saves your traffic.**
**3. AdGuard works in any browser.**
**3. AdGuard is compatible with all browsers.**
**4. AdGuard can remove ads from Skype, uTorrent and other applications.**
**4. AdGuard can remove ads from Skype, uTorrent, and other applications.**
**5. AdGuard helps to protect you from viruses and scams.**
**5. AdGuard helps protect you from viruses and scams.**

16
01.general/11.https-filtering/01.https-filtering-known-issues/docs.en.md
View File

@ -7,9 +7,9 @@ visible: true
---
> Last update: January 18, 2021
> Understanding this article may require from you the basic knowledge about encrypting, TLS protocol and HTTPS.
> Understanding this article may require some basic knowledge about encryption, the TLS protocol, and HTTPS.
First, look at this simple diagram that shows the general structure of HTTPS protocol:
First, look at this simple diagram that shows the general structure of the HTTPS protocol:
![What is HTTPS filtering](https://cdn.adguard.com/public/Adguard/Blog/https/what_is_https_filtering.png)
@ -24,21 +24,21 @@ Effectively, it means that if you use a modern, safe browser, it will take all k
### Known issues
HTTPS filtering in AdGuard has its drawbacks. Almost all of them are scheduled to be eliminated in the nearest upcoming AdGuard versions.
HTTPS filtering in AdGuard has its drawbacks. Almost all of them are scheduled to be eliminated in the next few AdGuard versions.
Below are listed all issues known to us and ETAs for the fixes.
Below are listed all the issues known to us and the ETAs for the fixes.
#### Inspecting the original certificate
The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate that the website uses. You cannot simply check what was the original certificate, and can only see the one issued by AdGuard.
The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate that the website uses. You cannot simply check what the original certificate was and can only see the one issued by AdGuard.
This problem has been solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering right from the browser and allows to inspect the original certificate of any website.
This problem has been solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering right from the browser and allows you to inspect the original certificate of any website.
#### Certificate Transparency
Thanks to modern cryptography, browsers can usually detect malicious websites that are provisioned with forged or fake SSL certificates. However, current cryptographic mechanisms aren’t so good at detecting malicious websites if they’re provisioned with mistakenly issued certificates or certificates that have been issued by a certificate authority (CA) that’s been compromised or gone rogue. Certificate Transparency aims to remedy these certificate-based threats by making the issuance and existence of SSL certificates open to scrutiny by domain owners, CAs, and domain users.
Browsers ignore the `Expect-CT` header in the case of local certificates and to achieve the same level of security we must implement the certificate transparency check on our side.
Browsers ignore the `Expect-CT` header in the case of local certificates, and to achieve the same level of security, we must implement the certificate transparency check on our side.
**Our plans:**
@ -48,4 +48,4 @@ Browsers ignore the `Expect-CT` header in the case of local certificates and to
### Have remarks or suggestions?
If you’d like to add something, notice any mistakes or want to ask a question, please contact us: `devteam at adguard.com`.
If you’d like to add something, notice any errors, or want to ask a question, please contact us: `devteam at adguard.com`.

37
01.general/11.https-filtering/docs.en.md
View File

@ -11,7 +11,7 @@ visible: true
HTTPS (HyperText Transfer Protocol Secure) is an extension of the HTTP protocol that supports encryption to increase security. This protocol is used to securely transmit valuable information like personal data, credit card details, etc.
Using HTTPS is strictly advantageous, since encrypted traffic is protected from ‘eavesdropping’ by third parties, and we can only welcome this. HTTPS spread has been on the rise in the recent years, mostly because it is being [encouraged by Google](https://webmasters.googleblog.com/2014/08/https-as-ranking-signal.html), and also due to the emergence of a free certification center [Let’s Encrypt](https://en.wikipedia.org/wiki/Let's_Encrypt).
Using HTTPS is strictly advantageous since encrypted traffic is protected from ‘eavesdropping’ by third parties, and we can only welcome this. HTTPS spread has been on the rise in recent years, mostly because it is being [encouraged by Google](https://webmasters.googleblog.com/2014/08/https-as-ranking-signal.html) and also due to the emergence of a free certification center [Let’s Encrypt](https://en.wikipedia.org/wiki/Let's_Encrypt).
The diagram below describes the difference between plain HTTP protocol and secure HTTPS protocol.
@ -19,15 +19,15 @@ The diagram below describes the difference between plain HTTP protocol and secur
### What is a security certificate?
Simply put, HTTPS means data encryption. But there’s still a problem: how can you be sure you’ve established an encrypted connection with exactly the website you intended to? That’s where security certificates come into play. The certificate is proof that the website is actually what it tells you it is. If a website doesn’t have such certificate, or the certificate contains incorrect information, the browser won’t let you establish a secure connection. It is important that the certificate a website uses was issued by a certification authority (CA) trusted by your browser. Such CA guarantees that the SSL certificate is, indeed, issued to the website’s owner.
Simply put, HTTPS means data encryption. But there’s still a problem: how can you be sure you’ve established an encrypted connection with exactly the website you intended to? That’s where security certificates come into play. The certificate is proof that the website is actually what it tells you it is. If a website doesn’t have such a certificate, or if the certificate contains incorrect information, the browser won’t let you establish a secure connection. It is important that the certificate a website uses is issued by a certification authority (CA) trusted by your browser. Such a CA guarantees that the SSL certificate is, indeed, issued to the website’s owner.
### Why does AdGuard need to be able to filter HTTPS?
The thing is, more and more websites, blogs, social media, etc. switch to HTTPS every day. And following blogs and websites, more ad networks switch to HTTPS too, because it becomes necessary to display ads on the HTTPS-based website. Here are few examples of popular websites, where you can’t remove ads without filtering the HTTPS: youtube.com, facebook.com, twitter.com.
The thing is, more and more websites, blogs, social media, etc., switch to HTTPS every day. And following blogs and websites, more ad networks are switching to HTTPS too, because it becomes necessary to display ads on HTTPS-based websites. Here are a few examples of popular websites where you can’t remove ads without filtering the HTTPS: youtube.com, facebook.com, and twitter.com.
### How does HTTPS filtering work?
If it were easy, HTTPS wouldn’t be that secure. Upon browser’s attempt to connect to a server, AdGuard establishes two secure connections: one with the browser (or another app), and the other with the server. It is crucial that browser trusts AdGuard and the connections created by it. For this purpose, AdGuard generates a special (and unique) root certificate and installs it into the system and, when it is required, into some browsers too (e.g. Firefox). Thus, AdGuard can see what is happening inside of the secure connection and do its job - block ads and tracking.
If it were easy, HTTPS wouldn’t be that secure. Upon a browser’s attempt to connect to a server, AdGuard establishes two secure connections: one with the browser (or another app), and the other with the server. It is crucial that the browser trusts AdGuard and the connections created by it. For this purpose, AdGuard generates a special (and unique) root certificate and installs it into the system and, when it is required, into some browsers too (e.g., Firefox). Thus, AdGuard can see what is happening inside of the secure connection and do its job — block ads and trackers.
For better understanding we depicted this process:
@ -35,47 +35,46 @@ For better understanding we depicted this process:
### Does my traffic remain encrypted and secure?
Of course! Your connection with a remote server remains encrypted and secure. AdGuard, just as your browser, checks the server’s certificate before deciding whether to filter it or not.
Of course! Your connection with a remote server remains encrypted and secure. AdGuard, just like your browser, checks the server’s certificate before deciding whether to filter it or not.
Nevertheless, HTTPS filtering has its drawbacks. The most important of them is the fact that it hides from the browser the real certificate that the website uses. Instead, the browser sees the certificate issued by AdGuard.
Nevertheless, HTTPS filtering has its drawbacks. The most important of these is the fact that they hide from the browser the real certificate that the website uses. Instead, the browser sees the certificate issued by AdGuard.
Because of this, we undertake several additional measures to improve the connection’s security.
Because of this, we undertook several additional measures to improve the connection’s security.
### Financial websites and websites with sensitive personal data
By default, AdGuard doesn’t filter any information for the bank websites, websites of the payment systems and websites with valuable personal data. We maintain a list of more than [1300 such exclusions](https://github.com/AdguardTeam/HttpsExclusions).
By default, AdGuard doesn’t filter any information from the bank websites, websites of the payment systems, or websites with valuable personal data. We maintain a list of more than [1,300 such exclusions](https://github.com/AdguardTeam/HttpsExclusions).
If you believe some website should be added to this list, please [let us know](https://github.com/AdguardTeam/HttpsExclusions/issues/new).
### Extended Validation (EV) certificates
AdGuard provides an ability to exclude from filtering all websites that use extended validation certificates.
AdGuard allows you to exclude all websites that use extended validation certificates from filtering.
EV certificate means a higher security level and provides more guarantees than a regular certificate, proving that the website is not fraudulent or fake.
An EV certificate means a higher security level and provides more guarantees than a regular certificate, proving that the website is not fraudulent or fake.
### Problems related to HTTPS filtering
The recent [research](https://cdn.adguard.com/public/Adguard/Blog/https/interception-ndss17.pdf) shows that 5 to 10% of HTTPS connections are established by HTTPS filtering applications. It is usually done by various kinds of antivirus software. The bad news is that 24 of 26 tested antiviruses were in one way or another reducing the connection security level and two-thirds were creating vulnerable to hacking connections.
The recent [research](https://cdn.adguard.com/public/Adguard/Blog/https/interception-ndss17.pdf) shows that 5 to 10% of HTTPS connections are established by HTTPS filtering applications. It is usually done by various kinds of antivirus software. The bad news is that 24 of 26 tested antiviruses were in one way or another reducing the connection security level, and two-thirds were creating vulnerable to hacking connections.
The researchers’ conclusion was simple - Internet security community has to pay close attention to applications that filter secure connections. And the developers of such programs have to attend to the quality of filtering implementation most seriously.
The researchers’ conclusion was simple: the Internet security community has to pay close attention to applications that filter secure connections. And the developers of such programs have to pay attention most seriously to the quality of filtering implementation.
I want to note that AdGuard has not been tested by the researchers. According to our estimates, and judging by the set of tests, at the time of testing we would get the maximum score - A\*. Nevertheless, that score is not perfect. There are some problems that have been identified by researchers but were not taken into account in the final evaluation.
I want to note that AdGuard has not been tested by the researchers. According to our estimates and judging by the set of tests, at the time of testing we would get the maximum score - A\*. Nevertheless, that score is not perfect. There are some problems that have been identified by researchers but were not taken into account in the final evaluation.
Here in AdGuard, we completely agree with those conclusions. Moreover, we would like to be as open with users as possible and talk about the problems we are having at the moment, and what steps we are taking to improve the quality and security of filtering mechanism. The list of these problems is sorted by their priority.
Here at AdGuard, we completely agree with those conclusions. Moreover, we would like to be as open with users as possible and talk about the problems we are having at the moment and what steps we are taking to improve the quality and security of the filtering mechanism. The list of these problems is sorted by their priority.
The majority of the problems discovered in the research above are connected with certificate validation mechanisms. This is what we want to focus on firstly. We are working on a separate certificate validation library. Moreover, we want to make it open source. A [separate article](https://kb.adguard.com/en/general/https-filtering/https-filtering-known-issues) lists all known drawbacks of HTTPS filtering in AdGuard and estimates when we will fix them.
The majority of the problems discovered in the research above are connected to certificate validation mechanisms. This is what we want to focus on first. We are working on a separate certificate validation library. Moreover, we want to make it open source. A [separate article](https://kb.adguard.com/en/general/https-filtering/https-filtering-known-issues) lists all the known drawbacks of HTTPS filtering in AdGuard and estimates when we will fix them..
#### HTTPS filtering issues on Android 7+
[Starting from Android 7](https://blog.adguard.com/en/android-nougat-release-and-what-does-it-mean-for-adguard-users/), developers have to explicitly indicate that their apps trust user-installed certificates. Not everyone wants to, or bothers with it. What does it mean for AdGuard? AdGuard installs a user certificate to be able to filter HTTPS traffic. If an app doesn't trust this certificate, its HTTPS traffic will not be filtered. What to do?
The first thing to mention is, some (many, even) modern apps still trust user certificates. Nothing changes in their regard. Almost all browsers do, too — maybe there are some exotic ones that don't, but they are a huge exception compared to the field.
Finally, if your device is rooted, you can move AdGuard certificate to system storage. This way you don't have to worry about any permissions a particular app may or may not have — HTTPS traffic will be filtered for modern apps just as well as for older ones. Please keep in mind that in this case some additional security restrictions like HPKP or `Expect-CT` apply to AdGuard.
The first thing to mention is that some (many, even modern) apps still trust user certificates. Nothing changes in that regard. Almost all browsers do it, too—maybe there are some exotic ones that don't, but they are a huge exception compared to the field.
Finally, if your device is rooted, you can move the AdGuard certificate to system storage. This way, you don't have to worry about any permissions a particular app may or may not have—HTTPS traffic will be filtered for modern apps just as well as for older ones. Please keep in mind that in this case, some additional security restrictions like HPKP or `Expect-CT` apply to AdGuard.
### How to manually check HTTPS quality?
There are several websites created specifically for the purpose of checking HTTPS connections quality. These websites check if your browser (or, in our case, browser + AdGuard) is susceptible to common vulnerabilities. If you plan to use any program that filters HTTPS (not necessarily AdGuard, it may be an antivirus, etc.), we advise checking the connection quality on these websites.
There are several websites created specifically for the purpose of checking an HTTPS connection's quality. These websites check if your browser (or, in our case, browser + AdGuard) is susceptible to common vulnerabilities. If you plan to use any program that filters HTTPS (not necessarily AdGuard; it may be an antivirus, etc.), we advise checking the connection quality on these websites.
* [https://www.ssllabs.com/ssltest/viewMyClient.html](https://www.ssllabs.com/ssltest/viewMyClient.html)
* [https://www.howsmyssl.com/](https://www.howsmyssl.com/)

18
01.general/12.search-ads-and-self-promotion/docs.en.md
View File

@ -8,35 +8,35 @@ visible: true
---
## Search ads and self-promotion
**Disclaimer.** While AdGuard provides an option to show some ads, we do not have any kind of 'acceptable ads' program like Adblock Plus and some other adblockers, where they take money for leaving certain ads unblocked. This is not the case. We are not being paid for showing any of the ads, and we do not use the term 'acceptable' for a reason - ads we might show can be, in fact, useful and not just 'acceptable'. All of this only refers to the search ads and self-promotional ads.
**Disclaimer.** While AdGuard provides an option to show some ads, we do not have any kind of 'acceptable ads' program like Adblock Plus and some other adblockers, where they take money for leaving certain ads unblocked. This is not the case. We are not being paid for showing any of the ads, and we do not use the term 'acceptable' for a reason; the ads we might show can be, in fact, useful and not just 'acceptable'. All of this only refers to the search ads and self-promotional ads.
Just to make it absolutely clear - this is **completely optional**. You can turn off the display of these ads at any time with no penalty whatsoever. Further we will explain which ads qualify for this definition.
Just to make it absolutely clear, this is **completely optional**. You can turn off the display of these ads at any time with no penalty whatsoever. Furthermore, we will explain which ads qualify for this definition.
### Search ads
Search ads are ads that you see among the results of a search query when using an online search engine like Google, Bing, DuckDuckGo etc.
Search ads are ads that you see among the results of a search query when using an online search engine like Google, Bing, DuckDuckGo, etc. 
![search-ads](https://user-images.githubusercontent.com/28726429/27697369-b3d2556e-5cfc-11e7-9203-3c95a7de7c28.png)
These ads are always contextual, i.e. they are targeted to match whatever keywords you had used when you made the query. It helps you to find exactly what you are searching for. Moreover, search ads are often more relevant and helpful than the rest of the search results due to being manually moderated.
These ads are always contextual, i.e., they are targeted to match whatever keywords you used when making the query. It helps you find exactly what you are searching for. Moreover, search ads are often more relevant and helpful than the rest of the search results due to being manually moderated.
Another argument in defense of search ads is that they are much less intrusive than many other ad formats.
### What is websites' self-promotion?
Basically, when an ad on a website is promoting this very website or other websites/social media/etc closely related to it, such ad is considered a self-promoting one.
Basically, when an ad on a website is promoting this very website or other websites/social media/etc. closely related to it, such an ad is considered a self-promoting one.
![self-promo](https://user-images.githubusercontent.com/8577533/27700604-c9b6f330-5d06-11e7-8ac9-1a9120f720c8.png)
Our general stance here is very similar to EasyList policy regarding self-promoting ads. According to our [filter policy](https://kb.adguard.com/general/adguard-filter-policy) we should not block these ads; we shouldn't, however, make an exception either if such ad is being blocked be some rule 'alongside' a regular ad.
Our general stance here is very similar to the EasyList policy regarding self-promoting ads. According to our [filter policy](https://kb.adguard.com/general/adguard-filter-policy) we should not block these ads; we shouldn't, however, make an exception either if such an ad is being blocked by some rule 'alongside' a regular ad.
Partly, this is due to ethical reasons, but mostly because such ads are rarely too intrusive and are often useful for the visitor of the website (who is supposedly interested in this website's content).
By enabling 'Search ads and self-promotion' AdGuard users can unblock some of these self-promotional ads.
By enabling 'Search ads and self-promotion' AdGuard users can unblock some of these self-promotional ads. 
### What ads are on the list?
When you enable 'Search ads and self-promotion', the search ads in the following search engines are shown:
When you enable 'Search ads and self-promotion', the search ads from the following search engines are shown:
* Google
* Yahoo
@ -50,4 +50,4 @@ As well as all self-promotional ads that satisfy our filter policy.
### Summary
Allowing 'Search ads and self-promotion' is a 100% optional feature that can be helpful in some cases, and if you don't like it, you are free to disable it at any time. There are no and will never be any types of ads or individual ads included in there, which do not fall under one of the two categories described above.
Allowing 'Search ads and self-promotion' is a 100% optional feature that can be helpful in some cases, and if you don't like it, you are free to disable it at any time. There are not and will never be any types of ads or individual ads included in there that do not fall under one of the two categories described above.

24
01.general/13.adguard-beta-testing-program/docs.en.md
View File

@ -16,37 +16,37 @@ There is&nbsp;an&nbsp;AdGuard app for virtually every major platform out there,
### How to&nbsp;become a&nbsp;beta tester
We&nbsp;do&nbsp;not have any special requirements. All you need is&nbsp;to&nbsp;use AdGuard, update to&nbsp;the beta version when it&nbsp;is&nbsp;available and report all spotted bugs. One important thing, though: you will need either [forum](https://forum.adguard.com/index.php) or&nbsp;[GitHub](https://github.com/) account (or&nbsp;both :)) to&nbsp;become our beta tester&nbsp;&mdash; so&nbsp;you might want to&nbsp;get it&nbsp;over with before going further.
We do not have any special requirements. All you need is to use AdGuard, update to the beta version when it's available, and report all spotted bugs. However, you will need either a [forum] (https://forum.adguard.com/index.php) or a [GitHub] (https://github.com/) account (or both:)) to become our beta tester, so you may want to get that out of the way first.
In any case, every single thing you need to know is gathered on a [dedicated page](https://adguard.com/en/beta.html).
If you want to skip the description part and get right to the deal, you can submit an application [here](https://surveys.adguard.com/beta_testing_program/form.html). It will be reviewed within 1-3 working days and you'll get a reply via email.
If you want to skip the description part and get right to the deal, you can submit an application [here](https://surveys.adguard.com/beta_testing_program/form.html). It will be reviewed within 1-3 working days, and you'll get a reply via email.
<a name="report-a-bug"></a>
### How to&nbsp;report a&nbsp;bug
Let&rsquo;s imagine the worst happened&nbsp;&mdash; you spotted a&nbsp;bug. Or&nbsp;maybe you just want to&nbsp;share your suggestion with developers? Anyway, there are several ways to&nbsp;let&nbsp;us know:
Let’s imagine the worst happened — you spotted a bug. Or maybe you just want to share your suggestion with developers? Anyway, there are several ways to let us know:
* Go&nbsp;to [forum.adguard.com](forum.adguard.com) and post there a&nbsp;new thread (or&nbsp;find an&nbsp;existing one) in&nbsp;the beta forum [category](https://forum.adguard.com/index.php?categories/48/). Make sure to&nbsp;read [forum rules](https://forum.adguard.com/index.php?threads/14859/) first;
* Go to [forum.adguard.com](forum.adguard.com) and post there a new thread (or find an existing one) in the beta forum [category](https://forum.adguard.com/index.php?categories/48/). Make sure to read [forum rules](https://forum.adguard.com/index.php?threads/14859/) first;
* Go&nbsp;to [GitHub](https://github.com/AdguardTeam/) and find a&nbsp;suitable repository. Create a&nbsp;new issue there and describe the bug/feature request in&nbsp;details;
* Go to [GitHub](https://github.com/AdguardTeam/) and find a suitable repository. Create a new issue there and describe the bug/feature request in detail.
The two methods above are highly preferable, but you can also use other, if&nbsp;needed:
The two methods above are highly preferable, but you can also use others, if needed:
* Find&nbsp;us on&nbsp;various social media, like [Facebook](https://www.facebook.com/AdguardEn/), [Reddit](https://www.reddit.com/r/Adguard/) etc. This is&nbsp;not the most convenient way to&nbsp;discuss technical matters, though.
* Find us on various social media, like [Facebook](https://www.facebook.com/AdguardEn/), [Reddit](https://www.reddit.com/r/Adguard/) etc. This is not the most convenient way to discuss technical matters, though.
* Contact our support team by&nbsp;sending an&nbsp;email either from in-app support tab or&nbsp;directly&nbsp;to [support@adguard.com](mailto:support@adguard.com);
* Contact our support team by sending an email either from in-app support tab or directly to [support@adguard.com](mailto:support@adguard.com);
<a name="iOS"></a>
### How to activate the beta key in the iOS application:
If you already have received a beta key and it is displayed in the list in your account on adguard.com, just go to the application and open the license section (Get Premium). Here you need to enter your credentials from your AdGuard account. After that, Premium features will become available automatically.
If you have already received a beta key and it is displayed in the list in your account on adguard.com, just go to the application and open the license section (Get Premium). Here you need to enter your credentials from your AdGuard account. After that, premium features will become available automatically.
### What else?
There is&nbsp;not much to&nbsp;add. You don&rsquo;t have to&nbsp;go&nbsp;out of&nbsp;your way in&nbsp;your search for bugs. You can just use AdGuard in&nbsp;a&nbsp;way you normally would, just don&rsquo;t be&nbsp;lazy if&nbsp;you encounter a&nbsp;bug and report it :) Of&nbsp;course, we&nbsp;appreciate any additional effort and/or extra forum activity etc.
There is not much more to add. You don't have to go out of your way to find bugs. You can continue to use AdGuard as usual. However, if you encounter a bug, please do not be lazy in reporting it. Of course, we appreciate any additional effort and/or extra forum activity, etc.
From time to&nbsp;time you will receive our newsletter, informing about the latest changes in&nbsp;beta version (in&nbsp;case you miss&nbsp;it) and other important news. You can unsubscribe from it&nbsp;if&nbsp;you want&nbsp;to.
From time to time, you will receive our newsletter, informing you about the latest changes in beta version (in case you missed it) and other important news. You can unsubscribe from it if you want to.
And that&rsquo;s all! If&nbsp;you feel the urge to&nbsp;participate in&nbsp;AdGuard beta testing program you now know what to&nbsp;do!
And that’s all! If you feel the urge to participate in AdGuard beta testing program, you now know what to do!

14
01.general/14.filter-rules-statistics/docs.en.md
View File

@ -10,11 +10,11 @@ visible: true
>NOTE: The *“Send statistics for ad filters usage”* option is disabled by default. Nothing will be sent unless user manually enables it to help us improve our blocking filters.
### Why do we need ad filters?
Let us begin with the definition of what ad filters are. Thanks to these filters, AdGuard removes ads from websites.
They are compiled manually, based on your complaints about ads on any of the websites. This is one of the most important elements of AdGuard’s work – namely the quality of ad filters determines the quality of the whole AdGuard’s work.
Let us begin with the definition of what ad filters are. Thanks to these filters, AdGuard removes ads from websites. 
They are compiled manually based on your complaints about ads on any of the websites. This is one of the most important elements of AdGuard’s work—namely, the quality of ad filters determines the quality of the whole AdGuard work.
But there is a reverse side. Over the years, there are more and more advertising filters. And the more ad filters appear, the more memory AdGuard consumes and the slower are the web pages rendered.
At the same time, some of the filters begin to expire, gradually becoming a dead weight that does not have any use, only consumes memory and slows down the program.
But there is a reverse side. Over the years, there have been more and more advertising filters. And the more ad filters appear, the more memory AdGuard consumes and the slower the web pages are rendered. 
At the same time, some of the filters begin to expire, gradually becoming a dead weight that does not have any use and only consumes memory and slows down the program.
### Why do we need statistics?
@ -37,9 +37,9 @@ The list is created based on the website's visit statistics since the last time
The collected statistics will be sent periodically to our server for analysis and filter optimization.
Important to notice that all the statistics we get is being averaged and impersonalized. We don't use this statistics for any other goal other than optimizing the filters, and we do not sell this data to any third parties. You can read about our Privacy Policy [here](https://adguard.com/en/privacy.html).
It's important to notice that all the statistics we get are averaged and impersonalized. We don't use these statistics for any other goal other than optimizing the filters, and we do not sell this data to any third parties. You can read about our Privacy Policy [here](https://adguard.com/en/privacy.html).
### What does tracking filter rules statistics fraught with?
For the vast majority of users the change in speed of their computer will not be really noticeable. But if you use a netbook or a tablet, you may notice a slight slowdown.
For the vast majority of users, the change in the speed of their computer will not be really noticeable. But if you use a netbook or a tablet, you may notice a slight slowdown.
Periodically, we will send the gathered statistics to the server. The size of data being sent is not very large and comparable with the size of an average web page.
Periodically, we will send the gathered statistics to the server. The size of the data being sent is not very large and is comparable to the size of an average web page.

20
01.general/15.dns-filtering/docs.en.md
View File

@ -18,7 +18,7 @@ To better understand DNS filtering, first, we should answer the question "What i
<a id="what-is-dns"></a>
### What is DNS?
DNS stands for "Domain name system", and its purpose is to translate websites' names into something browsers can understand, i.e. IP addresses. Thus, each time you go to a website, your browser sends a request to a special server (DNS server). That server looks at the requested domain name and replies with a corresponding IP address. Very schematically it can be represented like this:
DNS stands for "Domain Name System", and its purpose is to translate websites' names into something browsers can understand, i.e., IP addresses. Thus, each time you go to a website, your browser sends a request to a special server (DNS server). That server looks at the requested domain name and replies with a corresponding IP address. Very schematically, it can be represented like this:
<img src="https://cdn.adguard.com/public/Adguard/kb/DNS_filtering/how_dns_works_en.png" style="border: 1px solid #efefef; padding: 2px;" />
@ -38,20 +38,21 @@ DNS filtering can be broken down into two separate functions: to encrypt and rer
<a id="dns-servers"></a>
#### DNS servers
There are thousands of DNS servers to choose from, and they are all unique in their properties and purposes. Most simply return the IP address of the requested domain, but some have additional functions: they block ad, tracking, adult domains and so on. Nowadays all major DNS servers employ one or more reliable encryption protocols: DNS-over-HTTPS, DNS-over-TLS. AdGuard also provides a [DNS service](https://adguard-dns.com/en/welcome.html), and it was the world's first to offer the very new and promising [DNS-over-QUIC](https://adguard.com/en/blog/dns-over-quic.html) encryption protocol. AdGuard has different servers for different goals. This diagram illustrates how AdGuard blocking servers work:
There are thousands of DNS servers to choose from, and they are all unique in their properties and purposes. Most simply return the IP address of the requested domain, but some have additional functions: they block ads, trackers, adult domains, and so on. Nowadays, all major DNS servers employ one or more reliable encryption protocols: DNS-over-HTTPS, DNS-over-TLS. AdGuard also provides a [DNS service](https://adguard-dns.com/en/welcome.html), and it was the world's first to offer the very new and promising [DNS-over-QUIC](https://adguard.com/en/blog/dns-over-quic.html) encryption protocol. AdGuard has different servers for different goals. This diagram illustrates how AdGuard blocking servers work:
<img src="https://cdn.adguard.com/public/Adguard/kb/DNS_filtering/adguard_dns_en.jpg" style="border: 1px solid #efefef; padding: 2px;" />
Other DNS providers may work differently, so learn more about them before committing to this or that DNS server. You can find the list of some of the most popular DNS providers in [this article](https://kb.adguard.com/en/general/dns-providers). All AdGuard apps that support DNS functionality also have a list of DNS servers to choose from, or even allow to select any custom DNS server that you'd like.
<a id="dns-blocklists"></a>
#### Local DNS blocklists
But by relying on DNS servers only to filter your DNS traffic you lose all flexibility. If the selected server blocks a domain, you can't access it. With AdGuard, you don't even need to configure any specific DNS server to filter DNS traffic. All AdGuard products let you employ DNS blocklists, be it simple hosts files or lists that use [more advanced syntax](https://kb.adguard.com/en/general/dns-filtering-syntax). They work similarly to regular blocklists: when a DNS request matches one of the rules in the active filter list, it gets blocked. To be more precise, it gets rerouted to a "blackhole".
But by relying on DNS servers only to filter your DNS traffic, you lose all flexibility. If the selected server blocks a domain, you can't access it. With AdGuard, you don't even need to configure any specific DNS server to filter DNS traffic. All AdGuard products let you employ DNS blocklists, be it simple host files or lists that use [more advanced syntax](https://kb.adguard.com/en/general/dns-filtering-syntax). They work similarly to regular blocklists: when a DNS request matches one of the rules in the active filter list, it gets blocked. To be more precise, it gets rerouted to a "blackhole".
>In AdGuard for iOS, first you have to enable "Advanced mode" in settings in order to get access to DNS blocking.
>In AdGuard for iOS, first you have to enable "Advanced mode" in the settings in order to get access to DNS blocking.
You can add as many custom blocklists as you wish. For instance, you can use [AdGuard DNS filter](https://github.com/AdguardTeam/AdGuardSDNSFilter). It quite literally blocks everything that AdGuard DNS server does, but in this case you are free to use any other DNS server. Plus, this way you can add more filters or create custom exception rules, all of which would be impossible with a simple "use a blocking DNS server" setup.
You can add as many custom blocklists as you wish. For instance, you can use the [AdGuard DNS filter](https://github.com/AdguardTeam/AdGuardSDNSFilter). It quite literally blocks everything that the AdGuard DNS server does, but in this case, you are free to use any other DNS server. Plus, this way you can add more filters or create custom exception rules, all of which would be impossible with a simple "use a blocking DNS server" setup.
>There are hundreds of different DNS blocklists, you can look for them [here](https://filterlists.com/).
@ -60,17 +61,18 @@ You can add as many custom blocklists as you wish. For instance, you can use [Ad
Network filtering is what we call the 'regular' way AdGuard standalone apps process network traffic, hence the name. Feel free to brush up on it by reading [this article](https://kb.adguard.com/en/general/how-ad-blocking-works).
First of all, we have to mention that with AdGuard you don't have to choose. You can always use both regular network filtering and DNS filtering at the same time. However, it's important to understand key differences between the two. DNS filtering has both its unique advantages and drawbacks:
First of all, we have to mention that with AdGuard you don't have to choose. You can always use both regular network filtering and DNS filtering at the same time. However, it's important to understand key differences between the two. DNS filtering has both unique advantages and drawbacks:
**Pros of DNS filtering:**
1. On some platforms this is the only way to achieve system-wide filtering. For example, on iOS only the Safari browser supports content blocking in the familiar sense, for everything else there's only DNS filtering.
1. On some platforms, this is the only way to achieve system-wide filtering. For example, on iOS, only the Safari browser supports content blocking in the familiar sense, for everything else, there's only DNS filtering.
2. Some forms of tracking (like [CNAME-cloaked tracking](https://adguard.com/en/blog/cname-tracking.html)) can only be dealt with by DNS filtering.
3. The stage of processing a DNS request is the earliest you could possibly deal with an ad or a tracker, this helps save a little bit of battery life and traffic.
3. The stage of processing a DNS request is the earliest you could possibly deal with an ad or a tracker. This helps save a little bit of battery life and traffic.
**Cons of DNS filtering:**
1. DNS filtering is "rough", meaning that it won't remove whitespaces that are left behind a blocked ad, or apply any sorts of cosmetic filtering. Many of the more complicated ads can't be blocked on DNS level (or rather, they can, but only by blocking the entire domains which are being used for other purposes).
1. DNS filtering is "rough", meaning that it won't remove whitespaces that are left behind a blocked ad or apply any sort of cosmetic filtering. Many of the more complicated ads can't be blocked at the DNS level (or rather, they can, but only by blocking the entire domains that are being used for other purposes). 
<img src="https://cdn.adguard.com/public/Adguard/kb/DNS_filtering/dns_diff.jpg" style="max-width: 550px; border: 1px solid #efefef; padding: 2px;" />
<p align="center"><i>An example of difference between DNS and network filtering</i></p>

37
01.general/16.adguard-translations/docs.en.md
View File

@ -21,7 +21,7 @@ When it comes to translations, we at AdGuard always heavily rely on volunteers.
Now we use [Crowdin platform](https://crowdin.com/) to manage translations of our products. So this is the place to go for all the people who want to contribute to AdGuard by translating any product(s) they are interested in.
If you want to be among volunteers who help us translate AdGuard, please read the following information to learn more about how to become our translator, as well as about the way we collaborate with them.
If you want to be among the volunteers who help us translate AdGuard, please read the following information to learn more about how to become our translator and about the way we collaborate with them.
<a name="become-translator"></a>
@ -33,7 +33,7 @@ If you want to join AdGuard translators, first of all, go to [Crowdin](https://c
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/main-screen.png)
Once you are logged in, head to [our page](https://crowdin.com/profile/adguard/). You will see a few AdGuard projects, each of them contains folders for different product strings.
Once you are logged in, head to [our page](https://crowdin.com/profile/adguard/). You will see a few AdGuard projects, each of which contains folders for different product strings.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/projects.png)
@ -61,7 +61,7 @@ Suggest your version in the text box and save it.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/text-box.png)
If you don't agree with existing translations, you still can suggest your own versions. Also, you can up- and downvote suggestions made by other volunteers by clicking "plus" and "minus" buttons.
If you don't agree with existing translations, you can still suggest your own versions. Also, you can upvote and downvote suggestions made by other volunteers by clicking the "plus" and "minus" buttons.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/vote.png)
@ -70,7 +70,7 @@ Besides, there is an opportunity to open translations in a Voting mode if you ju
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/mode.png)
You can find some useful tips reading the following information. Please, have a look at it.
You can find some useful tips by reading the following information. Please have a look at it.
<a name="guidelines"></a>
@ -79,13 +79,13 @@ You can find some useful tips reading the following information. Please, have a
There are several things we'd like you to know before you start translating. It will not only save your time and effort, but also ensure that we are on the same page in terms of the meaning of the phrases being translated.
1. Pay attention to glossary terms which are highlighted with a dotted line in a source phrase. These are usually special words (like brand names) that should not be translated.
1. Pay attention to glossary terms, which are highlighted with a dotted line in a source phrase. These are usually special words (like brand names) that should not be translated.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/terms.png)
You can suggest your translation for translatable terms in the [AdGuard Glossary](https://crowdin.com/project/adguard-glossary) project.
2. The phrases on Crowdin can be accompanied by useful notes that make phrases easier to understand and translate. You can find them in the "context" field of the source string box.
2. The phrases in Crowdin can be accompanied by useful notes that make phrases easier to understand and translate. You can find them in the "context" field of the source string box.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/context-note.png)
@ -103,22 +103,23 @@ Please note that you can request context by clicking the "REQUEST" button.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/request.png)
4. Apart from suggesting new translations, you can also leave comments to phrases. Use comments to inform about any mistakes in existing translations, to make notes or to ask questions. Sometimes you will find a comment left to your translation — try to react to it.
4. Apart from suggesting new translations, you can also leave comments on phrases. Use comments to inform us about any mistakes in existing translations, to make notes, or to ask questions. Sometimes you will find a comment left on your translation—try to react to it.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/comments.png)
There's also a **Discussions** tab on the main Project page that conveniently allows you to see all comments for the specific language in this project.
There's also a **Discussions** tab on the main project page that conveniently allows you to see all the comments for the specific language in this project.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/discussions.png)
5. Crowdin provides a very useful and convenient tool called _Translation Memory_. With its help you can find the previously made translations of the same words and phrases and reuse them in your translations.
5. Crowdin provides a very useful and convenient tool called _Translation Memory_. With its help, you can find the previously made translations of the same words and phrases and reuse them in your translations.
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/tm.png)
6. As soon as you join a project by cliсking the "Join" button, you can see the **Tasks** tab on the Project page where the tasks for specific project files are created. _Please pay attention to them, they usually have a higher priority._
6. As soon as you join a project by clicking the "Join" button, you will see the **Tasks** tab on the project page where the tasks for specific project files are created. _Please pay attention to them; they usually have a higher priority._
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/tasks.png)
@ -128,7 +129,7 @@ There's also a **Discussions** tab on the main Project page that conveniently al
![crowdin](https://cdn.adguard.com/public/Adguard/kb/en/ag-translations/plurals.png)
Proper plural forms are extremely important, so please ask us in comments if anything is unclear.
Proper plural forms are extremely important, so please ask us in the comments if anything is unclear.
8. **Please do not write directly to the project managers listed in the Project info.**
@ -137,13 +138,13 @@ If you have any questions about translations, you can always ask proofreaders or
Also, you can send us an e-mail to [translate@adguard.com](mailto:translate@adguard.com) or ask a question in the [Telegram chat](https://t.me/joinchat/CBcY6Au3K0AtD35a2r1y8w). The Admins will answer you as soon as possible.
Find more information on Crowdin translation system in this [Knowledge base](https://support.crowdin.com).
Find more information on the Crowdin translation system in this [Knowledge base](https://support.crowdin.com).
<a name="proofreaders"></a>
### Proofreaders
We have Proofreaders (previously Moderators) for each language.
We have proofreaders (previously known as moderators) for each language.
What are they responsible for?
@ -153,10 +154,10 @@ What are they responsible for?
- Looking after the relevance of the translations;
- Participating in discussions in comment section etc.
- Participating in discussions in the comment section etc.
_As mentioned, you can ask proofreaders any questions regarding translations on Crowdin in comments_.
_As mentioned, you can ask proofreaders any questions translations of Crowdin in the comments_.
However, we do hope that everything for you will go smoothly and without any difficulties! Hope to see you on our team!
@ -166,10 +167,10 @@ However, we do hope that everything for you will go smoothly and without any dif
### Reward system
As every honest and well-done work should be rewarded, volunteers who actively translate on Crowdin are eligible to request a free AdGuard license key.
As every honest and well-done job should be rewarded, volunteers who actively translate on Crowdin are eligible to request a free AdGuard license key.
To request a **one-year** license key you should translate at least 500 words ONLY in phrases that **have not been translated before**.
To request a **one-year** license key, you must translate at least 500 words ONLY in phrases that **have not been translated before**.
Just send us a request to [translate@adguard.com](mailto:translate@adguard.com) and you’ll get the license key as a token of our gratitude.
Besides, the most active translators may receive a Proofreader status in future, should they express such intention, and that promises even more good stuff :)
Besides, the most active translators may receive proofreader status in the future, should they express such an intention, and that promises even more good stuff :)

16
01.general/17.dns-providers/docs.en.md
View File

@ -7,7 +7,7 @@ visible: true
---
AdGuard users can configure any DNS server to be used instead of the system default provided by the router or ISP. In this article you will find a list of popular DNS providers.
AdGuard users can configure any DNS server to be used instead of the system default provided by the router or ISP. In this article, you will find a list of popular DNS providers.
* [AdGuard DNS](#adguard-dns)
* [Yandex DNS](#yandex-dns)
@ -76,11 +76,11 @@ AdGuard users can configure any DNS server to be used instead of the system defa
### AdGuard DNS
[AdGuard DNS](https://adguard-dns.com/welcome.html) is an alternative solution for ad blocking, privacy protection, and parental control. It provides the number of necessary protection features against online ads, trackers, and phishing, no matter what platform and device you use.
[AdGuard DNS](https://adguard-dns.com/welcome.html) is an alternative solution for ad blocking, privacy protection, and parental control. It provides a number of necessary protection features against online ads, trackers, and phishing, no matter what platform and device you use.
#### Default
These servers provide blocking ads, tracking and phishing
These servers provide ads, trackers, and phishing protection:
| Protocol | Address | |
|----------------|----------------------------------------------------|----------------|
@ -121,7 +121,7 @@ These servers provide a secure and reliable connection, but they don't filter an
### Yandex DNS
[Yandex.DNS](https://dns.yandex.com/) is a free recursive DNS service. Yandex.DNS' servers are located in Russia, CIS countries, and Western Europe. Users' requests are processed by the nearest data center which provides high connection speeds.
[Yandex.DNS](https://dns.yandex.com/) is a free recursive DNS service. Yandex.DNS' servers are located in Russia, the CIS countries, and Western Europe. Users' requests are processed by the nearest data center, which provides high connection speeds.
#### Basic
@ -1228,7 +1228,7 @@ Family mode provide family oriented filtering offering the protection of "Safe"
### ControlD DNS
[ControlD](https://controld.com/) is a customizable DNS service that can be used to block unwanted categories of sites (like ads or porn), popular online services like Facebook or TikTok, or any domain of your choice.
[ControlD](https://controld.com/) is a customizable DNS service that can be used to block unwanted categories of sites (like ads or porn), popular online services like Facebook or TikTok, or any domain of your choice.
#### Unfiltered
@ -1287,7 +1287,7 @@ Family mode provide family oriented filtering offering the protection of "Safe"
### Small personal resolvers
In this section we list small, mostly personal DNS resolvers. They often have only one or very few servers and worse uptime than 'big' providers. We won't be able to proper monitor their availability. **Use them at your own risk!**
In this section, we list small, mostly personal DNS resolvers. They often have only one or very few servers and worse uptime than 'big' providers. We won't be able to properly monitor their availability. **Use them at your own risk!**
<a name="arapurayil"></a>
@ -1306,9 +1306,9 @@ Non-logging | Filters ads,trackers,phishing,etc | DNSSEC | QNAME Minimization |
#### Dandelion Sprout's Official DNS Server
[Dandelion Sprout's Official DNS Server](https://github.com/DandelionSprout/adfilt/tree/master/Dandelion%20Sprout's%20Official%20DNS%20Server) is a personal DNS service hosted in Trondheim, Norway, using an AdGuard Home infrastructure.
[Dandelion Sprout's Official DNS Server](https://github.com/DandelionSprout/adfilt/tree/master/Dandelion%20Sprout's%20Official%20DNS%20Server) is a personal DNS service hosted in Trondheim, Norway, using the AdGuard Home infrastructure.
Blocks more ads and malware than AdGuard DNS thanks to more advanced syntaxes, but goes easier on trackers, and blocks alt-right tabloids and most imageboards. Logging is used to improve its used filterlists (e.g. by unblocking sites that shouldn't have been blocked), and to determine the least bad times for server system updates. For additional important info, see the link above.
It blocks more ads and malware than AdGuard DNS thanks to more advanced syntaxes, but it goes easier on trackers and blocks alt-right tabloids and most imageboards. Logging is used to improve its used filterlists (e.g. by unblocking sites that shouldn't have been blocked) and to determine the least bad times for server system updates. For additional important info, see the link above.
| Protocol | Address | |
|----------------|------------------------------------------------------------------|------------------|

42
01.general/18.stealth-mode/docs.en.md
View File

@ -11,11 +11,11 @@ visible: true
* [Browser API](#browser-api)
* [Miscellaneous](#miscellaneous)
Many websites gather information about their visitors, such as their IP addresses, information about the browser and operating system installed, screen resolution, and even what page the user was redirected from. Some web pages use cookies to mark the browser and save your personal settings, user preferences, or “recognize” you upon your next visit. Stealth Mode safeguards your personal information from such data and statistics gathering systems.
Many websites gather information about their visitors, such as their IP addresses, information about the browser and operating system installed, screen resolution, and even what page the user was redirected from. Some web pages use cookies to mark the browser and save your personal settings, user preferences, or "recognize" you upon your next visit. Stealth Mode safeguards your personal information from such data and statistics-gathering systems.
You can flexibly adjust the work of Stealth Mode: for instance, you can prohibit the website to receive the search request you used to find it on the Internet, automatically delete both third-party and website’s own cookies, turn off browser geolocation sharing that can be used to track your whereabouts, hide your real IP-address or even indicate one of your choice.
You can flexibly adjust the work of Stealth Mode: for instance, you can prohibit the website from receiving the search request you used to find it on the Internet, automatically delete both third-party and website’s own cookies, turn off browser geolocation sharing that can be used to track your whereabouts, hide your real IP-address or even indicate one of your choice.
Below we will list and describe the main features and options you can manage in the "Stealth Mode" settings which are divided into four groups: General, Tracking methods, Browser API, and Miscellaneous.
Below we will list and describe the main features and options you can manage in the "Stealth Mode" settings, which are divided into four groups: general, tracking methods, browser API, and miscellaneous.
<a name="general"></a>
@ -23,15 +23,15 @@ Below we will list and describe the main features and options you can manage in
**Hide your search queries**
When you proceed to the website from Google, Yahoo or any other search engine, this option hides the search query you used to find it.
When you proceed to the website from Google, Yahoo, or any other search engine, this option hides the search query you used to find it.
**Send Do-Not-Track header**
Sends a Do-Not-Track (DNT) HTTP header to queried websites that requires web apps to disable tracking of your activity.
It sends a Do-Not-Track (DNT) HTTP header to queried websites that requires web apps to disable tracking of your activity.
**Remove X-Client-Data header from HTTP requests**
Forbids Google Chrome to send its version and modifications information with requests to Google domains (including Double Click and Google Analytics).
It forbids Google Chrome from sending its version and modification information with requests to Google domains (including Double Click and Google Analytics).
**Strip tracking parameters from URLs**
@ -43,20 +43,20 @@ If you enable this option, AdGuard will strip tracking parameters like utm_* and
**Self-destructing third-party cookies**
Websites store your information and preferences with cookies – e.g., they remember the language you chose, the location or even the list of goods in your cart. When you get back to the site, your browser sends back the cookies belonging to that website, which allows it to “recall” your data.
Websites use cookies to store your information and preferences, such as the language you selected, your location, or the list of items in your shopping cart. When you get back to the site, your browser sends back the cookies belonging to that website, which allows it to "recall" your data.
Third-party cookies are those implemented by a website that is different from the one you are browsing at the moment. E.g., cnn.com may have a Facebook “Like” widget on it page. This widget will implement a cookie that may be read by Facebook later on. Some advertisers use such cookies to track what other sites you visit where their ads are posted.
Third-party cookies are those implemented by a website that is different from the one you are browsing at the moment. For example, cnn.com may have a Facebook "Like" widget on its homepage. This widget will implement a cookie that may be read by Facebook later on. Some advertisers use such cookies to track what other sites you visit where their ads are posted.
Put a time period (in minutes) by the end of which all third-party cookies will be destroyed. Set the timer to 0 in order to block them completely.
Put a time period (in minutes) at the end of which all third-party cookies will be destroyed. Set the timer to 0 in order to block them completely.
**Self-destructing first-party cookies**
We do not recommend enabling this option as it may severely interfere with the work of certain sites.
Put a time period (in minutes) by the end of which all cookies will be destroyed. Set the timer to 0 in order to block them completely.
Put a time period (in minutes) at the end of which all cookies will be destroyed. Set the timer to 0 in order to block them completely.
**Disable cache for third-party requests**
When the browser addresses a page, the server assigns it an ETag, which the browser then uses to cache the contents. Upon subsequent requests it sends the ETag to the corresponding server, thus letting it learn the visitor’s identity. While the site files are cached, the ETag is sent every time your browser addresses this site. If the site has content embedded from another server (e.g., an image or iframe), that server will also be able to track your activities without your knowing it.
When the browser addresses a page, the server assigns it an ETag, which the browser then uses to cache the contents. Upon subsequent requests, it sends the ETag to the corresponding server, thus letting it learn the visitor’s identity. While the site files are cached, the ETag is sent every time your browser addresses this site. If the site has content embedded from another server (e.g., an image or iframe), that server will also be able to track your activities without your cognizance.
**Block third-party Authorization header**
@ -68,24 +68,24 @@ When the browser addresses a page, the server assigns it an ETag, which the brow
**Block WebRTC**
WebRTC (Real Time Communications) is a technology that allows streaming of data directly between browsers and apps. It can let others know your real IP address even if you use a proxy or VPN.
WebRTC (Web Real-Time Communication) is a technology that allows direct streaming of data between browsers and apps. It can let others know your true IP address, even if you use a proxy or VPN.
Enabling this option can disrupt the work of certain browser applications, such as messengers, chats, cinemas, or games.
**Block Push API**
Push API enables servers to send messages to web applications regardless of browser status. This means you may see notifications from various websites even if your browser is hidden to tray or not launched. Enable this option to block browser Push API completely.
The Push API enables servers to send messages to web applications regardless of the activity status of your browser. Thus, you may see notifications from various websites even if your browser is hidden in the tray or not launched. Enable this option to block the browser's Push API completely.
**Block Location API**
Enabling this option will prohibit the browser from sending GPS data that could be used to find your location and modify your search results or otherwise influence your web experience.
Enabling this option will prevent the browser from sending GPS data that could be used to determine your location, modify your search results, or otherwise influence your web experience.
**Block Flash**
The Flash Player plugin has become increasingly vulnerable to online threats like viruses and hackers and can also have a significant negative impact on loading time for websites. When this setting is on, AdGuard blocks browsers' ability to detect components (like plugins and ActiveXObject objects) that allow Flash to display content. This effectively means that browsers are unable to support Flash.
The Flash Player plugin has become increasingly vulnerable to such online threats as viruses and hackers; it may also significantly affect website loading time. Turning this setting on makes AdGuard block browsers' ability to detect components (such as plugins and ActiveXObject objects) that allow Flash to display content. This effectively means that browsers are unable to support Flash.
**Block Java**
Some websites and web services still use old technology of supporting Java plugins. The API, which is the basis of Java plugins, has serious security issues. You can disable such plugins for security purposes. Nevertheless, even if you decide to use "Block Java" option, Javascript will still be enabled.
Some websites and web services still use the old technology to support Java plugins. The Java plugin API, which is the basis of Java plugins, has serious security flaws. For security purposes, you can disable such plugins. Nevertheless, even if you decide to use the "Block Java" option, JavaScript will still be enabled.
<a name="miscellaneous"></a>
@ -94,16 +94,18 @@ Some websites and web services still use old technology of supporting Java plugi
**Hide Referer from third-parties**
Referer is one of HTTP headers for browser-to-server request. It contains the URL of request source. If you advance from one page to another, Referer will save the URL of the initial page. The server is often equipped with software that analyzes Referer and extracts various information from it. Enabling this option hides the current website from third-party sites by changing the HTTP header.
You can also set Referer of your choice by typing it into the Custom Referer field. Leave the field empty to use the default Referer.
Referer is an HTTP header used in browser-to-server requests. It contains the URL of the request source. If you advance from one page to another, the referer will save the URL of the initial page. The server is often equipped with software that analyzes the referer and extracts various pieces of information from it. Enabling this option hides the current website from third-party sites by changing the HTTP header.
You can also set the referrer of your choice by typing it into the Custom Referrer field. Leave the field empty to use the default referer.
**Hide your User-Agent **
When you visit a website, your browser send the server its information. It looks like a text line that is a part of HTTP request beginning with “User-Agent:”. It usually includes the name and version of the browser, operating system, and language settings. We strip User-Agent from identifying information so that advertisers can't obtain it.
When you visit a website, your browser sends the server its information. It looks like a text line that is part of an HTTP request that begins with "User-Agent:". It usually includes the name and version of the browser, the operating system, and language settings. We strip User-Agent from identifying information so that advertisers can't obtain it.
You can also set User-Agent of your choice by typing it into the Custom User-Agent field. Leave the field empty to use the default User-Agent.
You can also set the user agent of your choice by typing it into the Custom User-Agent field. Leave the field empty to use the default user agent.
**Hide your IP address**
Stealth Mode cannot hide your IP address. However, we can conceal it so that websites you visit will take you for a proxy server. Sometimes, it helps, and websites ignore your real IP.
You can set a random IP that you would like to be perceived as yours by simply typing it into the corresponding field. Leave the field empty to use the default IP address.

8
01.general/20.2FA/docs.en.md
View File

@ -8,11 +8,11 @@ visible: true
---------------------------
Two-factor authentication
---------------------------
Two-factor authentication (or 2FA) is an authentication method that requires an additional piece of evidence from the user to log in, on top of the usual login/password pair. Usually for this purpose websites use a code sent by SMS or via a special app.
Two-factor authentication (or 2FA) is an authentication method that requires an additional piece of evidence from the user to log in, on top of the usual login and password pair. Usually, for this purpose, websites use a code sent by SMS or via a special app.
We believe that adding a 2FA option is strictly positive, but we also realize that some users would be irritated by being forced into it. So we made it optional for your personal account on adguard.com, and by default 2FA will be disabled when you register a new one. You can enable it manually in the Settings. As for the available options, currently there is only one: an authenticator app for Android or iOS — a tried and tested 2FA method (you can use basically any such app, there are plenty).
We believe that adding a 2FA option is strictly positive, but we also realize that some users would be irritated by being forced into it. So we made it optional for your personal account on adguard.com, and by default, 2FA will be disabled when you register a new one. You can enable it manually in the settings. As for the available options, currently there is only one: an authenticator app for Android or iOS—a tried and tested 2FA method (you can use basically any such app; there are plenty of them).
We recommend setting up two-factor authentication for your AdGuard account. It will hardly cost you any time, but will go to great lengths to secure your license keys and, most importantly, any personal information associated with the account.
We recommend setting up two-factor authentication for your AdGuard account. It will hardly cost you any time, but it will go to great lengths to secure your license keys and, most importantly, any personal information associated with the account.
## How to set it up
@ -35,4 +35,4 @@ If everything is done right, you will see this when you log into your account th
Use your mobile authenticator app to read the code and enter it. You should be logged in now!
***NOTE***: if you get the authentication error, check the clock on your phone. Correct it if needed, asynchronized clock can be the reason you get the error.
***NOTE***: if you get an authentication error, check the clock on your phone. Correct it if needed, an unsynchronized clock can be the reason you get the error.