Wiki

TLS 지문

서버는 설치 시 자체 서명 인증서를 생성합니다. 각 클라이언트는 첫 연결 시 지문을 확인합니다.

안전한가요? 네. 모든 연결과 모든 파일 전송은 암호화됩니다. 네트워크상의 누구도 여러분의 컴퓨터와 서버 사이를 오가는 내용을 읽을 수 없습니다. 데이터는 여러분 자신의 인프라에 남습니다. 제3자가 호스팅하지도, 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

시작 시 새 인증서와 새 지문이 생성됩니다. 팀에 다시 공유하세요.