Конфигурационные файлы Клиента и ПО Termidesk Viewer

Конфигурационный файл Termidesk Client.ini

Параметры конфигурирования Клиента могут быть заданы через файл:

  • ОС Microsoft Windows - C:\Users\<user>\AppData\Roaming\UVEON\Termidesk Client.ini;

  • ОС Linux - /home/<user>/.config/UVEON/Termidesk Client.ini.

Начиная с Termidesk версии 7.0 управление режимом использования ПО Termidesk Viewer перемещено из секции [Global] в секцию [Servers] и подчиняется настройкам, полученным от сервера Termidesk.

При подключении пользователя из веб-браузера используется встроенный веб-клиент Termidesk Web Viewer, при необходимости использовать сторонние программы доставки (например, системные mstsc.exe, xfreerdp) потребуется явным образом задать в секции [Global] параметр UseTermideskRDP со значением false. Такая настройка будет использоваться, если от сервера Termidesk вернулось значение «Не задано» для параметра «Соединение по RDP через Termidesk Viewer».

Для ОС macOS ПО Termidesk Viewer используется всегда.

Пример конфигурационного файла:

[Global]
# Язык приложения (ru - русский, en - английский)
Language=ru
# Стиль приложения (light - светлый, dark - темный)
Style=light
# Запуск только одного экземпляра клиента
OneInstance=true
# Игнорирование ошибок SSL (4.0.0)
ignoreSslErrors=true
# Безопасное хранение паролей, возможные значения false/true
secureStorage=false
# Использовать Termidesk Viewer для RDP (4.3.0)
UseTermideskRDP=true
# Отпечаток сертификата для подписания rdp файла mstsc.exe при подключении через WS (5.0.0)
RDPSignSHA256=76FC4AFA6967D8EDDB3786C0364F767BF9C10397
# Адрес, который будет слушать vdi-proxy (5.0.0)
VdiProxyIniHost=0.0.0.0
# Текущая версия ПО (7.0.0)
Version=7.0.0
# Величина задержки (в миллисекундах) показа панели инструментов ПО Termidesk Viewer после наведения на него указателем мыши
ViewerToolBarShowDelay=1000

# Параметры перенаправления звука при подключении по RDP (кроме STAL). Аналогично опциям freerdp
# Общий формат: sound[: [sys:<sys>,][dev:<dev>,][format:<format>,][rate:<rate>,][channel:<channel>,][latency:<latency>,][quality:<quality>]]
# Важно: выбранные параметры должны поддерживаться на стороне сервера
# rate: стандартное значение частоты звука в Гц (8000, 22050, 44100, 48000 и др.)
# channel: количество каналов звука (1 , 2 , 3 и др.)
# quality: качество передаваемого звука. Текст или число: dynamic - 0 (частота будет меняться в зависимости от задержек канала), medium - 1, high - 2
# latency: величина задержки (в миллисекундах)

# Для ОС Linux рекомендуется использовать sys:alsa, для других ОС не задавать
RDPSound="format:0xA106,latency:200,quality:0"

# Параметры перенаправления звука при подключении по RDP для STAL
RDPSoundSTAL="format:1,latency:50,quality:medium"

[MainWindow]
# Cкрытие клиента в трей (4.1.0)
CloseToTray=false
# Геометрия главного окна (формат Qt)
Geometry=01d9d0cb00030000000001fb000000d6000006fa00000387000001fb000000f3000006fa0000038700000000000000000780000001fb000000f3000006fa00000387
# Порядок отображения серверов
ServersOrder=27d22dce-2255-4abe-b4e0-c0fee7100351, 2682d0e9-bb75-4e0e-8f61-5216b5c95205
# Режим отображения рабочих мест 0 - список, 1 - плитки
WorkplacesViewMode=0

[Servers]
# {server-id} - идентификатор узла «Универсального диспетчера»
{server-id}\Auth=\x412\x43d\x443\x442\x440\x435\x43d\x43d\x44f\x44f \x411\x414
# Комментарий
{server-id}\Comment=
# Логин
{server-id}\Login=user1
# Тип пароля для аутентификации
{server-id}\PassType=Keyboard
# При значении параметра secureStorageEnabled=false, хранит пароль, преобразованный с помощью алгоритма blowfish.
# При значении параметра secureStorageEnabled=true, в зависимости от ОС, хранит префикс, указывающий на способ хранения.
# Для UNIX - secretservice:
# Для Windows - wincredential:
{server-id}\Password=blowfish:hidden
# Профиль настроек монитора в кодировке base64 (в примере - b64%3AQXN0cmEgTGludXg%3D)
{server-id}\Screens\b64%3AQXN0cmEgTGludXg%3D\SPICE\Displays\0\Monitors\0\IsPrimary=false
{server-id}\Screens\b64%3AQXN0cmEgTGludXg%3D\SPICE\Displays\0\Monitors\0\LocalGeometry=@Rect(33 158 1322 935)
{server-id}\Screens\b64%3AQXN0cmEgTGludXg%3D\SPICE\Displays\0\Monitors\0\RemoteGeometry=@Rect(0 0 1024 768)
{server-id}\Screens\b64%3AQXN0cmEgTGludXg%3D\SPICE\Displays\0\Monitors\0\WindowState=0
{server-id}\Screens\b64%3AQXN0cmEgTGludXg%3D\SPICE\LocalMonitors\0\Geometry=@Rect(0 0 3440 1440)
# Хост сервера
{server-id}\Url=vdi-demo.termidesk.ru
# Последняя полученная версия сервера (4.3.1)
{server-id}\Version=5.0
# Идентификатор выбранного транспорта для рабочего места
{server-id}\Workplaces\{b64:workplaceName}\FavoriteTransportId=6ac1f9f5-9ae0-5ae0-a304-cf967b582900
# Список избранных рабочих мест
{server-id}\FavoriteWorkplaces={b64:workplaceName}
# Название аутентификатора
{server-id}\Auth=termidesk-freeipa
# Запрет сохранения пароля и удаление ранее сохраненного (4.3.1)
{server-id}\KeepPassword=false
# Запрет сохранения логина и удаление ранее сохраненного (4.3.1)
{server-id}\KeepLogin=false
# Подключение к сессии при аутентификации, 2 – активировано, 0 – деактивировано (5.1.0)
{server-id}\sessionReconnect=2
# Управление повторным подключением к сессии, 3 - активировано, 0 – деактивировано (5.1.0)
{server-id}\sessionRoaming=3

# Список автоматически перенаправляемых USB-устройств для протоколов RDP/SPICE/TERA и каждого известного сервера/рабочего места
{server-id}\Devices\{b64:workplaceName}\{protocol}\Usb\AutoConnect=false
# {server-id} - идентификатор узла «Универсального диспетчера»;
# {b64:workplaceName} - наименование рабочего места в кодировке base64;
# {protocol} - тип протокола доставки;
# AutoConnect - флаг, управляет автоматическим перенаправлением устройств, true - устройства перенаправляются автоматически, false – автоматическое перенаправление не выполняется

# Список перенаправленных USB-устройств для протокола RDP/SPICE/TERA, каждого известного сервера/рабочего места и каждого известного устройства
{server-id}\Devices\{b64:workplaceName}\{protocol}\Usb\List\1\Id=(VID:13FE PID:5200)
# Id - идентификатор устройства (пример: (VID:13FE PID:3423))
{server-id}\Devices\{b64:workplaceName}\{protocol}\Usb\List\1\Name=Silicon-Power32G
# Name - наименование устройства
{server-id}\Devices\{b64:workplaceName}\{protocol}\Usb\List\1\ExpiredAt=< secsSinceEpoh + 30days, 0 >
# ExpiredAt - временная метка, при наступлении которой запись о перенаправленном устройстве удалится. При каждом перенаправлении устройства значение обновляется и устанавливается как текущее POSIX-время с добавлением срока хранения (30 дней).
{server-id}\Devices\{b64:workplaceName}\{protocol}\Usb\List\1\Enabled=true
# Enabled - флаг, управляет перенаправлением устройства в рабочее место, true - перенаправлять устройство, false – не перенаправлять устройство
{server-id}\Devices\{b64:workplaceName}\{protocol}\Usb\List\1\UserInformed=false
# UserInformed - флаг, управляет отображением уведомления пользователя о невозможности перенаправления устройства, true - уведомление отображено, false – уведомление не отображено

# Список перенаправляемых каталогов для протокола RDP/SPICE/TERA, каждого известного сервера/рабочего места и каждого известного каталога
{server-id}\Devices\{b64:workplaceName}\{protocol}\Drive\ReadOnly=false
# ReadOnly - флаг, определяет режим перенаправления каталога в режиме «Только чтение», true - каталог доступен только для чтения, false – каталог доступен для чтения и записи
{server-id}\Devices\{b64:workplaceName}\{protocol}\Drive\List\1\Path=H:/Downloads
# Path - путь к перенаправляемому каталогу
{server-id}\Devices\{b64:workplaceName}\{protocol}\Drive\List\1\ExpiredAt=0
# ExpiredAt - временная метка, при наступлении которой запись о перенаправленном каталоге удалится. При каждом перенаправлении каталога значение обновляется и устанавливается как текущее POSIX-время с добавлением срока хранения (30 дней).
{server-id}\Devices\{b64:workplaceName}\{protocol}\Drive\List\1\UserInformed=false
# UserInformed - флаг, управляет отображением уведомления пользователя о невозможности перенаправления каталога, true - уведомление отображено, false – уведомление не отображено
{server-id}\Devices\{b64:workplaceName}\{protocol}\Drive\List\size=1
# size - количество сохраненных каталогов

# Список перенаправляемых смарт-карт для протокола RDP/SPICE/TERA, каждого известного сервера/рабочего места и каждого экземпляра смарт-карты
{server-id}\Devices\{b64:workplaceName}\{protocol}\Smartcard\List\1\Atr="@ByteArray(;\xdc\x18\xff\x81\x91\xfe\x1f\xc3\x80s\xc8!\x13\x66\x1\x6\x11Y\0\x1()"
# Atr - значение ATR (Answer To Reset), используется для идентификации модели смарт-карты
{server-id}\Devices\{b64:workplaceName}\{protocol}\Smartcard\List\1\Name=Alladin R.D. JCR
# Name - наименование смарт-карты
{server-id}\Devices\{b64:workplaceName}\{protocol}\Smartcard\List\1\ExpiredAt=< secsSinceEpoh + 30days, 0 >
# ExpiredAt - временная метка, при наступлении которой запись о перенаправленной смарт-карте удалится. При каждом перенаправлении смарт-карты значение обновляется и устанавливается как текущее POSIX-время с добавлением срока хранения (30 дней).
{server-id}\Devices\{b64:workplaceName}\{protocol}\Smartcard\List\1\Enabled=true
# Enabled - флаг, управляет перенаправлением смарт-карты в рабочее место, true - перенаправлять смарт-карту, false – не перенаправлять смарт-карту
{server-id}\Devices\{b64:workplaceName}\{protocol}\Smartcard\List\1\UserInformed=true
# UserInformed - флаг, управляет отображением уведомления пользователя о невозможности перенаправления смарт-карты, true - уведомление отображено, false – уведомление не отображено

Конфигурационный файл Termidesk Viewer.ini

Параметры конфигурирования могут быть заданы через файл:

  • ОС Microsoft Windows - C:\Users\<user>\AppData\Roaming\UVEON\Termidesk Viewer.ini;

  • ОС Linux - /home/<user>/.config/UVEON/Termidesk Viewer.ini.

Пример конфигурационного файла:

# Диалог перенаправления принтеров
[Printers redirection]
# Сохранение геометрии диалога
Geometry=@ByteArray(\x1\xd9\xd0\xcb\0\x3\0\0\0\0\x4\x99\0\0\x3\n\0\0\x6\xaa\0\0\x4)\0\0\x4\x9e\0\0\x3%\0\0\x6\xa5\0\0\x4$\0\0\0\0\0\0\0\0\n\0\0\0\x4\x9e\0\0\x3%\0\0\x6\xa5\0\0\x4$)

# Диалог перенаправления каталога
[SharingDir]

# Выбранный каталог для перенаправления
Dir=/home/as/Documents

# Сохранение геометрии диалога
Geometry=@ByteArray(\x1\xd9\xd0\xcb\0\x3\0\0\0\0\x4\x97\0\0\x3\x43\0\0\x5\xb7\0\0\x3\xf1\0\0\x4\x9c\0\0\x3^\0\0\x5\xb2\0\0\x3\xec\0\0\0\0\0\0\0\0\n\0\0\0\x4\x9c\0\0\x3^\0\0\x5\xb2\0\0\x3\xec)
ReadOnly=0

# Диалог перенаправление USB устройств
[USB Redirection]
# Сохранение геометрии диалога
Geometry=@ByteArray(\x1\xd9\xd0\xcb\0\x3\0\0\0\0\x2\xbe\0\0\x1l\0\0\x5\xa0\0\0\x2\xaf\0\0\x2\xc3\0\0\x1\x87\0\0\x5\x9b\0\0\x2\xaa\0\0\0\0\0\0\0\0\n\0\0\0\x2\xc3\0\0\x1\x87\0\0\x5\x9b\0\0\x2\xaa)

Для ОС macOS по умолчнию действие клавиши <Cmd> соответствует <Ctrl>. Изменение назначения клавиши выполняется в конфигурационном файле Termidesk Viewer.ini в параметре Mac_CommandKeyAs. Доступные значения:

  • Win - при нажатии <Cmd> в РМ отправится клавиша <Win>;

  • Ctrl - при нажатии <Cmd> в РМ отправится клавиша <Ctrl>.