ИИ-агент (MCP) PRO PREVIEW
PREVIEW Примечание: MCP-сервер проходит внутреннее тестирование и ещё не выпущен. Эта страница описывает тестовую сборку: ключи, маршруты, имена инструментов и экраны приложений могут измениться до выпуска.
[General]
external-mcp-server = 127.0.0.1:6180
У движка Chute Mac, Chute iOS и Chute tvOS есть собственный MCP-сервер (Model Context Protocol). ИИ-агент — Claude Code, Codex или любой другой клиент, который понимает MCP, — подключается к нему, читает, что делает движок (состояние, политики, правила, соединения, DNS, журнал, конфигурацию), и меняет это: выбирает политику, пробует правило, переписывает раздел конфигурации, замеряет участников группы.
Он построен на маршрутах HTTP API управления и входит с тем же секретом, но это отдельный слушатель — /mcp на собственном порту: ему не нужны ни external-http-controller, ни веб-консоль. По умолчанию он выключен.
PRO Примечание: MCP-сервер входит в Chute Pro. Без лицензии движок его не запускает:
external-mcp-serverне открывает порт, а конфигурацию по-прежнему можно редактировать. Как только лицензия вступает в силу, сервер запускается без перезапуска Chute, а когда лицензии не стало, он останавливается; пробный период Chute Mac считается лицензией. Сам HTTP API управления это не затрагивает. Что тем временем показывают приложения, описано в разделе Без Chute Pro; см. также Лицензия и активация.
Для чего он
Читает агент, поэтому спрашивать можно своими словами. Например:
- «Почему
api.example.comуходит через HK-01?» — агент спрашиваетmatch_rule, который называет правило и политику, пробует исправление черезedit_user_rules, а когда оно работает, записывает его в[Rule]черезreplace_profile_section. - «Какие узлы в Auto ещё работают?» —
test_policyдля группы замеряет каждого участника по очереди и сообщает о каждом, как только он готов. - «Приложение с утра не может достучаться до сервера.» —
list_connectionsс фильтромfailed,get_logsс ключевым словом иrun_diagnosticsдля самой сети. - «Убери рекламу на этом сайте.» —
add_rewriteиadd_mitm_host, чтобы попробовать в работающем движке, а затем строки, которые стоит оставить в конфигурации.
Включение
external-mcp-server (по умолчанию: отключено)
external-mcp-server = 127.0.0.1:6180
Адрес и порт MCP-сервера. Это собственный ключ Chute: у Surge и Clash нет ничего подобного, и импорт их конфигураций его не добавляет. Адрес записывается так же, как для external-http-controller: 127.0.0.1:6180 — только для этого устройства, 0.0.0.0:6180 или *:6180 — для всех интерфейсов, [::]:6180 — для IPv6; петлёй считаются весь 127.0.0.0/8, ::1 и localhost. Адрес, который не удаётся разобрать, — ошибка конфигурации. Приложения, включая его, используют порт 6180.
Вход. Агент отправляет Authorization: Bearer <token>, и токен — тот же, что у HTTP API управления:
external-http-secret, если он есть в конфигурации;- иначе токен, который Chute генерирует и хранит в файле
control-tokenсвоей общей папки, — он генерируется, даже когдаexternal-http-controllerвыключен, и показывается в приложениях; external-http-secret = noneозначает вход без проверки и принимается только на адресе петли.
Вне петли MCP-серверу нужен явный external-http-secret: ни сгенерированного токена, ни none недостаточно. Без него сервер не запускается, а приложения показывают почему.
Он работает вместе с движком. Запускается, когда запускается Chute, и останавливается вместе с ним, поэтому агент не может ни запустить Chute, ни остановить его, ни заставить приложение переключиться на другую конфигурацию. При перезагрузке слушатель перезапускается, только если изменились его адрес или секрет, и только после того, как дописаны уже отправляемые ответы: агент, который меняет адрес самого MCP-сервера, всё равно получает свой ответ.
external-mcp-mask-secrets (по умолчанию: true)
external-mcp-mask-secrets = false
Получает ли агент пароли, ключи и токены в виде дескрипторов — см. Сокрытие секретов. Это тоже собственный ключ Chute; в конфигурацию он записывается, только когда равен false.
В приложениях
- Chute iOS: в редакторе конфигурации Внешний контроллер → MCP-сервер: переключатель, Порт, Разрешить доступ по Wi-Fi (слушать на
0.0.0.0; нужная тогда строка Секрет — это секрет HTTP API управления) и Скрывать секреты. Строка ИИ-агент (MCP) в Панели управления, под веб-консолью, показывает Работает, Не запущен или Не настроен и открывает страницу с причиной, по которой сервер не слушает, адресом для Это устройство и — вне петли — для Другие устройства, токеном (скрыт до Показать токен; нажатие на строку копирует её), разделом НАСТРОЙКА КЛИЕНТА с готовой командойclaude mcp addи JSON, и БЫСТРЫЕ ДЕЙСТВИЯ. MCP-сервер работает внутри VPN: при выключенном VPN страница сообщает, что сделает текущая конфигурация. - Chute Mac: вкладка Конфигурация главного окна → Общие → MCP-сервер: Включить MCP-сервер, адрес и порт, секрет, общий с HTTP API управления, Скрывать секреты и Состояние и настройка клиента…. Пока Chute работает, ИИ-агент (MCP)… в меню строки меню (и в меню … панели строки меню) открывает окно с состоянием, адресами, токеном (Показать, Копировать), признаком того, скрываются ли секреты, и Подключение агента: настройками для Claude Code по HTTP, для Claude Code через команду
chuteи JSON для других клиентов. - Chute tvOS: Редактирование конфигурации → ОБЩИЕ → MCP-сервер: вкл. или выкл., Адрес прослушивания (
127.0.0.1или0.0.0.0), порт и Скрывать секреты. На той же странице задаётся секрет — этоexternal-http-secretHTTP API управления: он показывается скрытым, пока вы не попросите его показать; пустое значение означает токен, который генерирует Chute, аnoneотключает вход, после предупреждения. В нём не может быть пробелов и переводов строки. Изменив его, вы меняете и вход веб-консоли и командыchute. Если выбран0.0.0.0, а секрета нет, страница сообщает, что сервер не запустится, и позволяет задать секрет прямо там. Строка ИИ-агент (MCP) в Панели управления показывает состояние, Адрес, Адрес в LAN и Токен, скрытый до выбора; на телевизоре ничего не копируется.
Быстрые переключатели — БЫСТРЫЕ ДЕЙСТВИЯ в iOS, Включить MCP / Выключить MCP и Скрывать секреты в окне Mac, MCP-сервер и Скрывать секреты на странице телевизора — меняют эти два ключа в текущем файле конфигурации и сразу применяют его; включённый отсюда сервер слушает 127.0.0.1:6180. В iOS для подписки они недоступны: следующее обновление отменило бы изменения.
Без Chute Pro
Без лицензии приложения сообщают, что серверу нужен Chute Pro, а не показывают его как неслушающий:
- Chute Mac: ИИ-агент (MCP)… в меню строки меню и в меню … панели строки меню, а также Включить MCP-сервер на странице Общие помечены капсулой PRO. Окно ИИ-агент (MCP) открывается примечанием о Chute Pro и кнопкой Получить Chute Pro, а его состояние — Нужен Chute Pro, без адреса и без токена. Включить MCP открывает окно Chute Pro вместо того, чтобы включить сервер; выключение и Скрывать секреты работают как обычно. В окне Chute Pro среди возможностей есть ИИ-агент (MCP).
- Chute iOS и Chute tvOS: строка ИИ-агент (MCP) в Панели управления и переключатель MCP в редакторе конфигурации помечены капсулой PRO. Страница состояния показывает Нужен Chute Pro и вместо адреса и токена предлагает путь к Chute Pro; включение сервера быстрым переключателем на этой странице сначала требует Chute Pro, как и другие переключатели Chute Pro в приложениях.
- Во всех трёх приложениях поля редактора конфигурации остаются доступными для правки, а уведомление со списком возможностей Chute Pro, которые в этом запуске не работали, называет MCP-сервер.
Подключение агента
По HTTP
Клиент, понимающий Streamable HTTP, подключается напрямую:
- адрес:
http://<host>:<port>/mcp— для агента на том же устройствеhttp://127.0.0.1:6180/mcp; - заголовок:
Authorization: Bearer <token>с токеном, который показывает приложение.
Для Claude Code:
claude mcp add --transport http chute http://127.0.0.1:6180/mcp --header "Authorization: Bearer <token>"
Для клиента, настраиваемого через JSON:
{"mcpServers": {"chute": {"type": "http", "url": "http://127.0.0.1:6180/mcp", "headers": {"Authorization": "Bearer <token>"}}}}
Chute iOS и Chute Mac копируют и то и другое с уже подставленными адресом и токеном. На iPhone приложение-агент на том же iPhone тоже подключается по 127.0.0.1.
Сервер реализует MCP 2026-07-28 и принимает клиентов версий 2025-11-25, 2025-06-18 и 2025-03-26. Сеансов он не хранит: каждое сообщение JSON-RPC — это один POST на /mcp, ответ на него — JSON (или, для долгих инструментов, поток событий), после чего соединение закрывается. На GET, DELETE и OPTIONS приходит 405, пакеты (массив JSON) отклоняются, тело запроса ограничено 1 МБ, одновременно обслуживается не больше 8 соединений.
Через chute mcp
Клиент, который умеет запускать MCP-серверы только как свои дочерние программы, — или клиент, в конфигурации которого не должно быть токена, — использует консольную утилиту chute как ретранслятор: chute mcp передаёт MCP-серверу каждую прочитанную строку и записывает каждый ответ обратно строкой.
claude mcp add chute -- chute mcp
{"mcpServers": {"chute": {"command": "chute", "args": ["mcp"]}}}
На Mac, где работает Chute, этого достаточно: chute mcp при каждом сообщении читает адрес и токен из файла конечной точки, поэтому находит и Chute, запущенный позже клиента. Токен берётся из первого из источников:
--token-file <path>;- переменная окружения
CHUTE_MCP_TOKEN; - только для сервера на этом Mac — файл конечной точки, затем
control-tokenв общей папке.
--url http://<host>:<port>/mcp направляет его на другое устройство. CHUTE_MCP_ENDPOINT задаёт файл конечной точки, который читать вместо стандартного. --token и --token-stdin отклоняются: стандартный ввод и есть канал MCP, а токен в командной строке попадает в конфигурацию клиента и в список процессов. Если сервер недоступен, агент получает ошибку с причиной: закрытый порт указывает на external-mcp-server, 401 — на токен.
С компьютера на iPhone или Apple TV
На устройстве включите прослушивание сети и задайте секрет:
[General] external-mcp-server = 0.0.0.0:6180 external-http-secret = a-long-random-secretВ iOS это Разрешить доступ по Wi-Fi и строка Секрет; в tvOS — Адрес прослушивания
0.0.0.0и секрет на той же странице.- Подключите VPN и прочитайте адрес в Другие устройства (iOS) или Адрес в LAN (tvOS) — например,
http://192.168.1.20:6180/mcp. На компьютере в той же сети:
claude mcp add --transport http chute-phone http://192.168.1.20:6180/mcp --header "Authorization: Bearer a-long-random-secret"или, храня секрет в файле:
chute mcp --url http://192.168.1.20:6180/mcp --token-file ~/.config/chute/phone.token
Это адрес устройства в сети, и он меняется, когда сеть выдаёт устройству другой.
Файл конечной точки
Пока MCP-сервер слушает, движок записывает в свою общую папку файл mcp-endpoint, доступный только владельцу, и удаляет его, когда сервер останавливается. Это JSON-объект из строк: running, configured, url, lan_url (вне петли), bind, port, loopback, token, anonymous и mask_secrets — то, что показывают приложения. На Mac это ~/Library/Application Support/com.R3Studio.Chute-Mac/Share/mcp-endpoint (см. Расположение файлов), благодаря чему локальному клиенту не нужны ни порт, ни токен. На iPhone и Apple TV файл остаётся в контейнере приложения: берите адрес из приложения.
Сокрытие секретов
Всё, что читает агент, уходит поставщику его модели. Поэтому по умолчанию секреты конфигурации до агента не доходят: каждый из них, где бы он ни встретился — в конфигурации и в любом другом результате, включая журнал, — заменяется дескриптором вроде <secret:password:3f9c0a1b2e>: тип и идентификатор. Адреса серверов остаются видимыми, так что агент по-прежнему видит, на какой сервер указывает узел или загрузка.
[Proxy]
HK-01 = trojan, hk.example.com, 443, password=<secret:password:3f9c0a1b2e>, sni=hk.example.com
[Proxy Group]
Sub = select, policy-path=https://sub.example.com<secret:url_secret:8d2e4f6a1c>
Что скрывается: пароли прокси, UUID, предварительно общие ключи, закрытые ключи, пароли obfs и shadow-tls и токены вроде токена MASQUE — включая ключи разделов WireGuard и AmneziaWG и узлов поставщиков прокси; пароли http-auth, external-http-secret и пароль external-controller-access; ca-p12 и ca-passphrase; ключ авторизации Tailscale; argument= скрипта; путь, запрос и пользовательская часть URL подписок, policy-path, наборов правил, модулей и #!MANAGED-CONFIG (схема, хост и порт остаются); и значения заголовков [Header Rewrite] с именами Authorization, Proxy-Authorization или содержащими token, key, secret, auth, password или cookie. Секрет короче 8 символов заменяется там, где он стоит как значение поля, но не в свободном тексте вроде строки журнала, где его не отличить от обычного слова.
Обратная запись. Когда агент записывает текст конфигурации обратно, оставленный как есть дескриптор снова становится значением, которое он заменяет, поэтому агент может поменять порт узла, переименовать его или переставить раздел, не зная пароля. Дескриптор можно также переносить и копировать, но с двумя ограничениями:
- он возвращается только в поле того же типа — дескриптор пароля в поле пароля;
- строка должна вести на тот же сервер, откуда взят секрет: сервер прокси, хост URL или тот же ключ
[General].
Дескриптор в другом месте — в строке для другого сервера, в правиле, выдуманный или устаревший (см. ниже) — отклоняется с номером строки и причиной, и ничего не применяется: это значение вам нужно ввести самим. Новый секрет, который агент выписывает целиком, принимается как есть; разумеется, к этому моменту он уже в контексте агента.
Одно и то же значение всегда получает один и тот же дескриптор, так что агент видит, что у двух узлов общий пароль. Дескриптор действует, пока жив выдавший его процесс, — пока Chute Mac не завершится или пока VPN Chute iOS или Chute tvOS не отключится; после этого он отклоняется, и агент перечитывает конфигурацию.
Сокрытие касается секретов конфигурации. Учётные данные в вашем собственном трафике — cookie сайта, заголовок Authorization, отправленный приложением, — не секреты конфигурации и не скрываются; это ещё одна причина, по которой их выдают только по явному запросу (см. ниже).
Отключение. external-mcp-mask-secrets = false — или переключатель Скрывать секреты в приложениях — отдаёт агенту каждый секрет как есть, и агенту об этом сообщается. Делайте так, только если согласны, что эти учётные данные попадут в контекст поставщика модели агента.
Сторонний контент
Заголовки и тела запросов и ответов, строки журнала, вывод скриптов и текст модуля, загруженного по URL, написаны другими — сайтом, приложением, владельцем сервера. Веб-страница может содержать текст, составленный так, чтобы выглядеть как указания агенту. Поэтому:
- по умолчанию инструменты возвращают только метаданные: хосты, URL, порты, политики, правила, имена процессов, объёмы в байтах, время и состояние;
- содержимое приходит, только если агент явно его просит —
get_connectionсinclude,get_logs,run_script,get_module, — и приходит под ключомuntrusted, который агенту велено читать как данные, а не как указания.
Это держит контекст агента чистым и расход токенов небольшим; контролем доступа это не является. Агент с токеном может напрямую вызвать HTTP API управления и прочитать всё.
Инструменты
Каждый инструмент помечен одним из четырёх видов, по которым клиенты решают, о чём спросить вас перед вызовом.
Только чтение
| Инструмент | Что делает |
|---|---|
get_status |
Работает ли движок и как: режим исходящего трафика, переключатели, TUN, слушатели, память, соединения, как завершился предыдущий запуск |
get_network_summary |
Сеть, в которой находится устройство, — тип, имя Wi-Fi, маршрутизатор, — приостанавливает ли там Chute настройка SSID, и адреса устройства |
get_traffic |
Байты вверх и вниз и текущие скорости |
list_policies |
Группы с текущим выбором, узлом, к которому они ведут, и его задержкой; group — одна группа целиком, detail — все участники |
get_policy |
Строка конфигурации политики и что движок знает о ней сейчас: сервер, порт, UDP, задержка, куда она ведёт |
list_rules |
Правила в порядке сопоставления и откуда каждое; filter сужает список |
match_rule |
Какое правило и какую политику выбрал бы запрос, до и после разрешения имени, без отправки запроса |
list_user_rules |
Правила, добавленные во время работы движка |
list_connections |
Открытые или записанные соединения, только метаданные; фильтры по хосту, процессу, политике или неудаче |
get_connection |
Одно соединение; заголовки и тела — только если названы в include |
get_logs |
Строки журнала движка, по минимальному уровню и ключевому слову |
get_events |
Заметные моменты этого запуска; after — только новые |
list_dns_cache |
Записи DNS и сервер, ответивший на каждую |
query_dns |
Разрешает имя собственными резолверами движка и сообщает, какой ответил |
geoip_lookup |
Страна и ASN адреса или имени |
get_profile |
Работающая конфигурация постранично, с её revision |
list_profile_sections |
Разделы конфигурации, у каждого — ревизия и можно ли его записать |
get_profile_section |
Текст и ревизия одного раздела |
validate_profile |
Разбирает конфигурацию так, как это сделала бы перезагрузка, не применяя её |
get_log_level |
Уровень журнала и журналируемые разделы |
list_scripts |
Скрипты generic, которые может запустить run_script |
list_rewrites |
Действующие правила перезаписи и имитации ответа, а также список хостов MitM |
list_mitm_hosts |
Хосты, которые расшифровываются |
list_modules |
Загруженные модули, их идентификаторы и включён ли каждый |
get_module |
Текст одного модуля |
list_external_resources |
Наборы правил, поставщики правил, поставщики прокси и модули, получаемые извне: когда каждый обновлялся, сколько записей дал, последняя ошибка |
get_tailscale |
Узел Tailscale: идентичность, выходной узел, DERP, пиры с detail |
watch_events |
Следит за событиями движка 1–60 секунд и возвращает их все |
Проверки
Эти инструменты отправляют собственный трафик.
| Инструмент | Что делает |
|---|---|
test_policy |
Один HTTPS-запрос через политику, с кодом состояния и временем; для группы — каждый участник, по одному |
test_policies |
Несколько политик или все, по одной |
ping |
ICMP или время открытия TCP-соединения, прямо с устройства |
egress_probe |
Собственный адрес этого устройства в его физической сети |
internet_test |
Один запрос к internet-test-url без прокси: есть ли интернет вообще |
run_diagnostics |
Состояние движка, проверка интернета, адрес выхода и DNS-запрос по шагам, затем отчёт |
Время, которое test_policy сообщает для участников группы, — это обмен по HTTPS туда и обратно; собственная проверка группы обычно запрашивает URL по простому HTTP, поэтому цифры отличаются от тех, по которым выбирает группа. Собственная проверка группы запускается после и выбирает как обычно.
Настройки
| Инструмент | Что делает |
|---|---|
set_outbound_mode |
По правилам, глобальный или прямой |
select_policy |
Участник группы select или глобальный выбор (GLOBAL); автоматические группы выбирают сами и отказывают |
set_feature |
MitM или запись трафика — вкл. или выкл. |
set_log_level |
Уровень журнала и журналируемые разделы, без перезагрузки |
edit_user_rules |
Заменяет, дополняет или очищает правила времени выполнения; одна строка, не являющаяся правилом, отменяет всё изменение |
add_mitm_host, remove_mitm_host |
Список хостов MitM |
add_rewrite, remove_rewrite |
Правило перезаписи URL, заголовка или тела либо имитации ответа, записанное как строка конфигурации |
set_modules_enabled |
Включает или выключает модули |
update_external_resource |
Немедленно загружает набор правил, поставщика правил или поставщика прокси |
replace_profile_section |
Заменяет раздел конфигурации (или добавляет его) и перезагружает |
replace_profile |
Заменяет всю конфигурацию и перезагружает |
Разрушительные
| Инструмент | Что делает |
|---|---|
reload_profile |
Отменяет изменения времени выполнения: перезаписи, хосты MitM и переключатели модулей возвращаются к конфигурации |
kill_connection |
Закрывает одно открытое соединение; приложение на другом конце видит обрыв |
flush_dns |
Очищает кеш DNS или запись одного имени |
run_script |
Запускает один из скриптов generic конфигурации и возвращает его вывод |
Как отвечают инструменты
- По умолчанию — сводка. Инструменты-списки дают ключевые поля каждой записи;
detail: true— все поля, ценой большего числа токенов. - Страницы. Длинные списки и тексты принимают
offsetиlimitи возвращаютnext_offset, пока есть продолжение. - Не больше 256 КБ. Результат крупнее обрезается по записям или строкам, никогда посреди них, и содержит
truncated: trueсnext_offsetдля продолжения — приходит всегда корректный JSON. - Ошибки словами. Инструмент, который не справился, объясняет причину фразой, с которой агент может что-то сделать, а не голым кодом состояния.
Как долго действует изменение
На Chute iOS и Chute tvOS любое изменение делается только в работающем движке. Ничего не записывается ни в файл конфигурации, ни в собственные настройки приложения, поэтому перезапуск возвращает то, что там записано, как и у веб-консоли.
На Chute Mac приложение сохраняет эти изменения так же, как сохраняет такие же изменения из собственных меню, и они переживают перезапуск — вносит ли их агент, веб-консоль, команда chute или HTTP API управления:
- режим исходящего трафика и выбор политик, включая глобальный (
set_outbound_mode,select_policy): приложение их запоминает; - MitM и запись трафика (
set_feature): записываются в текущий файл конфигурации; - сама конфигурация (
replace_profile,replace_profile_section): записывается в текущий файл конфигурации, а затем применяется так же, как её применяет Сохранить и применить в приложении.
Их результаты содержат persisted: true, и описания, которые читает агент, заранее говорят ему об этом. Запись конфигурации отклоняется, и ничего не записывается, в таких случаях:
| Ситуация | Код | Что делать |
|---|---|---|
| В главном окне есть несохранённые изменения | user_editing |
Сначала сохраните или отмените их в приложении |
| Файл конфигурации изменён вне Chute | file_changed |
Сначала перезагрузите его в Chute |
| Текущая конфигурация — не локальный файл | profile_missing |
— |
| Приложение показывает диалог | needs_user_action |
Ответьте на него и повторите |
Конфигурация, которую отклонил движок, в файл тоже не записывается. Если приложение не закончило за 10 секунд, агент получает host_busy: изменение ещё может вступить в силу, поэтому агент сначала заново читает состояние и лишь потом пробует снова. Стоит знать: set_feature сразу переключает MitM или запись трафика и записывает переключатель в файл, но не перезагружает конфигурацию, поэтому текст и revision, которые get_profile вернёт сразу после этого, остаются прежними до следующей перезагрузки.
На всех платформах уровень журнала, перезаписи, хосты MitM, переключатели модулей и правила времени выполнения действуют только в этом запуске, а перезагрузка конфигурации из приложения тоже отменяет перезаписи, хосты MitM и переключатели модулей. reload_profile отменяет перезаписи, хосты MitM и переключатели модулей без перезагрузки; уровень журнала, переключатель соединений из LAN в приложении, режим исходящего трафика и выбор политик остаются как есть. Правила времени выполнения из edit_user_rules переживают перезагрузку и исчезают, когда движок останавливается.
Правка конфигурации
Просите агента менять конфигурацию по разделам: get_profile_section читает раздел и его ревизию, replace_profile_section записывает его обратно с этой ревизией. Если раздел за это время изменился, запись отклоняется, и агенту предлагают перечитать его; изменение другого раздела не мешает, так что два агента могут править разные разделы. Пара для всего файла, get_profile и replace_profile, работает так же с revision всей конфигурации, но большая конфигурация не помещается в один ответ, а replace_profile принимает не больше 1 МБ.
- Раздел со строкой
#!include, все разделы после него и раздел со строкой#!MANAGED-CONFIGтак записать нельзя. - Записанный раздел перечитывается из перезагруженной конфигурации: значения
[General]и[MITM]выписываются так, как их пишет Chute, а ключи[WireGuard …]переупорядочиваются, поэтому текст может отличаться от отправленного. В ответе — новая ревизия для следующего раза. - Конфигурация, которую Chute отклоняет, не применяется; агент получает причину. Для управляемой конфигурации следующее управляемое обновление заменит изменение.
Ход выполнения долгих инструментов
test_policy для группы, test_policies, run_diagnostics и watch_events сообщают о ходе работы. Клиент, который запрашивает ход выполнения (progressToken) и принимает поток событий, получает по одному notifications/progress на участника, политику, шаг или событие, затем результат, и поток закрывается; остальные клиенты получают только результат, когда инструмент закончит. Долгий инструмент работает не больше 60 секунд и затем возвращает то, что есть; одновременно передаётся не больше четырёх потоков. Клиент, закрывший поток, отменяет вызов; уже отправленные замеры всё равно доходят до конца и обновляют группу.
Безопасность
- Токен — это полный контроль. У кого он есть, тот может читать вашу конфигурацию, историю соединений и журнал, менять маршрутизацию и запускать ваши скрипты, — и это ещё и токен HTTP API управления. Не держите его в общих файлах и на снимках экрана; чтобы сменить его, задайте
external-http-secretновое значение. - Прослушивание сети позволяет попытаться каждому устройству в этой сети. Соединение идёт по простому HTTP, так что токен проходит по сети незашифрованным, а неудачные попытки не блокируются: используйте длинный случайный
external-http-secret, только в сетях, которым доверяете, и после работы возвращайтесь к127.0.0.1. run_scriptвыполняет код. Он запускает только скрипты generic, заданные в конфигурации, но всё, что делает скрипт, — запросы, сохранённые значения, уведомления — происходит, когда этого просит агент. Агент, которому разрешено записывать конфигурацию, может ещё и добавить скрипт, а потом запустить его; смотрите, что он меняет.- Веб-страницы не пускаются. Запрос с
Originвеб-страницы, отличной от самого сервера, отклоняется с403, а заголовки для чужих источников не отправляются, поэтому сайт, который вы открыли, не может добраться до сервера через ваш браузер.
Эта страница — перевод английской версии. При расхождениях приоритет имеет английская версия.