ApxRelay · Помощь

Получение доступа

Android и Windows вне домена: пользователь указывает HTTPS-адрес API и почту. Клиент сам создаёт ключ, сохраняет его зашифрованным и отправляет заявку. Администратор разрешает Рабочий, Общий или оба профиля. Устройство получит настройки при следующем запуске или периодической проверке. Почта — контакт заявки; одобрение администратора обязательно, даже если настройки пользователя подготовлены заранее.

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

Ключ для личного кабинета и QR выдаётся при открытии «Ключ устройства» или «Ключ пользователя» в карточке. Для зарегистрированного Android/Windows это дополнительный ручной ключ: автоматическая авторизация приложения сохраняется. Повторный просмотр показывает тот же ключ, который хранится зашифрованным. Скопируйте его и нажмите «Открыть личный кабинет» для входа в /user. Одобрение администратора остаётся обязательным; для подготовленного пользователя есть «Разрешить доступ» в карточке. Постоянный ID записи показан отдельно: ключ является секретом доступа. «Заменить ключ» после подтверждения отключает прежний ручной ключ и QR. Если старый ключ до версии 0.9 сохранился только как хеш, требуется явный перевыпуск; автоматической замены нет. Приватный ключ подписи клиента сервер не получает.

Уведомления: настройте SMTP, Telegram, Matrix или несколько каналов в разделе «Сервис». Заявки одобряются в карточке устройства внутри «Пользователей и ПК».

«Пользователи и ПК» — компактный список с поиском по имени, почте, фрагменту ключа, IP, ОС и VPN-серверу. Фильтр доступа помогает найти заявки, ожидающие решения. На странице показано до 25 пользователей / компьютеров. Почта открывает общие подключения и вложенные устройства; нажатие на устройство — его адреса, разрешения, ключ, QR и историю. Доменный ПК показан отдельной строкой по имени, пока администратор явно не объединит его с пользователем. Автообновление сохраняет поиск и выбранную страницу. В карточке устройства и строке доменного ПК видны первые 16 символов существующего ключа: relay_ и ещё 10 символов. По этому фрагменту из служебного раздела клиента можно найти устройство. Полный ключ открывается отдельно кнопкой «Ключ устройства» или «Ключ пользователя». Списки не выдают ключи; после первого открытия ключа в карточке появится его фрагмент. Повторный просмотр не перевыпускает ключ.

Рабочий и Общий

Рабочий — доступ к ресурсам компании. Общий — доступ в интернет, обычно маршрут 0.0.0.0/0. DNS, сети, проверки, DoH/DoT, начальные IP и исключение подключённой LAN настраиваются один раз для всех пользователей и устройств в разделе «Сетевые профили». Для каждого из двух профилей свои настройки.

В карточках устройств и пользователей меняются только VPN-подключения и подписки. Администраторские настройки клиент может просматривать; личные подключения — редактировать. IP, CIDR и проверочные IP:порт можно вводить через пробел, запятую или перенос строки.

Проверка доступа без VPN выполняется только в Рабочем и только из локальной сети. На мобильном интернете VPN подключается всегда. Для успешной проверки достаточно доступного TCP-порта хотя бы одного из трёх хостов. Ping — дополнительная диагностика.

В Android 0.6.1 для Общего можно включить «Свои настройки общего профиля»: личные DNS, сети и проверки сохраняются при обновлении API. Рабочие настройки и выданные подключения защищены от изменений.

Подключения и подписки

Поддерживаются AWG / WG .conf, несколько конфигов в файле, VPN-ссылки и ссылки подписок x-ui. Название берётся после # или из имени файла. Интервал обновления, включение и удаление задаются отдельно у каждой подписки.

SSTP: обязательны название и адрес сервера host:port. Если логин или пароль не выданы, приложение запросит их при попытке подключения. Флажок «Сохранить» сохраняет данные зашифрованными только на устройстве. Без флажка данные действуют до отключения. Пароль не уходит в API. В меню SSTP можно забыть сохранённые данные.

Пользователь входит на /user по своему ключу. Ключ пользователя выдаётся в его карточке, ключ устройства — в карточке устройства. Для подготовленного пользователя по почте личные подключения приходят на все его одобренные устройства; история по ключу пользователя включает эти устройства. По ключу устройства видна только его история. Изменения личных подключений приходят автоматически при отключённом VPN; ручные подключения, добавленные только в приложении, сохраняются.

Доменный Windows / GPO

В «Сервисе» создайте отдельный ключ интеграции. Сервис подготовки обращается к API по HTTPS. Для доменного компьютера заранее задайте подключения и разрешённые профили:

PUT /integration/v1/computers/example.local/PC-001
Authorization: Bearer APXI_INTEGRATION_KEY
Content-Type: application/json

{
  "profiles": ["work", "general"],
  "profile": {
    "version": 1,
    "servers": [{
      "id": "office", "name": "SSTP компании",
      "protocol": "sstp", "host": "vpn.example.org:443"
    }]
  }
}

Ответ содержит management: сохраните этот объект как management.json и разверните рядом с relay-core.exe через GPO или установщик. Используйте имена компьютеров из AD, домен — DNS-имя AD. Ключ интеграции остаётся на сервисе подготовки, на клиент его передавать нельзя.

{
  "url": "https://apxrelay.postklb.com",
  "provisionToken": "apxp_...",
  "allowShortName": true
}

Одноразовый код привязан к конкретному домену и имени компьютера и действует 90 дней. Ограничьте права чтения management.json: SYSTEM и администраторы. Клиент создаёт собственный ключ и автоматически получает подготовленные настройки; уведомление о новой заявке не требуется. Имя компьютера само по себе не подтверждает устройство, поэтому автоматическое связывание использует код из защищённой GPO. Уже привязанный компьютер при обновлении настроек сохраняет ключ. Перевыпуск кода до привязки заменяет прежний код.

Для ссылок подписок используйте POST /integration/v1/import с тем же ключом интеграции и телом {"url":"https://subscription.example.org/token"}. Ответ servers вставьте в profile.servers запроса подготовки. Ссылка сохраняется для автообновления клиентом. Для каждого URL интервал задаётся в profile.subscriptionUpdate.sources: ключ — URL, значение {"hours":6,"disabled":false}. Поле disabled здесь выключает автообновление, а не доступ к подключению.

Для подготовки пользователя до первого запуска:

PUT /integration/v1/users/person%40example.org
Authorization: Bearer APXI_INTEGRATION_KEY
Content-Type: application/json

{ "profiles": ["work"], "profile": {
  "version": 1, "servers": [{
    "id": "office", "name": "SSTP компании",
    "protocol": "sstp", "host": "vpn.example.org:443"
  }]
}}

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

# На доверенном сервисе подготовки / в сценарии развёртывания:
$headers = @{ Authorization = "Bearer $env:APX_INTEGRATION_KEY" }
$response = Invoke-RestMethod -Method Put `
  -Uri "https://apxrelay.postklb.com/integration/v1/computers/example.local/PC-001" `
  -Headers $headers -ContentType 'application/json' `
  -Body (Get-Content profile-request.json -Raw)
if ($response.management.provisionToken) {
  $response.management | ConvertTo-Json | Set-Content management.json -Encoding UTF8
}
# Install-Windows.ps1 -ManagementConfig management.json
# Первая установка службы выполняется администратором / SYSTEM через GPO.
# Повседневная работа пользователя прав администратора не требует.

API подключений · с версии 0.9.1

Ключ интеграций из «Сервиса» позволяет получить список устройств и менять отдельные подключения без замены профиля. Во всех запросах используйте Authorization: Bearer КЛЮЧ_ИНТЕГРАЦИИ. Сетевые настройки, права, ключи устройств и коды GPO эти операции сохраняют. Личные подключения пользователя не затрагиваются.

GET /integration/v1/devices?limit=100&offset=0&q=PC-001

Поиск q — по домену, имени, почте и фрагменту ключа, без учёта регистра. limit — от 1 до 500, по умолчанию 100. Ответ: items (id, identity, email, state, profiles, revision, необязательные ownerEmail и keyPrefix), total, offset и limit. С версии 0.10.4 keyPrefix содержит первые 16 символов существующего ключа; capabilities.deviceKeyPrefix сообщает о поддержке. Полных ключей, хешей, истории и конфигов в списке нет.

Сопоставление извне по фрагменту из приложения — с ключом интеграции:

GET /integration/v1/devices?q=relay_AbCdEf0123

Полный существующий ключ — отдельным запросом с ключом администратора:

GET /admin/devices/{id}/client-key
Authorization: Bearer КЛЮЧ_АДМИНИСТРАТОРА

Поле key содержит полный ключ. GET только читает (404, если нет восстановимого ключа). PUT по тому же адресу возвращает существующий или создаёт недостающий ключ, сохраняя одобрение и авторизацию приложения. Старый ключ только с хешем — 409, без автоматической замены. POST явно перевыпускает ручной ключ. Ключ интеграции не даёт доступа к этим методам.

Выберите BASE существующего получателя:

/integration/v1/devices/{id}/connections
/integration/v1/computers/{AD-domain}/{computerName}/connections
/integration/v1/users/{email}/connections
GET    BASE                  Список подключений
POST   BASE                  Добавить к имеющимся
GET    BASE/{connectionId}   Получить один конфиг
PATCH  BASE/{connectionId}   Изменить переданные поля
PUT    BASE/{connectionId}   Заменить только этот конфиг
DELETE BASE/{connectionId}   Удалить только этот конфиг

POST принимает один конфиг или объект {"servers":[...]} с несколькими, например ответ /integration/v1/import. ID можно назначить самому или пропустить для автогенерации. До 32 записей на профиль; SSTP остаётся последним резервом. Повтор ID — ошибка 409, остальные подключения сохраняются.

POST BASE
Content-Type: application/json

{"id":"office-sstp","name":"Офис","protocol":"sstp","host":"vpn.example.org:5555"}

PATCH BASE/office-sstp
Content-Type: application/json

{"name":"Офис — резерв","disabled":true}

DELETE BASE/office-sstp

PATCH сохраняет неуказанные поля, включая ключи и пароль, а вложенные объекты объединяет. null удаляет необязательное поле; ID менять нельзя. PUT требует полный конфиг только заменяемой записи; пропущенные необязательные поля очищаются. Удалить последнюю запись можно, сам профиль и его доступ сохранятся.

Список и успешная запись возвращают id, sourceId, revision и servers. GET одной записи возвращает server вместо servers. Ответы connections содержат полные конфиги, включая приватные VPN-ключи и заданные пароли. Ключ интеграции остаётся на доверенном сервисе автоматизации.

Если устройство наследует профиль пользователя, sourceId указывает на пользователя. Изменение через адрес устройства создаст индивидуальную копию. Для изменения общего списка пользователя используйте users/{email}/connections. Для узлов подписки содержимое задаётся самой подпиской: удалённый узел может вернуться при её обновлении; отключение выполняется через disabled:true.

Записи атомарны: параллельные добавления не теряют друг друга. Для защиты прочитанной версии передайте ETag из GET в заголовке If-Match при записи. Если версия изменилась — ответ 412, получите список заново. Ошибки: 400 — неверные поля/лимит; 401 — ключ; 404 — получатель/подключение не найдено; 409 — занятый ID; 413 — тело больше 2 МиБ.

Прежний PUT подготовки профиля сохраняет прежнее поведение: заменяет его целиком. Для добавления к уже существующему профилю используйте POST connections. Полная справка с curl также есть в INTEGRATIONS.md архива сервиса.

export APX_API='https://apxrelay.postklb.com'
base="$APX_API/integration/v1/computers/example.local/PC-001/connections"
# APX_INTEGRATION_KEY задаётся через переменную сервиса.
curl --fail-with-body -H "Authorization: Bearer $APX_INTEGRATION_KEY" "$base"
curl --fail-with-body -X PATCH -H "Authorization: Bearer $APX_INTEGRATION_KEY" \
  -H 'Content-Type: application/json' "$base/office-sstp" \
  --data '{"disabled":true}'

Telegram-прокси · прямые привязки

Можно назначить несколько прокси одновременно, в том числе разных типов: MTProxy, WEB и SOCKS5. В разделе «Telegram-прокси» добавьте название и ссылку, отметьте пользователей или устройства. Ролей нет. Устройства наследуют ссылки своего пользователя; собственные назначения добавляются к ним. Выдача не зависит от Рабочего / Общего.

В карточке получателя кнопка «Telegram-прокси» открывает список привязок. Выключенные записи не выдаются. Снятие собственной привязки не отменяет унаследованную; её меняют в карточке пользователя. Клиент не может назначать себе чужие ссылки.

GET/POST /integration/v1/telegram-proxies
GET/PUT/PATCH/DELETE /integration/v1/telegram-proxies/{id}
GET/PUT /integration/v1/devices/{id}/telegram-proxies
GET/PUT /integration/v1/users/{email}/telegram-proxies
GET/PUT /integration/v1/computers/{domain}/{computer}/telegram-proxies

У ссылки recipients — массив ID получателей. PUT привязок принимает {"proxyIds":["web","socks"]}; [] снимает собственные назначения. Подробности и curl — PROXIES.md. Старые /roles перенесены в прямые назначения при обновлении.

В приложении и /user нажмите название: Telegram предложит сохранить прокси. WEB требует совместимой версии Telegram. Relay убирает недоступные ссылки при успешной синхронизации; уже сохранённые прокси администратор отзывает самостоятельно. Внешний API TELEMT не используется.

Matrix-бот и E2EE

В «Сервис → Matrix» включите режим бота и E2EE. Укажите HTTPS homeserver, Room ID уже зашифрованной комнаты, MXID бота, Device ID его токена, access token и список MXID администраторов. Пригласите бота в комнату. «Проверить состояние бота» показывает подключение и отпечаток ключа устройства.

!relay pending
!relay approve ID work
!relay approve ID general
!relay approve ID both
!relay reject ID
!relay status ID
!relay help

Команды принимаются только от заданных администраторов в заданной комнате после успешного расшифрования и проверки устройства. Открытый текст, старые события, повторные решения и пересланные ключи не принимаются. По умолчанию нужно доверие cross-signing; разрешение непроверенных устройств снижает эту защиту. Отката в открытый текст нет. Сохраняйте matrix-*.db вместе с data, relay.db и master.key. Токен и Device ID должны соответствовать одному постоянному устройству бота. Подробности: MATRIX.md.

С API 0.10.6 повторный перенос из пустого источника отклоняется: получатель не изменяется. Если профиль уже затёрт в 0.10.5, импортируйте исходные .conf заново. Пустой редактор теперь открывается без ошибки map. В карточке устройства есть «Открыть профиль пользователя» и с API 0.10.8 «Объединить с подключениями пользователя»: подключения обеих сторон сохраняются в общем списке по почте. Ключ, одобрение и история сохраняются. Объединение: POST /integration/v1/devices/{id}/connections-inheritance. Прежний DELETE connections-override остаётся отдельной операцией снятия индивидуального списка для старых интеграций.

Одна почта, несколько устройств и перенос

Подключения пользователя по почте получают все его одобренные устройства без собственного списка. В карточке показан владелец подключений. «Настроить подключения» открывает унаследованный профиль пользователя; отдельный список устройства имеет приоритет.

После очистки телефона появится новый ключ и новая заявка. В карточке старого устройства нажмите «Копировать / перенести», выберите пользователя по почте и действие: копировать или переместить. Можно добавить подключения к существующим или заменить список. Затем одобрите новую заявку. Отозванные устройства не восстанавливаются автоматически.

Переносятся выданные подключения и подписки с интервалами обновления. Ключ устройства, история, одобрение, личные подключения и Telegram-прокси не копируются. При перемещении источник очищается. Для одновременного WG/AWG на нескольких устройствах нужны отдельные ключи/пиры VPN-сервера.

POST /integration/v1/connections/transfer
{"sourceId":"ID_ИСТОЧНИКА","targetEmail":"person@example.org","profiles":["work","general"],"mode":"copy","conflict":"append"}

Цель: ровно одно из targetEmail, targetId существующего устройства/пользователя или targetComputer: {domain, computerName}. mode: copy/move; conflict: append/replace. Необязательные sourceRevision и targetRevision защищают от изменений во время переноса; несовпадение → 412. Разные подключения с одинаковым ID → 409, оба владельца остаются без изменений. Подробности — INTEGRATIONS.md.

Доменный ПК сохраняет подключения по домену и имени после переустановки. Администратор может нажать «Перепривязать после переустановки»: прежние ключи отключатся, подключения и история сохранятся; новую заявку нужно одобрить. Запрос только администратора: POST /admin/devices/{id}/reset-enrollment.

Telegram: заявки, одобрение и подключения

Нажмите «Старт» у отдельного бота, сохраните токен в «Сервис → Уведомления → Telegram», найдите числовой chat_id и снова сохраните настройки. «Отправить тест» проверяет доставку. Для кнопок включите «Управлять заявками в Telegram» и проверьте «Состояние управления». В личном чате без списка администраторов команды доступны его владельцу; для группы укажите числовые Telegram ID администраторов. Публичный канал подходит только для уведомлений.

В заявке нажмите «Одобрить» и выберите Рабочий, Общий или оба профиля либо нажмите «Отклонить». После одобрения «Связать с пользователем» объединяет подключения устройства с общим списком пользователя по почте. Пустые списки также можно связать. Доступ других устройств и ключи сохраняются.

Некоторые wingsv://-профили не содержат глобального приглашения VK. В форме импорта заполните «Ссылка звонка VK» либо отправьте профиль и приглашение двумя строками. Встроенная ссылка имеет приоритет; при отсутствии приглашения показывается понятная причина 400.

Если подключений нет, бот предлагает прислать конфиг текстом, файлом .conf/.txt/.json до 2 МиБ или HTTPS URL подписки x-ui. Ответьте именно на запрос добавления: он связан с выбранным получателем, действует 20 минут и дополняет существующий список. После привязки пополняется общий список пользователя. Подписка должна быть доступна по публичному HTTPS. Конфиг проходит через Telegram; приватные данные не включаются в ответы и журналы API.

/pending — прежние и новые ожидающие заявки с кнопками
/device имя_ПК — вернуться к одобренному компьютеру
/device ID — выбрать устройство однозначно
/device почта — открыть общий список пользователя
/cancel — отменить ввод ответом на запрос

Режим управления использует getUpdates; существующий webhook не отключается. Используйте отдельного бота без другого обработчика. При выключенном управлении сохраняются обычные уведомления, поиск chat_id без offset и отправка теста. Для группы бот должен быть участником; ID человека можно узнать как chat_id его личного диалога с ботом до включения управления.

Мониторинг и история

Клиент отправляет события подключения, отключения, переключения и изменения состояния. Неизменные периодические проверки не создают новые события. История отображает время, устройство, Рабочий / Общий, сервер, протокол, IP обращения к API, адрес внутри VPN и причину. IP обращения к API — адрес, видимый серверу: при обращении через VPN это выходной адрес VPN. Он не показывает исходный внешний IP устройства или его адрес в домашней LAN. Адрес внутри VPN показывается отдельно по данным клиента. На сервере хранится до 1000 событий для каждого устройства, на странице админки — последние 500 с фильтрами. Старые версии клиента могли отправлять повторные статусы и не указывали выбранный профиль.

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

Удаление профиля устройства удаляет его настройки, ключ, личные серверные подключения и историю. Сохранённые личные подключения на самом клиенте остаются. Новое обращение удалённого устройства снова требует регистрации.

Развёртывание Linux API

Один бинарный файл relay-api, server.json рядом, данные — в data. Сервис выбирает свободный порт и печатает адрес при запуске; для HAProxy закрепите listen в конфигурации. HAProxy может находиться отдельно, без привязки по внутреннему IP; используйте секретный служебный заголовок на защищённом соединении с backend. ЦС необязателен. Проверка сертификатов компьютеров включается отдельной опцией; при завершении TLS на HAProxy используйте ключ устройства.

При обновлении заменяйте только бинарник. Сохраняйте server.json, master.key и data: без master.key невозможно расшифровать настройки и ключи. Сделайте резервную копию перед обновлением.

Telegram-прокси и WEB

Поддерживаются MTProxy, SOCKS и tg://webproxy: server и secret, без обязательного порта. WEB-ссылка сохраняется без преобразования; нужен совместимый Telegram.

В разделе «Telegram-прокси» или через API можно добавить, изменить, выключить и удалить ссылку. Прямые привязки к пользователю или устройству ограничивают выдачу. После успешной синхронизации недоступные ссылки исчезают из Relay и кабинета.

Уже сохранённый в Telegram прокси администратор отзывает самостоятельно. Relay не обращается к TELEMT и не отключает его пользователей. Внешний адрес и авторизация не требуются.

Методы API и примеры — в PROXIES.md архива сервиса и репозитория.

Обновления из Git

«Сервис → Обновления сервиса и админ-панели»: показ версий, проверка и установка только по кнопке администратора. Панель встроена в API. Один раз установите помощник через sudo ./install.sh. Архив проверяется по SHA256; сохраняется резервная копия бинарника и данных, при неудачном запуске выполняется возврат. При случайном порте нужно обновить backend HAProxy; рекомендуется закрепить listen. Подробнее — UPDATES.md.

Объединение подключений устройства и пользователя

В карточке устройства выберите «Объединить с подключениями пользователя». Существующие конфиги обеих сторон сохранятся в общем списке пользователя по почте, и устройство начнёт получать этот список. Точные копии учитываются один раз; разные конфиги с одинаковым ID сохраняются отдельно. Объединяются также подписки, при совпадении URL сохраняются текущие настройки пользователя. Все изменения записываются вместе; при ошибке или превышении 32 подключений обе стороны остаются прежними. Повторное нажатие не очищает список. Ключ, одобрение и история не меняются.

POST /integration/v1/devices/{id}/connections-inheritance
If-Match: "ID:SOURCE_ID:REVISION"

{"ownerRevision":5}

Вариант администратора: POST /admin/devices/{id}/connections-inheritance. Проверки версий необязательны; устаревшая версия — 412. Объединённый список получают одобренные устройства без собственного списка. Индивидуальные списки других устройств сохраняются.

Пользователи и ПК

Одна строка на почту. Нажмите её: откроются устройства пользователя и общие подключения. Android и ПК вне домена находятся внутри почты. Доменные Windows-ПК показаны по имени компьютера. После явного объединения с пользователем ПК находится внутри его почты рядом с телефонами; одна контактная почта заявки не меняет группировку. Записи без почты доступны по имени. Счётчик и пагинация считают пользователей / компьютеры, а не отдельные строки устройств.

Поиск по имени устройства, IP, фрагменту ключа или ОС находит его пользователя. Фильтр «Ждёт решения» учитывает вложенные заявки; каждое устройство подтверждается отдельно. В карточке устройства есть состояние, адреса, ключ, одобрение, история и кнопка возврата к пользователю. Подключения задаются у пользователя или доменного компьютера, отдельный профиль телефона создавать не нужно.

Если остался прежний индивидуальный список, его можно явно объединить с общим; группировка сама не меняет данные. Почта видна и до подготовки общего профиля — используйте «Настроить общие подключения». API внешних интеграций, ID и ключи сохранены.

Доменный ПК и телефон сотрудника

С API 0.10.11 откройте карточку доменного ПК → «Объединить с пользователем» → почта сотрудника. Подключения и подписки ПК добавятся к общему списку пользователя без замены существующих. Если пользователя ещё нет, он создаётся вместе с объединением. ПК появится внутри пользователя рядом с телефонами. Дальнейшие изменения общих подключений получат все одобренные устройства без собственного списка.

Ключ, домен/имя, одобрение и история ПК сохраняются. Переустановка Windows с новой защищённой регистрацией того же домена/имени через GPO сохраняет привязку к пользователю. Каждое устройство подтверждается отдельно; права пользователя ограничивают права ПК, отзыв пользователя действует и на ПК. Новому пользователю ключ кабинета и доступ выдаются отдельно. Личные списки не объединяются автоматически; существующий личный список ПК сохраняется. Индивидуальные списки других устройств объединяются отдельно.

POST /integration/v1/computers/example.local/PC-001/connections-inheritance
Authorization: Bearer КЛЮЧ_ИНТЕГРАЦИИ
If-Match: "ID_ПК:SOURCE_ID:REVISION"
Content-Type: application/json

{"ownerEmail":"employee@example.org","ownerRevision":5}

Варианты по ID: POST /integration/v1/devices/{id}/connections-inheritance и POST /admin/devices/{id}/connections-inheritance. ownerRevision нового пользователя — 0. Проверки версий необязательны; устаревание — 412. ownerEmail в списке устройств хранит административную привязку отдельно от контактной email заявки; поддержка — capabilities.deviceOwnerBinding. Подробности — INTEGRATIONS.md.

Повторное объединение не очищает список. Две пустые стороны — 409, неверная почта или больше 32 подключений — 400; при ошибке ничего не меняется. Уже унаследованный список другого пользователя не копируется при смене владельца (409). Изменяйте общий список у пользователя, CRUD по ID ПК создаёт индивидуальный список. Для одновременного WG/AWG нужны разные peer-ключи: общий список сам их не выпускает.

Маршруты JSON и исключения приложений

Маршруты Xray берутся из JSON-подписки, DNS и резервные DNS — из API. Поддерживаются GeoIP и GeoSite с DAT-файлами. Списки РФ на 4000/10000 сетей удалены. Ручные исключения IP/CIDR (до 512, без доменов и /0) действуют для всех протоколов, включая WG/AWG и этап подключения. DNS и проверки VPN защищены. Исключения приложений, подключённой LAN и multicast/broadcast сохраняются. Требуются Android 0.6.56 / Windows 0.7.59 или новее.

Правила маршрутизации и проверки интернета

С API 0.10.19 сетевые настройки Рабочего и Общего профилей содержат правила: direct — напрямую, vpn — через VPN, block — заблокировать. Сначала IP/CIDR, затем точные домены; внутри группы первое совпадение. DNS и IP проверок защищены. Домены поддерживаются только Xray для трафика в сетях профиля при доступном имени HTTP/TLS/QUIC. WG/AWG и SSTP требуют IP/CIDR. Старый клиент не получает политику с обязательными новыми правилами до обновления.

Windows 0.7.29 и ручная сборка Android 0.6.23 проверяют интернет Общего профиля по проверенному TLS и HTTP-ответу на порту 443 через VPN. Ответ DNS или открытый TCP-порт не подтверждает интернет. Рабочий профиль сохраняет TCP-проверки корпоративных ресурсов. Инспектор «Куда пойдёт этот адрес?» объясняет действующую политику без проверки доступности узла.

Список RU остаётся небольшим JSON, загружаемым онлайн. Пустой источник использует ipverse. Клиент показывает версию кэша и действующего списка; изменения применяются после переподключения. Android 0.6.23 доступен для ручного тестирования вне автообновлений. Подробности — NETWORK_TOOLS.md в архиве сервера.

Windows Xray: исключения RU и IP

С Windows 0.7.30 Общий профиль применяет заданные в API исключения России и дополнительные IP/CIDR также с Xray. Маленькие ручные сети исключаются из системных маршрутов; большой список RU обрабатывается маршрутизатором Xray без тысяч маршрутов Windows. DNS и IP проверок сохраняют приоритет VPN. Доменные правила Xray применяются до списка RU, а явные IP-правила имеют приоритет. В Рабочем профиле исключения Общего не применяются. Android сохраняет исключения RU для WG/AWG.

HTTPS-проверка использует исходный домен в SNI, сертификате и Host и выполняет GET /. HTTP-код показывается отдельно: 4xx/5xx подтверждают полученный ответ сервера, но не доступ к содержимому сайта. Соединения TCP без ответа или с неверным TLS не считаются работающим интернетом.