Test Manager の設定ファイルの暗号化

Test Manager では、設定ファイルをセキュリティ保護するために、証明書ベースの暗号化を実行します。Test Manager プロビジョニングツールの一部として testmanager.exe を使用して、設定ファイルを手動で暗号化および復号できます。このツールは、既定の Test Manager のインストール場所 (C:\Program Files (x86)\UiPath\TestManager\Tools\TestManagerProvisioner)、またはカスタムのインストールフォルダーにあります。

Test Manager プロビジョニングツールを使用して設定ファイルを暗号化するには、UiPath Test Manager のインストールパッケージをマシンにダウンロードおよびインストールします。

注:

Test Manager のバージョンが 20.10.4 よりも古い場合は、新しいメソッドで暗号化する前に、obfuscator (非推奨) コマンドを使用して設定ファイルを復号する必要があります。
コマンドでは、大文字と小文字が区別されます。
暗号化すると、appsettings.production.json ファイルを編集して値を変更することができなくなります。編集するには、復号して、再度暗号化する必要があります。

前提条件

暗号化プロセスによって、現在の設定が上書きされます。作業を進める前に、appsettings.production.json ファイルをバックアップするようにしてください。このファイルは、C:\Program Files (x86)\UiPath\Test Manager\ にあります。
appsettings.production.json ファイルを開き、SigningCredentialSettings を設定します。このセクションが見つからない場合は、ファイルに追加する必要があります。Test Manager インスタンスを実行するユーザーが、アプリケーションプール ID で、またはインストール中に指定したユーザーとして、プライベートキーにアクセスできることを確認します。
```
"SigningCredentialSettings": {
        "StoreLocation": {
            "Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
            "Location": "LocalMachine",
            "NameType": "Thumbprint"
        }
    }"SigningCredentialSettings": {
        "StoreLocation": {
            "Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
            "Location": "LocalMachine",
            "NameType": "Thumbprint"
        }
    }
```
Name: 証明書の拇印です。拇印の値を貼り付けるときは、Name オブジェクトに注意してください。このオブジェクトは NameType と似ているため、混乱を招く可能性があるからです。

Location と NameType には既定値を使用することをお勧めします。

SigningCredentialSettings オブジェクトに値を貼り付けたら、ファイルを保存します。

Test Manager の設定ファイルをセキュリティ保護する

暗号化コマンドオプション

パラメーター	説明
`encrypt`	`appsettings.production.json` ファイルを暗号化します。
`decrypt`	`appsettings.production.json` ファイルを復号します。

暗号化

設定ファイルを暗号化するには、以下の手順を実行します。

コマンドプロンプトを開きます。
Test Manager のインストール場所にある Test Manager プロビジョニングツールのフォルダーを開きます。

次のコマンドを実行します。

testmanager.exe encryptor encrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"testmanager.exe encryptor encrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"

これにより、設定ファイルは保護され、新しく生成されたファイル (appsettings.protected.json) に保存されます。

復号

コマンドプロンプトを開きます。
Test Manager のインストール場所にある Test Manager プロビジョニングツールのフォルダーを開きます。

次のコマンドを実行します。

testmanager.exe encryptor decrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"testmanager.exe encryptor decrypt "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"

これにより、保護された設定ファイルが保存される appsettings.protected.json ファイルの値が、null に設定されます。

古いバージョンの Test Manager の暗号化

コマンドプロンプトを開きます。
Test Manager のインストール場所にある Test Manager プロビジョニングツールのフォルダーを開きます。

次のコマンドを実行します。

testmanager.exe obfuscator deobfuscate appsettings "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"testmanager.exe obfuscator deobfuscate appsettings "C:\)\)Program Files(x86)\)\)UiPath\)\)Test Manager\)\)appsettings.production.json"

appsettings.production.json の難読化を解除したら、暗号化を使用して Test Manager をセキュリティ保護できます。