Verschlüsseln von AppSettings.Production.json

Referenz zur Verschlüsselung von AppSettings.Production.json-Dateien für Identity Server, Webhooks und Ressourcenkatalogdienst.

Erfahren Sie mehr über das Verschlüsseln von AppSettings.Production.json.

Überblick

AppSettings.Production.json-Dateien von Identity Server, Webhooks und Ressourcenkatalogdienst enthalten vertrauliche Informationen, die Sie schützen sollten. Es ist möglich, diese Dateien mit dem UiPath.ConfigProtector.exe-Tool zu verschlüsseln/entschlüsseln.

Hinweis:

Nach der Verschlüsselung können die Daten nicht direkt durch Bearbeiten der AppSettings.Production.json-Datei geändert werden. Sie müssen entschlüsselt und dann erneut verschlüsselt werden.

UiPath.ConfigProtector.exe

UiPath.ConfigProtector.exe befindet sich im Installationsverzeichnis des Orchestrators. Der vollständige Pfad lautet: C:\Program Files (x86)\UiPath\Orchestrator\Tools\ConfigProtector.

Befehlsreferenz

Parameter	Beschreibung
--pe	Verschlüsselt die Datei AppSettings.Production.json.
--de	Entschlüsselt die AppSettings.Production.json-Datei.
-f / --configfile	Gibt den Dateinamen und den Pfad von AppSettings.Production.jsonan.
-o / --output	Die verschlüsselte/entschlüsselte Datei wird in einer neuen Datei gespeichert, anstatt die vorhandene zu überschreiben.
--help	Zeigt Informationen zu den verfügbaren Befehlen an.
--version	Zeigt Versionsinformationen an.
--signing-settings	Ermöglicht Ihnen das Hinzufügen eines Konfigurationsabschnitts Ihrer Wahl zu den Einstellungen des Tools. Dieser Befehl verwendet die Punktnotation. Beispiel: configprotector.exe --pe -f appsettings.Production.json --signing-settings Other.Path.Of.SigningCredentialSettings
--keys / k	Ermöglicht das Verschlüsseln/Entschlüsseln von Schlüsseln, die nicht hartcodiert sind. Auf diesen Parameter muss eine Liste von durch Kommas getrennten Schlüsseln folgen. Beispiel: configprotector.exe --pe -f appsettings.Production.json --keys Path.To.Key1,Path.To.Key2 Hinweis: Dies sollte nur in seltenen Fällen und für Schlüssel verwendet werden, die Verschlüsselung unterstützen (bei denen es sich meist um Verbindungszeichenfolgen handelt). Ein Beispiel dafür ist das Hinzufügen eines neuen Ledger-Abonnenten mit einer neuen Verbindungszeichenfolge, wobei Sie den neuen Schlüssel verschlüsseln möchten, ohne zuerst die gesamte Konfiguration entschlüsseln und anschließend wieder verschlüsseln zu müssen. Die Standardpfade, die das Tool bereits verschlüsselt, sollten ausreichen.

Identity Server

Verschlüsselung

Um AppSettings.Production.json zu verschlüsseln, führen Sie die folgenden Schritte NACH der Installation von Orchestrator aus:

1. Öffnen Sie die Eingabeaufforderung.
2. Führen Sie den folgenden Befehl aus:

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

Entschlüsselung

1. Öffnen Sie die Eingabeaufforderung.
2. Führen Sie den folgenden Befehl aus:

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

Webhooks

Bevor Sie die Webhooks appsettings.Production.json verschlüsseln, wenden Sie die folgenden Schritte an:

1. Öffnen Sie die Zertifikatskonsole.
2. Navigieren Sie zu Persönlich und dann zu Zertifikate und wählen Sie mit der rechten Maustaste das Zertifikat aus, das Sie verwenden möchten.
3. Wählen Sie als nächstes Alle Aufgaben und dann Private Schlüssel verwalten aus.
4. Fügen Sie die IIS_IUSRS-Gruppe und den Anwendungspoolbenutzer hinzu.
   Hinweis:

   • Stellen Sie sicher, dass Sie den Server als Location festlegen.
   • IIS_IUSRS ist eine lokale Gruppe. Sie sollten auf der lokalen Maschine suchen, nicht unter der Domäne.

Darüber hinaus müssen Sie die Signaturzertifikatseinstellungen hinzufügen. Wenn Sie dasselbe Zertifikat verwenden möchten, kopieren Sie den Abschnitt SigningCredentialSettings aus der appsettings.Production.json-Datei von Identity Server.

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

• Name stellt den Fingerabdruck Ihres Zertifikats dar.
• Es wird nicht empfohlen, andere Werte für Location und NameType zu verwenden.

Verschlüsselung

1. Öffnen Sie die Eingabeaufforderung.
2. Führen Sie den folgenden Befehl aus:

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

Entschlüsselung

1. Öffnen Sie die Eingabeaufforderung.
2. Führen Sie den folgenden Befehl aus:

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

Ressourcenkatalogdienst

Bevor Sie den Ressourcenkatalogdienst appsettings.Production.json verschlüsseln, müssen Sie die Signaturzertifikatseinstellungen hinzufügen. Sie können den Abschnitt SigningCredentialSettings aus der appsettings.Production.json-Datei von Identity Server kopieren, wenn Sie dasselbe Zertifikat verwenden möchten.

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

• Name stellt den Fingerabdruck Ihres Zertifikats dar.
• Es wird nicht empfohlen, andere Werte für Location und NameType zu verwenden.

Verschlüsselung

1. Öffnen Sie die Eingabeaufforderung.
2. Führen Sie den folgenden Befehl aus:

   UiPath.ConfigProtector.exe --pe -f .\appsettings.Production.json --signing-settings SigningCredentialSettings
   

Entschlüsselung

1. Öffnen Sie die Eingabeaufforderung.
2. Führen Sie den folgenden Befehl aus:

   UiPath.ConfigProtector.exe --de -f .\appsettings.Production.json --signing-settings SigningCredentialSettings