Как автоматизировать AdGuard для Android

Многие пользователи выбирают Android именно потому, что эта ОС позволяет настроить мобильное устройство под свои вкусы и держать всё под контролем. И это абсолютно в порядке вещей, когда пользователей AdGuard по какой-то причине не устраивает его поведение по умолчанию. Допустим, вы хотите, чтобы защита отключалась при старте определённого приложения и снова включалась при его остановке. Это задача для так называемого "таскера".

Интерфейс AdGuard

Существует множество приложений-таскеров, например, Tasker, AutomateIt и другие. AdGuard предоставляет интерфейс, с помощью которого такие приложения могут задавать всевозможные правила автоматизации.

Благодаря этому интерфейсу любое приложение может послать специальное сообщение (также называемое "intent", или "интент"), которое содержит имя действия и какую-либо дополнительную информацию. AdGuard увидит этот интент и выполнит запрашиваемое действие.

Вопросы безопасности

"А не слишком ли это опасно" — спросите вы — "предоставлять случайным приложениям доступ к функциям AdGuard?" И будете правы, именно поэтому вместе с интентом пересылается пароль. Этот пароль генерируется автоматически, но вы, конечно, можете поменять его самостоятельно в расширенных настройках AdGuard.

Доступные действия

Итак, готовы немного запачкать руки? Вот список действий, которые, будучи включёнными в интент, будут понятны AdGuard:

start — стартует защиту, дополнительные данные не нужны;

stop — останавливает защиту, дополнительные параметры не нужны;

pause — ставит защиту на паузу. Отличие от stop в том, что появится уведомление, тап по которому возобновит защиту. Дополнительные параметры не нужны;

update — проверяет наличие обновлений фильтров и приложения, дополнительные данные не нужны;

dns_filtering — включает и выключает DNS-фильтрацию. Требуется дополнительный флаг:

enable:true или enable:false — соответственно, включает или выключает DNS-фильтрацию.

dns_server — переключается между DNS-серверами, вам нужно указать дополнительные параметры:

server: adguard dns — переключается на сервер провайдера AdGuard DNS;

Полный список имен провайдеров доступен во вкладке "Свои настройки DNS" на экране DNS фильтрации

server: custom — переключается на добавленный ранее сервер с именем custom;

server: tls://dns.adguard.com — создает новый сервер и переключается на него, если добавленные ранее серверы и провайдеры не содержат сервер с таким же адресом. В противном случае переключается на соответствующий сервер. Адреса серверов можно добавлять в виде IP (обычный DNS), sdns://… (DNSCrypt или DNS-over-HTTPS), https://… (DNS-over-HTTPS) или tls://... (DNS-over-TLS);

server: 1.1.1.1, tls://1.1.1.1 — создает и переключается на сервер с адресами, указанными через запятую. При добавлении сервера через server: 1.1.1.1, tls://1.1.1.1, ранее добавленный сервер удаляется.

server:system — сбрасывает настройки DNS на "по умолчанию" (т.е. используются системные DNS серверы).

proxy_state – включает и выключает исходящий прокси. Требуется установка флага:

enable:true или enable:false — активирует и деактивирует исходящий прокси соответственно.

proxy_default – по умолчанию устанавливает прокси из списка уже существующих.

Дополнительно необходимо указать следующие параметры:

server:[name], где [name] – это имя исходящего прокси-сервера из списка.

Также вы можете настроить параметры сервера вручную:

server:[type=…&host=…&port=…&username=…&password=…&udp=…&trust=…].

proxy_remove - удаляет прокси-сервер из списка ранее добавленных.

server:[name], где [name] – это имя исходящего прокси сервера из списка.

Также вы можете настроить параметры сервера вручную:

server:[type=…&host=…&port=…&username=…&password=…&udp=…&trust=…].

• Обязательные настройки:

[type] - тип сервера:

• HTTP;
• SOCKS4;
• SOCKS5;
• HTTPS_CONNECT.

[host] - домен или IP-адрес исходящего прокси-сервера;

[port] - порт исходящего прокси-сервера (Целое число от 1 до 65535);

• Дополнительные настройки:

[login and password] - только если этого требует прокси-сервер. Эти данные игнорируются при настройке SOCKS4;

[udp] - применяется только при использовании типа сервера: SOCKS5 и включает опцию UDP через SOCKS5. Необходимо указать значение: true/false;

[trust] - применяется только для типа сервера: HTTPS_CONNECT и включает опцию Trust any certificates. Необходимо указать значение: true/false;

Пример:

настройка по имени сервера: server:MyServer

настройка вручную: server:host=1.2.3.4&port=80&type=SOCKS5&username=foo&password=bar&udp=true

Не забудьте включить пароль как доп.параметр, а также упомянуть имя пакета и класс! Это необходимо делать для каждого интента!

Параметр: password:*******

Имя пакета: com.adguard.android

Класс: com.adguard.android.receivers.AutomationReceiver

Выполнение без уведомлений

Чтобы выполнить задачу без показа тоста, добавьте в дополнительном EXTRA quiet:true

Пример интента