Шлюз. Параметры конфигурирования

Аргумент командной строки применяется для изменения уровня логирования Шлюза. Изначально уровень логирования применяется из значения переменной LOG_LEVEL конфигурационного файла  /etc/opt/termidesk-vdi/termidesk.conf. Для того чтобы применить уровень логирования из аргумента командной строки, необходимо отредактировать unit-файл службы Шлюза:

• открыть для редактирования файл /lib/systemd/system/termidesk-wsproxy.service;

• найти строку, начинающуюся с ExecStart и добавить ключ --loglevel с нужным уровнем.

Пример строки:

ExecStart=/opt/termidesk/share/termidesk-vdi/venv/bin/python wsproxy.py --verification-key=/etc/opt/termidesk-vdi/wsproxy/id_rsa.pub --host=${WSPROXY_BIND_ADDRESS} --port=${WSPROXY_PORT} --loglevel=INFO

Затем выполнить перезапуск конфигурации и службы:

• выполнить команду sudo systemctl daemon-reload;
• выполнить команду  sudo systemctl restart termidesk-wsproxy.

Путь к файлу ключа для соединения SSL.

Пример команды, в которой переопределены параметры запуска службы Шлюза, указаны пути к файлам ключа и сертификата и включен отладочный режим:

:~$ termidesk-gateway --wssServerIP=0.0.0.0 --wssServerPort=8443 --sslKey=/etc/ssl/private/ssl-cert-snakeoil.key --sslCert=/etc/ssl/certs/ssl-cert-snakeoil.pem --debug

При использовании сертификатов и ключей на файлы .key и .pem необходимо выдать права на чтение командой chmod 644:

:~$ sudo chmod 644 /etc/termidesk/ssl-cert-snakeoil.key
:~$ sudo chmod 644 /etc/termidesk/ssl-cert-snakeoil.pem

И перезапустить termidesk-gateway:

:~$ sudo systemctl restart termidesk-gateway.service

Активация и переключение режима журналирования. Значение задается через файл termidesk-gateway.conf.

При значении «-d» активируется подробный режим уровня DEBUG, при значении «-l» активируется менее подробный режим уровня INFO. Пустое значение параметра приводит к отключению режима журналирования.

Активировать режим можно также через аргумент командной строки, для этого выполнить:

termidesk-gateway <значение>

Пример:

termidesk-gateway -l

Информация будет выводиться в интерфейс командной строки. Для прекращения вывода и отключения режима необходимо нажать сочетание клавиш <Ctrl>+<C>

Задание IP-адреса или FQDN доступа к API Шлюза. Код 200 в ответе на API-запрос свидетельствует о работоспособности Шлюза.

При распределенной установке следует задать значение 0.0.0.0 для активации приема запросов с внешних систем.

Запрос с параметрами по умолчанию успешно выполнится только с узла, на котором установлен Шлюз:

:~$ wget http://localhost:8102/api/health 

Для того чтобы получить состояние Шлюза с другого узла, нужно задать параметру --mgtServerIP значение 0.0.0.0. Пример команды для запуска Шлюза с переопределенными параметрами:

:~$ termidesk-gateway --wsServerIP=0.0.0.0 --wsServerPort=5099 --urlCheckToken=http://<FQDN_Узла>/api/wsproxy/v1/verify --wsIdleTimeout=30 --mgtServerIP=0.0.0.0 --mgtServerPort=8102 --healthCheckAccessKey=6622b09199c62bcf9418ad846dd0e4bbdfc6ee4b

Значение также может быть переопределено через файл termidesk-gateway.conf

Задание порта доступа к API Шлюза.

По умолчанию используется порт 8102.

Пример команды для переопределения параметров запуска Шлюза для доступа к API из внешних систем:

:~$ termidesk-gateway --wsServerIP=0.0.0.0 --wsServerPort=5099 --urlCheckToken=http://<FQDN_Узла>/api/wsproxy/v1/verify --wsIdleTimeout=30 --mgtServerIP=0.0.0.0 --mgtServerPort=8102 --healthCheckAccessKey=6622b09199c62bcf9418ad846dd0e4bbdfc6ee4b

Значение также может быть переопределено через файл termidesk-gateway.conf

Задание ключа доступа для аутентификации запросов к API Шлюза.

Пример команды для переопределения параметра приведен выше.

Значение также может быть переопределено через файл termidesk-gateway.conf.

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

• размер ключа должен составлять от 0 до 64 символа;
• должны использоваться символы в шестнадцатеричной системе (0-9, a-f)

Вывод версии Шлюза