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

起動時に新しい証明書と新しいフィンガープリントが生成されます。チームに再共有してください。