Что такое Шлюз и для чего он используется?¶

Шлюз — это небольшое консольное приложение, которое предоставляет другим устройствам в той же сети доступ к серверу Connect.

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

Приложение доступно для операционных систем Windows и Linux.

Скачать Шлюз

Возможности¶

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

• Пользовательское проксирование данных для соединений между удалённым устройством и техника
• Импорт учётных записей техников из корпоративного Active Directory
• Проксирование сигнала Magic Packet для Wake-on-LAN внутри локальной сети
• Доступ приложения Агент к серверу из закрытых сетей

Проксирование подключений к устройствам¶

Шлюз может использоваться в качестве прокси-сервера для передачи данных между удалённым устройством и устройством технического специалиста во время сеанса подключения. Это позволяет:

• Улучшить сетевые условия между удалённым устройством и устройством технического специалиста, что может повысить качество изображения и скорость передачи данных.
• Ограничить физический доступ к трафику в целях безопасности.

Шлюз поддерживает оба канала передачи данных: WebRTC и WebSocket. Они могут использоваться отдельно или одновременно.

WebRTC¶

Хотя WebRTC является протоколом для установления P2P-соединений, ему всё равно требуется доступ к служебным STUN-серверам для определения IP-адресов участников, а также к TURN-серверам для проксирования данных в случаях, когда P2P-соединение невозможно из-за сетевых условий. Шлюз запускает эти серверы для поддержания работоспособности канала.

WebSocket¶

Для поддержки альтернативного канала Шлюз работает как публичный веб-сервер и проксирует HTTP-соединения через протокол WebSocket.

Импорт учётных записей техников из Active Directory¶

Контроллеры домена Active Directory обычно не имеют открытого доступа в Интернет из соображений безопасности. Из-за этого сервер Connect не может напрямую отправлять запросы на импорт учётных записей из Active Directory. Чтобы предоставить серверу доступ к Active Directory, запустите приложение Шлюз внутри той же локальной сети в качестве посредника. Запущенный Шлюз может синхронизировать учётные записи, выполняя следующие операции по указанию сервера:

1. Получение от сервера учётных данных для подключения к Active Directory
2. Подключение к Active Directory по LDAP и получение данных учётных записей пользователей
3. Отправка полученных данных на сервер

Проксирование сигнала Magic Packet для Wake-on-LAN¶

Когда устройство пробуждается с помощью Wake-on-LAN, сервер отправляет сигнал Magic Packet на все известные IP-адреса целевого устройства. Однако целевое устройство часто не имеет публичного IP-адреса, поэтому пакет может не дойти до него. При этом устройство может быть подключено к другим устройствам в локальной сети и способно получать сигнал пробуждения от них.

Это означает, что вы можете превратить одно из устройств в вашей локальной сети в «наблюдатель», установив на него приложение Шлюз. По запросу сервера, Шлюз отправляет сигнал Magic Packet по локальной сети, обеспечивая надёжное пробуждение целевого устройства.

Доступ приложения Агент к серверу из закрытых сетей¶

Когда приложение Агент на удалённом устройстве не имеет прямого доступа к серверу, он может подключаться к серверу через Шлюз, у которого такой доступ есть. Это может потребоваться при настройке удалённого доступа к устройствам без доступа в Интернет, например в закрытых корпоративных сетях.

pro32connect.exe -config "server='192.168.1.1:443'"

Управление Шлюзом¶

Запущенное приложение Шлюз идентифицируется на сервере с помощью токена, который Шлюз отправляет серверу при подключении. Сервер использует этот токен для определения учётной записи владельца Шлюза и доступных для него ролей.

Управление токенами и ролями выполняется в личном кабинете на странице Шлюзы в разделе Настройки.

На вкладке Установка и запуск в карточке токена можно найти краткие инструкции по установке Шлюза и скачать предварительно настроенный файл config.json для конфигурации запущенного экземпляра. Этот файл содержит адрес сервера и токен.

На вкладке Список активных можно увидеть список запущенных экземпляров, использующих данный токен.

На остальных вкладках можно включать или отключать необходимые роли Шлюза:

Установка и запуск службы¶

Приложение Шлюз управляется с помощью консольных команд.

Чтобы установить приложение Шлюз как службу, используйте команду -install:

./gateway -install

Чтобы запустить службу, используйте команду -start:

./gateway -start

Список всех доступных команд

Конфигурация¶

Запущенный экземпляр Шлюза настраивается с помощью файла config.json, который должен находиться рядом с исполняемым файлом. После внесения изменений необходимо перезапустить приложение.

Подключение к серверу¶

Параметры подключения к серверу Connect:

{
  "server": {
    "host": "pro32connect.ru",
    "token": "3wHcXGzc4KVMCJgxjX7sw5j6UO...",
    "secure": true
  }
}

Проксирование подключений¶

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

{
  "proxy": {
    "webrtc": {
      "public_ip": "130.193.34.86",
      "listen_ip": "0.0.0.0",
      "port": "3478",
      "udp_ports_max": "60000",
      "udp_ports_min": "40000"
    },
    "websocket": {
      "host": "proxy.example.ru",
      "listen_ip": "0.0.0.0",
      "port": "443"
    }
  }
}