Wiki

Отпечаток TLS

Сервер создаёт самоподписанный сертификат при установке. Каждый клиент подтверждает его отпечаток при первом соединении.

Это безопасно? Да. Все соединения и все передачи файлов зашифрованы: никто в сети не может прочитать то, что передаётся между вашими компьютерами и вашим сервером. Ваши данные остаются в вашей собственной инфраструктуре: ничего не размещается у третьих лиц и ничего не проходит через uVersion. Доступ есть только у участников вашей команды с их собственными учётными данными. А если в соединении происходит что-то необычное, программа это обнаруживает и немедленно блокирует, вместо того чтобы молча пропустить.

uVersion по умолчанию шифрует все соединения по HTTPS, без внешнего домена и сертификата. Сервер создаёт свой сертификат при первом запуске; администратор передаёт отпечаток команде; каждый клиент подтверждает его один раз.

Найти отпечаток

Отображается в конце установки, рядом с паролем администратора. Также доступен в любой момент:

# Linux
sudo cat /var/lib/uversion/data/tls/fingerprint

# Windows
Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

Подтвердить на клиенте

Окно «Trust this server» при первом подключении: сверьте показанный отпечаток, прежде чем доверять.

Настольный клиент

При первом входе открывается диалоговое окно. Сравните его с тем, что передал администратор, и нажмите Trust this server, если совпадает.

CLI `uversion`

uversion trust https://uversion.example.com:8443    # interactif
uversion trust https://uversion.example.com:8443 --yes   # non-interactif (CI / script)
uversion trusted                                    # liste les serveurs pinned
uversion login <url>                                # prompt auto si non-pinned

Плагин Unreal Engine

Выполните uversion trust <url> один раз в терминале перед открытием проекта. (Нативное диалоговое окно UE запланировано на будущее.)

Плагин Rider

Использует uversion под капотом. Выполните uversion trust <url> один раз, и Rider проходит.

Если отпечаток изменился

Клиент отказывает и показывает красное сообщение. Проверьте по независимому каналу у администратора: законная переустановка, намеренная ротация или MITM. Если всё в порядке:

Настольный клиент: кнопка Trust new fingerprint в красном диалоговом окне
CLI: uversion mistrust <url>, затем uversion login <url>

Перегенерировать сертификат

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

# Linux
sudo rm /var/lib/uversion/data/tls/cert.pem /var/lib/uversion/data/tls/key.pem
sudo systemctl restart uversion-server

# Windows
Remove-Item "C:\ProgramData\uVersion\data\tls\cert.pem"
Remove-Item "C:\ProgramData\uVersion\data\tls\key.pem"
Restart-Service uVersionServer

При запуске создаются новый сертификат и новый отпечаток. Поделитесь ими с командой заново.