Text entschlüsseln (Decrypt Text)

Aktivität Decrypt Text zum Entschlüsseln einer Zeichenfolge mit einem symmetrischen Algorithmus und Schlüssel oder mit einem privaten PGP-Schlüssel.

UiPath.Cryptography.Activities.DecryptText

Beschreibung

Entschlüsselt eine Zeichenfolge mithilfe eines symmetrischen Algorithmus und Schlüssels oder mithilfe von PGP mit einem privaten Schlüssel. Gibt die Nur-Text-Zeichenfolge zurück. Die verschlüsselte Eingabe ist Base64-codiert für symmetrische Algorithmen und ASCII-armored für PGP.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

• Algorithmus – Ein Dropdownmenü, mit dem Sie den Entschlüsselungsalgorithmus auswählen können, den Sie verwenden möchten. Die folgenden Optionen sind verfügbar: AES GCM, ChaCha20-polis (Non-FIPS), PGP – Ziemlich guter Datenschutz (Nicht-FIPS), AES (veraltet), DES (veraltet), RC2 (Nicht-FIPS) (veraltet), Rijndael (Nicht-FIPS) (veraltet) und DoubleDES (veraltet). Wählen Sie PGP aus, um mit einem privaten Schlüssel anstelle eines symmetrischen Schlüssels zu entschlüsseln. Der Algorithmus muss mit demjenigen übereinstimmen, der zum Verschlüsseln der Eingabe verwendet wird.
• Text - The text that you want to decrypt. This field supports only strings and String variables.
• Schlüssel (Key) - Der Schlüssel, den Sie zum Entschlüsseln des angegebenen Texts verwenden möchten. Nur von den symmetrischen Algorithmen verwendet. Dieses Feld unterstützt nur Strings und String -Variablen. Um den Schlüssel als sichere Zeichenfolge anstelle von Nur-Text einzugeben, wählen Sie das Eingabemenü des Felds und dann Auf sichere Eingabe umschalten aus – dabei wird die Eigenschaft „Sichere Schlüsselzeichenfolge“ ( SecureString) verwendet.

Erweiterte Optionen

Optionen

• Schlüsselcodierung – Die Codierung, die zur Interpretation des in der Eigenschaft Taste angegebenen Schlüssel verwendet wird. Nur von den symmetrischen Algorithmen verwendet. In der Dropdownliste werden alle auf der Maschine verfügbaren Textcodierungen (Codeseiten) aufgeführt, wobei die gängigsten zuerst angezeigt werden: Systemstandard, Unicode (UTF-8) (Standard), Unicode, Unicode (Big-Endian), Unicode (UTF-32). ), Unicode (UTF-32 Large-Endian), US-ASCII, und Westeuropa (ISO). Zusätzliche regionale und Legacy-Codeseiten folgen in der Liste.
• Textcodierung (Text Encoding ) - Die Codierung, mit der die entschlüsselten Bytes wieder in Text konvertiert werden. Stellen Sie dies so ein, dass es mit der Codierung übereinstimmt, die vom Tool verwendet wurde, das den Verschlüsselungstext erstellt hat. Unabhängig von der Schlüsselcodierung – Beide bieten die gleiche vollständige Liste der Textcodierungen und verwenden standardmäßig Unicode (UTF-8). Nur von den symmetrischen Algorithmen verwendet.
• Continue On Error - Specifies if the automation should continue even if the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

Ein symmetrisches Installationsformat und Interoperabilität

Diese Optionen gelten nur für die symmetrischen Algorithmen. Mit ihnen können Sie Verschlüsselungstext entschlüsseln, der von externen Tools wie openssl enc, Java und Python erzeugt wurde. Jede Option muss mit dem übereinstimmen, was zum Zeitpunkt der Verschlüsselung verwendet wurde.

• Nachrichtenformat – Das symmetrische Verschlüsselungstextlayout, das entschlüsselt werden soll. Muss mit dem bei der Verschlüsselung verwendeten Format übereinstimmen. Die folgenden Optionen sind verfügbar:
  • UiPath (klassisch) (Standard) – Das byte-stabile Layout von UiPath (salt(8) + IV + ciphertext [+ tag], PBKDF2- Kennwort-SHA1 bei 10.000 Iterationen). Der IV wird, wenn vorhanden, automatisch aus dem Präfix des Verschlüsselungstextstreams gelesen.
  • UiPath (OWASP 2026) – Das klassische Layout mit einer stärkeren, von OWASP empfohlenen Anzahl von KDF-Iterationen.
  • Unformatiert (vom Anrufer bereitgestellter Schlüssel und IV) – Ein vom Anrufer bereitgestellter Schlüssel für die Interoperabilität mit Drittanbietern. Erfordert das Format der Schlüsselbytes als Hex oder Base64.
  • OpenSSL enc (Salted__ + PBKDF2-SHA256) – Entschlüsselt openssl enc-kompatible Eingabe.
• Format der Schlüsselbytes – So wird der Schlüsselstring interpretiert. Die folgenden Optionen sind verfügbar: Hex und Base64. Erforderlich, wenn das Dateiformat „Raw“ ist (vom Aufrufer bereitgestellter Schlüssel und IV); Andernfalls wird der Schlüssel als Kennwort behandelt.
• KDF-Iterationen – Die Anzahl der PBKDF2-Iterationen. Muss mit dem zum Zeitpunkt der Verschlüsselung verwendeten Wert übereinstimmen, da er nicht im Nachrichtenformat übertragen wird. 0 verwendet den von OWASP empfohlenen Standard des Formats. Abgelehnt für UiPath (klassisch) und Unformatiert (vom Anrufer bereitgestellter Schlüssel und IV).
• AES-Schlüsselgröße – Die AES-Schlüsselgröße in Bit, die zum Verschlüsseln der Eingabe verwendet wird. Die folgenden Optionen sind verfügbar: 128-Bit, 192-Bit und 256-Bit (Standard). Gilt nur, wenn der Algorithmus AES und das Nachrichtenformat OpenSSL enc (Salted__ + PBKDF2-SHA256) ist. Muss mit der vom Hersteller verwendeten Schlüsselgröße übereinstimmen; sie wird nicht im grafischen Format gespeichert.

PGP

Diese Optionen gelten, wenn der Algorithmus PGP ist.

• Dateipfad für den privaten Schlüssel – Der Pfad zu Ihrer PGP-Datei mit dem privaten Schlüssel. Erforderlich, wenn der Algorithmus PGP ist.
• Passphrase – Die Passphrase, die Ihren privaten Schlüssel entsperrt. Um es als sichere Zeichenfolge anstelle von Nur-Text bereitzustellen, wählen Sie das Eingabemenü des Felds aus und wechseln Sie zur Eingabe Passphrase (Secure) (a SecureString).
• Signatur überprüfen – Wenn diese Option aktiviert ist, wird die PGP-Signatur der entschlüsselten Daten mithilfe des öffentlichen Schlüssels überprüft. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False.
• Dateipfad des öffentlichen Schlüssels – Der Pfad zur Datei mit dem öffentlichen PGP-Schlüssel des Unterzeichners. Nur erforderlich, wenn Signatur überprüfen aktiviert ist.

Ausgabe

• Decrypted Text - Reference to the decrypted text stored in a String variable for use in other activities.

Windows – Legacy-Konfiguration

Eigenschaften-Panel

Allgemein

• Continue On Error - Specifies if the automation should continue even if the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft ContinueOnError auf Wahr True gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• Algorithm - A drop-down menu which enables you to select the decryption algorithm you want to use. The following options are available: AES (Deprecated), AES GCM, DES (Deprecated), RC2 (Non-FIPS) (Deprecated), Rijndael (Non-FIPS) (Deprecated), and TripleDES.

  Hinweis:

  Bei Verwendung des AES GCM -Algorithmus muss die Entschlüsselungseingabe im Format (verkettete Bytes) bereitgestellt werden: Salt (8bytes) + IV (12 bytes) + encryptedData (variable bytes) + Tag (16 bytes). Die Aktivität verwendet außerdem die folgenden Parameter:

  • Die Anzahl der PBKDF2-Iterationen ist 10.000
  • Der generierte Schlüssel ist 256-Bit (32 Byte)

  Beachten Sie, dass der generierte 256-Bit-Schlüssel nicht mit der Schlüsseleingabeoption identisch ist.

• Verschlüsselung (Encoding) - Verschlüsselung, die zum Interpretieren des in der Eigenschaft Schlüssel (Key) angegebenen Eingabetextes und des Schlüssels verwendet wird. Dieses Feld unterstützt nur Encoding-Variablen. Ausführliche Informationen zu diesem Variablentyp finden Sie in der offiziellen Microsoft-Dokumentation.

• Key - The key that you want to use to decrypt the specified file. This field supports only strings and String variables.

• Key Secure String - The secure string used to decrypt the input string.

• Text - The text that you want to decrypt. This field supports only strings and String variables.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Result - The decrypted text, stored in a String variable.