Точки подключений

Общие сведения о точках подключений

Настройка точек подключений позволяет регистрировать Шлюз на разных Фермах Termidesk (Termidesk VDI).

Добавление точки подключения выполняется одним из способов:

из интерфейса командной строки Termidesk Connect (см. подраздел Добавление точки подключения из CLI);
из веб-интерфейса Termidesk Connect (см. подраздел Добавление точки подключения из WUI).

Добавление точки подключения осуществляется через объект gw (см. подраздел Объект gw).

При работе Шлюза совместно с Виртуальным Сервером (т.е. одновременным использованием и функционала Шлюза, и функционала балансировки) следует учесть особенности настройки:

на Шлюзе должен отсутствовать Серверный SSL-Профиль. В то же время у Виртуального Сервера он должен быть задан. Это нужно, поскольку Виртуальный Сервер является точкой входа для пользовательских подключений, и при такой конфигурации он будет принимать входящие зашифрованные соединения, расшифровывать их и передавать уже открытый трафик на Шлюз;
рекомендуется исключить возможность прямого обращения к Шлюзу из внешней сети, так как он обрабатывает незашифрованный трафик. Для этого в настройках Шлюза необходимо указать, чтобы он прослушивал подключения только на локальном интерфейсе (например, 127.0.0.1 или 127.0.0.2 и т.д.).

Добавление точки подключения из CLI

Для добавления точки подключения используются команды:

указание имени Шлюза:

set gw server <имя>

указание IP-адреса Виртуального Сервера:

set gw server <имя> vip ip <IP-адрес>

указание порта Виртуального Сервера:

set gw server <имя> vip port <порт>

указание существующего Серверного SSL-Профиля:

set gw server <имя> ssl-profile-id <SSL-Профиль>

указание существующего VRF (по умолчанию – default):

set gw server <имя> vrf <имя_VRF>

(опционально) настройка поддержки протокола UDP для протокола TERA на Шлюзе:

указание IP-адреса Виртуального Сервера для TERA:

set gw server <имя> tera-udp vip ip <IP-адрес_TERA>

IP-адрес Виртуального Сервера для TERA может принимать любое значение, т.е. IP-адрес может отличаться от IP-адреса Шлюза или может быть таким же. Указывается IP-адрес именно Виртуального Сервера, если Шлюз скрывается за Виртуальным Сервером.

указание порта Виртуального Сервера для TERA (по умолчанию – 443):
```
set gw server <имя> tera-udp vip port <порт_TERA>
```
указание VRF для TERA (по умолчанию – default):
```
set gw server <имя> tera-udp vrf <имя_VRF_TERA>
```
указание IP-адреса источника, т.е. адреса, с которого Шлюз устанавливает UDP-соединение с рабочим местом Termidesk:
```
set gw server <имя> tera-udp src ip <IP-адрес_источника>
```
Значение 0.0.0.0 указывает на использование всех IP-адресов.
указание порта источника (по умолчанию – 0):
```
set gw server <имя> tera-udp src port <порт_источника>
```
указание VRF источника (по умолчанию – default):
```
set gw server <имя> tera-udp src vrf <имя_VRF_источника>
```

настройка взаимодействия с компонентом «Универсальный диспетчер» Termidesk:

указание URL, поддерживаемого компонентом «Универсальный диспетчер» Termidesk с ролью «Портал пользователя» для обслуживания API-запросов по валидации подключений, запрашиваемых через Шлюз:

set gw server <имя> checktoken url <URL>

Следует использовать актуальные значения версий API для соответствующей версии компонента «Универсальный диспетчер» Termidesk.

указание существующего IP-Фонда, используемого для взаимодействия с компонентом «Универсальный диспетчер» Termidesk:
```
set gw server <имя> checktoken ipset-id <IP-Фонд>
```
указание существующего Клиентского SSL-Профиля (по умолчанию – backend-default):
```
set gw server <имя> checktoken ssl-profile-id <SSL-Профиль>
```

настройка переподключения Шлюза к рабочим местам Termidesk:

указание количества разрешенных переподключений Шлюза к рабочим местам Termidesk (значение от 0 до 10, по умолчанию – 0);

Разные протоколы удаленного доступа могут требовать разных значений параметра:

для RDP нужно использовать ненулевое значение, поскольку некоторые функции (например, перенаправление USB в гостевую ОС рабочего места по протоколу RDP) могут требовать переподключения;
для TERA и SPICE нужно использовать значение по умолчанию (0).

set gw server <имя> tcp-downstream reconnect <количество_переподключений>

указание существующего IP-фонда для взаимодействия с рабочими местами Termidesk:
```
set gw server <имя> tcp-downstream ipset-id <IP-Фонд>
```
указание существующего Клиентского SSL-Профиля для взаимодействия с рабочими местами Termidesk (по умолчанию – backend-default):
```
set gw server <имя> tcp-downstream ssl-profile-id <SSL-Профиль>
```

настройка клиента RabbitMQ:

указание URL-адреса для подключения к серверу RabbitMQ:
```
set gw server <имя> rabbitmq url <URL-адрес>
```

указание имени пользователя для подключения к серверу RabbitMQ:

set gw server <имя> rabbitmq user <имя>

Так же имя пользователя может быть получено из Хранилища секретов. Пример значения параметра:

kv://secret/rabbit#username – для kv версии 1;
kv://secret/data/rabbit#username – для kv версии 2.

указание пароля пользователя для подключения к серверу RabbitMQ:

set gw server <имя> rabbitmq pass <пароль>

Так же пароль пользователя может быть получен из Хранилища секретов. Пример значения параметра:

kv://secret/rabbit#password – для kv версии 1;
kv://secret/data/rabbit#password – для kv версии 2.

указание существующего IP-Фонда для взаимодействия с RabbitMQ:
```
set gw server <имя> rabbitmq ipset-id <IP-Фонд>
```
указание времени (в секундах) ожидания ответа от сервера RabbitMQ (значение от 1 до 60, по умолчанию – 10):
```
set gw server <имя> rabbitmq timeout <время>
```
указание интервала (в секундах) обновления регистрационной информации (URL и другие данные) Шлюза (значение от 10 до 100000, по умолчанию – 60):
```
set gw server <имя> rabbitmq refreshtime <интервал>
```
указание существующего Клиентского SSL-Профиля (по умолчанию – backend-default):
```
set gw server <имя> rabbitmq ssl-profile-id <SSL-Профиль>
```
указание координатора маршрутизации сообщений, определенного в RabbitMQ:
```
set gw server <имя> rabbitmq exchange <координатор>
```
указание ключа маршрутизации RabbitMQ, используемого для маршрутизации задачи в очереди:
```
set gw server <имя> rabbitmq routingkey <ключ_маршрутизации>
```

указание способа передачи данных (по умолчанию – false):

set gw server <имя> rabbitmq single <false/true>

Возможные значения:

true – передача данных до первого подтверждения;
false – передача данных по циклу (бесконечно).

(опционально) указание комментария для сервера:

set gw server <имя> description <комментарий>

применение заданных настроек:

commit

сохранение настроек:

write

Пример конфигурации Шлюза:

set gw
set gw server GW-Farm-01
set gw server GW-Farm-01 ssl-profile-id
set gw server GW-Farm-01 vip ip 192.0.2.100
set gw server GW-Farm-01 vip port 1000
set gw server GW-Farm-01 vrf default
set gw server GW-Farm-01 websocket pingtimeout 30
set gw server GW-Farm-01 checktoken url https://192.0.2.20/api/wsproxy/v6.1/verify
set gw server GW-Farm-01 checktoken ssl-profile-id backend-default
set gw server GW-Farm-01 tcp-downstream reconnect 0
set gw server GW-Farm-01 tera-udp
set gw server GW-Farm-01 tera-udp vip ip 198.51.100.100
set gw server GW-Farm-01 tera-udp vip port 443
set gw server GW-Farm-01 tera-udp vrf default
set gw server GW-Farm-01 tera-udp src ip 203.0.113.49
set gw server GW-Farm-01 tera-udp src port 0
set gw server GW-Farm-01 tera-udp src vrf default

Добавление точки подключения из WUI

Для отображения списка точек подключений следует перейти «Настройки – Termidesk Шлюз – Точки подключений».

По умолчанию записи представлены в табличном виде и упорядочены согласно столбцу «Имя».

Основные параметры списка приведены в таблице (см. таблицу Основные параметры списка точек подключений).

Таблица 1. Основные параметры списка точек подключений
Параметр	Описание
«Имя»	Наименование Шлюза
«IP-адрес»	IP-адрес Виртуального Сервера для Шлюза
«Порт»	Порт Виртуального Сервера для Шлюза
«VRF»	VRF для Шлюза

Для добавления точки подключения следует перейти «Настройки – Termidesk Шлюз – Точки подключений» и нажать экранную кнопку [Добавить].

Затем заполнить данные, перечисленные в столбце «Параметр» следующей таблицы (см. таблицу Данные для добавления точки подключения).

Параметр Описание

Общие настройки Шлюза

«Имя»

Наименование Шлюза

«IP-адрес»

IP-адрес Виртуального Сервера

«Порт»

Порт Виртуального Сервера

«TLS Профиль Сервера»

Серверный SSL-Профиль

«VRF»

Выбор VRF.

Значение по умолчанию: «default»

«Комментарий»

Комментарий для сервера

Настройки TERA

«TERA UDP»

Настройка поддержки протокола UDP для протокола TERA на Шлюзе.

Активация параметра открывает доступ к настройкам протокола TERA, отключение параметра закрывает доступ к настройкам протокола TERA

«TERA IP»

IP-адрес Виртуального Сервера для TERA.

Параметр «TERA IP» может принимать любое значение, т.е. IP-адрес может отличаться от IP-адреса Шлюза или может быть таким же. Указывается IP-адрес именно Виртуального Сервера, если Шлюз скрывается за Виртуальным Сервером.