加密 AppSettings.Production.json

了解如何加密 AppSettings.Production.json。

概述

Identity Server、Webhook 和资源目录服务 AppSettings.Production.json 文件包含用户可能需要保护的敏感信息。可以使用 UiPath.ConfigProtector.exe 工具来加密/解密这些文件。

备注：

一经加密，将无法通过直接编辑 AppSettings.Production.json 文件来更改数据。必须先解密，然后重新加密。

UiPath.ConfigProtector.exe

UiPath.ConfigProtector.exe 位于Orchestrator 的安装目录中。其完整路径为：C:\Program Files (x86)\UiPath\Orchestrator\Tools\ConfigProtector。

命令参考

参数	描述
--pe	加密 AppSettings.Production.json 文件。
--de	解密 AppSettings.Production.json 文件。
-f / --configfile	指示 AppSettings.Production.json 的文件名和路径。
-o / --output	加密/解密的文件将保存为新文件，而不是覆盖现有文件。
--help	显示有关可用命令的信息。
--version	显示版本信息。
--signing-settings	可用于将所选配置节添加到工具的设置中。 此命令使用点表示法。 示例： configprotector.exe --pe -f appsettings.Production.json --signing-settings Other.Path.Of.SigningCredentialSettings
--keys / k	允许您加密/解密未硬编码的密钥。 此参数后需跟以逗号分隔的键列表。 示例： configprotector.exe --pe -f appsettings.Production.json --keys Path.To.Key1,Path.To.Key2 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.

身份服务器

加密方式

要加密 AppSettings.Production.json，请在安装 Orchestrator 后执行以下步骤：

1. 打开命令提示符。

2. 运行以下命令：

   UiPath.ConfigProtector.exe --pe -f "C:\Program Files (x86)\UiPath\Orchestrator\Identity\appsettings.Production.json"
   

解密

1. 打开命令提示符。

2. 运行以下命令：

   UiPath.ConfigProtector.exe --de -f "C:\Program Files (x86)\UiPath\Orchestrator\Identity\appsettings.Production.json"
   

Webhook

在加密 Webhook appsettings.Production.json 之前，请执行以下步骤：

1. 打开证书控制台。
2. 导航到“个人” ，然后导航到“证书” ，然后右键单击您要使用的证书。
3. 接下来，选择“所有任务” ，然后选择“管理私钥” 。
4. 添加 IIS_IUSRS 组和应用程序池用户。

备注：

• 确保将服务器设置为 Location。
• IIS_IUSRS 是一个本地组。您应该在本地计算机下搜索它，而不是在域下。

此外，您必须添加签名证书设置。如果要使用相同的证书，请复制 Identity Server appsettings.Production.json 文件中的 SigningCredentialSettings 部分。

"AppSettings": {
    "SigningCredentialSettings": {
        "StoreLocation": {
            "Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
            "Location": "LocalMachine",
            "NameType": "Thumbprint"
        }
    }
}

• Name 代表证书的指纹。
• 我们不建议为 Location 和 NameType 使用其他值。

加密方式

1. 打开命令提示符。

2. 运行以下命令：

   UiPath.ConfigProtector.exe --pe -f "C:\Program Files (x86)\UiPath\Orchestrator\Webhooks\appsettings.Production.json"
   

解密

1. 打开命令提示符。

2. 运行以下命令：

   UiPath.ConfigProtector.exe --de -f "C:\Program Files (x86)\UiPath\Orchestrator\Webhooks\appsettings.Production.json"
   

资源目录服务

在加密资源目录服务 appsettings.Production.json 之前，您需要添加签名证书设置。如果要使用同一证书，则可以从身份服务器的 appsettings.Production.json 文件中复制 SigningCredentialSettings 部分。

"AppSettings": {
    "SigningCredentialSettings": {
        "StoreLocation": {
            "Name": "66B6B5A95BD055C8A264E643F9F8B26C7BEAA841",
            "Location": "LocalMachine",
            "NameType": "Thumbprint"
        }
    }
}

• Name 代表证书的指纹。
• 我们不建议为 Location 和 NameType 使用其他值。

加密方式

1. 打开命令提示符。

2. 运行以下命令：

   UiPath.ConfigProtector.exe --pe -f "C:\Program Files (x86)\UiPath\Orchestrator\ResourceCatalog\appsettings.Production.json"
   

解密

1. 打开命令提示符。

2. 运行以下命令：

   UiPath.ConfigProtector.exe --de -f "C:\Program Files (x86)\UiPath\Orchestrator\ResourceCatalog\appsettings.Production.json"