Section rules

[Alex302]

Section rules

To report a problem you need to use the reporting tool. The further problem solving will be conducted on GitHub. You will need an account to participate in discussions.

You can create a new topic on the forum if the following requirements are complied with:

1. It is necessary to create a new topic for every problem (you can write about the same type of problem in the existing topic by providing a link to the report. And you should also give a link to the topic of forum in your report);
   
2. The topic name should contain a website address, where the problem was detected
   
   Topic name format: a.website.address
   For example: example.org
   If a website or an app has adult content, add [NSFW] to the end of the topic name.
   For example: example.org [NSFW]
   
3. A message text should contain a link to the report, which was created by the reporting tool.

Please note, that the topics issued without respecting the requirements will be ignored and closed.

It is strongly recommended to add the following data to the user's signature:

• a product name (AdGuard for Windows/Mac/Android/iOS, Browser extension, Content Blocker);
• a browser's name and a version;
• a list of enabled filters.

Example:

AdGuard for Windows, Chrome 61
My filters: Filters: Russian, English, German, Spy, Social, Experimental

Code:

[SIZE=2][B][COLOR="#000000"]AdGuard for Windows, Chrome 61
My filters: Filters: Russian, English, German, Spy, Social, Experimental[/COLOR][/B][/SIZE]

For those websites, whose pages are not available without authorization, and registration is complicated by the necessity of the specific information input (invites, e-purses, phone number), you need to provide login details (test account).

Some useful information

How to collect a log?

Spoiler

1. In the Adguard application go to the Settings->Advanced>Logging level
and select requested(usually we need "Record HTTP requests") mode:

• Default

• Record HTTP requests

• Record everything

• Errors only

Screenshots:

Spoiler

2. Send the log (two ways)
a. to our Support from Adguard application

Spoiler

The ticket number should be placed in the topic.
b. or you can manually upload the log file from one of the pathes depending of device:

/storage/emulated/Android/data/com.adguard.android/cache/log
/sdcard/Android/com.adguard.android/cache/log or
/sdcard/data/Android/com.adguard.android/cache/log or
/sdcard/Android/data/com.adguard.android/

2. How to capture traffic of the site or the application?

Spoiler

1. Download and install Fiddler
http://www.telerik.com/download/fiddler
2. Configure Fiddler:

• Enable HTTPS decryption
  Spoiler

  

Spoiler

• Allow remote connections to Fiddler

Spoiler

3. Find your local IP address(of PC with Fiddler)

Spoiler

or
http://www.iphone-to-ipad.com/blog/find-ip-address-windows-7.html
4. Disable caching

Spoiler

Now you can work with traffic of the local machine (browsers, some applications)
5. Configure proxy:
For remote devices only(for example, smartphone). Skip it, if you work with the local machine.

• Adguard settings

Go to the advanced settings
Tap Proxy settings
Enter your ip information - local IP address of PC with Fiddler and port like in Fiddler settings(3128)

Spoiler

Tap OK and restart protection.

• iOS

WiFi settings:

Spoiler

then open in browser:
http://fiddler_ip:port/
and download Fiddler root certificate

Spoiler

Open the FiddlerRoot.cer file, trust it and install

Spoiler

Detailed description:
http://docs.telerik.com/fiddler/Configure-Fiddler/Tasks/ConfigureForiOS


6. Done. Now you can see requests from your smartphone in Fiddler.

*. If it is required, you can save requests and place on in the topic
File->Save->All sessions

Spoiler

The resulting file has *.saz extension. It should be uploaded to the topic.

 

[avatar]

Here is a short QA on the policy change.

1. Why did you do it? Reporting to the forum is so much easier.

It is very hard to make everybody follow the rules we have for forum submissions. So we're getting tons of semi-empty reports which slow us down and makes you unhappy.

Reporting tool aggregates all the necessary information and really helps us in solving all the issues.

2. It's inconvenient to fill AdGuard configuration fields every time.

This is temporary.

First of all, we'll integrate the reporting tool into every AG product, so you'll be able to report an issue with a couple clicks.
Also, once this feature is implemented, you'll be able to save the report URL with all the fields pre-filled and reuse it for the next reports.