概要
Identity Server, Webhooks, and Resource Catalog Service AppSettings.Production.json
files contain sensitive information one may want to secure. It is possible to encrypt/decrypt these files using the UiPath.ConfigProtector.exe
tool.
重要
暗号化すると、
AppSettings.Production.json
ファイルを直接編集してデータを変更することができなくなります。編集するには、復号して、再度暗号化する必要があります。
UiPath.ConfigProtector.exe
UiPath.ConfigProtector.exe
は Orchestrator のインストール ディレクトリにあります。フル パスは C:\Program Files (x86)\UiPath\Orchestrator\Tools\ConfigProtector
です。
コマンド リファレンス
Parameter | Description |
---|---|
--pe | Encrypts the AppSettings.Production.json file. |
--de | Decrypts the AppSettings.Production.json file. |
-f / --configfile | Indicates the file name and path of AppSettings.Production.json . |
-o / --output | The encrypted/decrypted file is saved to a new file instead of overwriting the existing one. |
--help | Displays information about the available commands. |
--version | Displays version information. |
--signing-settings | Allows you to add a configuration section of your choice to the tool's settings. This command uses the dot notation. Example: configprotector.exe --pe -f appsettings.Production.json --signing-settings Other.Path.Of.SigningCredentialSettings |
--keys / k | Allows you to encrypt/decrypt keys that are not hardcoded. This parameter need to be followed by a list of comma separated keys. Example: configprotector.exe --pe -f appsettings.Production.json --keys Path.To.Key1,Path.To.Key2 Note: This should only be used in rare cases, and for keys that support encryption (which are mostly connection strings). An example of this is adding a new ledger subscriber with a new connection string, where you want to encrypt the new key without having to first decrypt the whole configuration, and encrypt it afterwards. The default paths that the tool already encrypts should suffice. |
Identity Server
暗号化
AppSettings.Production.json
を暗号化するには、Orchestrator のインストール後に、次の手順を実行します。
- コマンド プロンプトを開きます。
- 次のコマンドを実行します。
UiPath.ConfigProtector.exe
--pe
-f "C:\Program Files (x86)\UiPath\Orchestrator\Identity\appsettings.Production.json"
復号
- コマンド プロンプトを開きます。
- 次のコマンドを実行します。
UiPath.ConfigProtector.exe
--de
-f "C:\Program Files (x86)\UiPath\Orchestrator\Identity\appsettings.Production.json"
Webhook
Webhook の appsettings.Production.json
を暗号化する前に、証明書への署名の設定を追加する必要があります。同じ証明書を使用する場合は、Identity Server の appsettings.Production.json
ファイルの SigningCredentialSettings
セクションをコピーしても構いません。
"AppSettings": {
"SigningCredentialSettings": {
"StoreLocation": {
"Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
"Location": "LocalMachine",
"NameType": "Thumbprint"
}
}
}
Name
は、証明書のサムプリントを表します。Location
とNameType
に他の値を使用することはお勧めしません。
暗号化
- コマンド プロンプトを開きます。
- 次のコマンドを実行します。
UiPath.ConfigProtector.exe
--pe
-f "C:\Program Files (x86)\UiPath\Orchestrator\Webhooks\appsettings.Production.json"
復号
- コマンド プロンプトを開きます。
- 次のコマンドを実行します。
UiPath.ConfigProtector.exe
--de
-f "C:\Program Files (x86)\UiPath\Orchestrator\Webhooks\appsettings.Production.json"
リソース カタログ サービス
Prior to encrypting the Resource Catalog Service appsettings.Production.json
, you need to add the signing certificate settings. You can copy the SigningCredentialSettings
section from the Identity Server appsettings.Production.json
file if you want to use the same certificate.
"AppSettings": {
"SigningCredentialSettings": {
"StoreLocation": {
"Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
"Location": "LocalMachine",
"NameType": "Thumbprint"
}
}
}
Name
は、証明書のサムプリントを表します。Location
とNameType
に他の値を使用することはお勧めしません。
暗号化
- コマンド プロンプトを開きます。
- 次のコマンドを実行します。
UiPath.ConfigProtector.exe
--pe
-f "C:\Program Files (x86)\UiPath\Orchestrator\ResourceCatalog\appsettings.Production.json"
復号
- コマンド プロンプトを開きます。
- 次のコマンドを実行します。
UiPath.ConfigProtector.exe
--de
-f "C:\Program Files (x86)\UiPath\Orchestrator\ResourceCatalog\appsettings.Production.json"
1 日前に更新