TYO Reach на управляемых устройствах Windows

Средства защиты конечных устройств — PractiseProtect, Microsoft Defender for Endpoint, Carbon Black и аналогичные инструменты — могут блокировать шаблоны поведения, используемые многими установщиками и приложениями. TYO Reach разработан с учётом этих ограничений. На этой странице описано, чего следует ожидать на каждом этапе.

Установка

TYOReach-Setup.exe предназначен для работы на защищённых компьютерах:

  • Приложение записывается напрямую в %LOCALAPPDATA%\TYO Lab\TYO Reach\ — без извлечения временных файлов и запуска из %TEMP%.
  • Ярлыки на рабочем столе и в меню «Пуск» создаются с помощью Windows COM API IShellLink — без запуска дочерних процессов PowerShell.
  • Запись для автозапуска добавляется в куст реестра HKCU — права администратора не требуются.

Установка для текущего пользователя (рекомендуется): запустите TYOReach-Setup.exe и выберите Install for me only (Установить только для меня). Запрос UAC не появляется, права администратора не требуются.

Установка для всех пользователей: выберите Install for everyone (Установить для всех). Появится запрос на повышение прав UAC. Если политики вашего компьютера блокируют UAC, используйте установку для текущего пользователя.

После установки приложение попытается запуститься автоматически. Если запуск заблокирован средством защиты конечных устройств, появится диалоговое окно с путем установки. Перейдите в %LOCALAPPDATA%\TYO Lab\TYO Reach\ в Проводнике и дважды щелкните tyoreach.exe, чтобы запустить его вручную. После первого запуска запись автозапуска будет запускать его при каждом входе в систему.

Вход в систему

Когда вы нажимаете кнопку входа в меню области уведомлений, TYO Reach последовательно применяет резервные механизмы, пока один из них не сработает.

Шаг 1 — Браузер открывается автоматически

На большинстве компьютеров страница входа открывается в браузере по умолчанию, и вы входите в систему как обычно. После входа браузер перенаправляет обратно на локальный адрес, и приложение в области уведомлений автоматически завершает процесс.

Шаг 2 — Копирование ссылки для входа вручную

Если средство защиты конечных устройств блокирует запуск браузера, пункт меню в области уведомлений изменится на:

Copy login link (localhost:PORT) — click to copy

Нажмите на него, чтобы скопировать URL-адрес для входа в буфер обмена, затем вставьте его в любое окно браузера и войдите в систему. Указанный порт (localhost:PORT) — это локальный адрес обратного вызова, который прослушивает приложение в области уведомлений. Браузер использует его для автоматической передачи кода авторизации после входа.

Шаг 3 — Открывается Блокнот со ссылкой

Если буфер обмена также заблокирован, TYO Reach записывает URL-адрес для входа в %TEMP%\reach-login.txt и открывает его в Блокноте. Скопируйте URL-адрес из Блокнота и вставьте его в браузер.

Шаг 4 — Диалоговое окно со ссылкой

Если Блокнот не запускается, появляется диалоговое окно с полным URL-адресом. Нажмите Ctrl+C в диалоговом окне, чтобы скопировать его содержимое, затем вставьте в текстовый редактор, чтобы извлечь URL-адрес.

URL-адрес для входа также записывается в файл журнала при каждой попытке входа — см. раздел Поиск файла журнала ниже.

Режим опроса

В стандартном процессе входа браузер перенаправляет на localhost:PORT после авторизации. Если средство защиты конечных устройств блокирует loopback-соединения из браузера, это перенаправление не происходит, и приложение в области уведомлений ждет бесконечно.

Режим опроса полностью устраняет зависимость от loopback-соединений. Вместо локального обратного вызова сервер сохраняет код авторизации, а приложение в области уведомлений запрашивает его каждые две секунды — подключение к localhost не требуется.

Чтобы переключиться в режим опроса: нажмите на пункт входа в меню области уведомлений, удерживая Ctrl (Ctrl+Клик). Название пункта изменится:

Пункт менюРежим
Sign in to TYO ReachПо умолчанию (браузер + обратный вызов на localhost)
Sign inРежим опроса (только копирование и вставка, без localhost)

Снова нажмите с зажатым Ctrl, чтобы переключиться обратно. Выбранный режим сохраняется до следующего изменения.

В режиме опроса нажатие на Sign in сразу запускает каскад с копированием, Блокнотом и диалоговым окном, описанный выше — приложение в области уведомлений не пытается открыть браузер или ждать подключения к localhost.

Поиск файла журнала

TYO Reach поочередно проверяет три расположения и использует первое, в которое может вести запись:

  1. %LOCALAPPDATA%\TYOReach\reach.log
  2. %APPDATA%\TYOReach\reach.log
  3. %TEMP%\TYOReach\reach.log

В самой первой строке журнала записывается используемый путь, например:

2026/07/19 09:14:01 [log] file: C:\Users\vicky\AppData\Local\TYOReach\reach.log

При каждой попытке входа в журнал записывается полный URL-адрес, поэтому, если все резервные варианты с буфером обмена и Блокнотом не сработали, вы можете извлечь URL-адрес прямо из файла журнала.

Устранение неполадок

СимптомЧто попробовать
Setup.exe не запускаетсяЩелкните правой кнопкой мыши → Запуск от имени администратора, или попросите ИТ-отдел добавить файл в список разрешённых
Значок в области уведомлений не появляется после установкиПерейдите в %LOCALAPPDATA%\TYO Lab\TYO Reach\ и дважды щелкните tyoreach.exe
Браузер не открывается при нажатии на кнопку входаНажмите на пункт входа с зажатым Ctrl, чтобы переключиться в режим опроса
При вставке ссылки для входа ничего не происходит (буфер обмена заблокирован)Проверьте файл %TEMP%\reach-login.txt — Блокнот должен был открыть его автоматически
Вход бесконечно зависаетПереключитесь в режим опроса; в этом режиме обратный вызов на localhost не требуется
Нигде не удается найти URL-адрес для входаОткройте файл журнала (см. выше) — URL-адрес записывается туда при каждой попытке

Все еще не получается? Свяжитесь с нами, прикрепив файл журнала, и мы поможем определить, что именно блокируется.