Datei verschlüsseln (Encrypt File)

UiPath.Cryptography.Activities.EncryptFile

Beschreibung

Encrypts a file using a symmetric algorithm and key, or using PGP with a recipient's public key. The result is written to a new file.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

• Datei – Die zu verschlüsselnde Datei, gespeichert als IResource -Variable. Wählen Sie das Plus aus um zur Eingabe Eingabepfad zu wechseln.
• Algorithm - A drop-down menu which enables you to select the encryption algorithm you want to use. The following options are available: AES GCM, ChaCha20-Poly1305 (Non-FIPS), PGP - Pretty Good Privacy (Non-FIPS), AES (Deprecated), DES (Deprecated), RC2 (Non-FIPS) (Deprecated), Rijndael (Non-FIPS) (Deprecated), and TripleDES (Deprecated). AES GCM and ChaCha20-Poly1305 (Non-FIPS) are authenticated (AEAD) algorithms recommended for new workflows. Select PGP to encrypt with a recipient's public key instead of a symmetric key.
• Key - The key that you want to use to encrypt the file. Used by the symmetric algorithms only. This field supports only strings and String variables. To enter the key as a secure string instead of plain text, select the field's input menu and choose Toggle to Secure input - this uses the Key Secure String property (a SecureString).

Erweiterte Optionen

Optionen

• Key Encoding - The encoding used to interpret the key specified in the Key property. The dropdown lists all text encodings (code pages) available on the machine, with the most common ones shown first: System default, Unicode (UTF-8) (default), Unicode, Unicode (Big-Endian), Unicode (UTF-32), Unicode (UTF-32 Big-Endian), US-ASCII, and Western European (ISO). Additional regional and legacy code pages follow in the list.
• Output file name and location - The path where you want to save the encrypted file. This field supports only strings and String variables.
  Hinweis:

  Relative Ordnerpfade werden empfohlen, um die unterschiedliche Dateistruktur zwischen Windows- und Linux-Maschinen beim Ausführen eines Projekts zu berücksichtigen. Ein relativer Pfad hat das Format newFolder/newFileName.enc. Die Aktivität erstellt den Zielordner, wenn er noch nicht vorhanden ist.

• Overwrite - If a file already exists, selecting On overwrites it. If the toggle is set to Off, a new file is created. The default value is Off.
• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld also leer ist und ein Fehler auftritt, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.

Symmetric wire format and interoperability

These options apply to the symmetric algorithms only. They let you produce ciphertext that interoperates with external tools such as openssl enc, Java, and Python. Existing workflows that do not set Wire format keep producing the default Classic output, which is unchanged.

• Wire Format - The symmetric ciphertext layout. The following options are available:
  • UiPath (Classic) (default) - UiPath's byte-stable layout (salt(8) + IV + ciphertext [+ tag], PBKDF2-HMAC-SHA1 at 10,000 iterations). Produces the same output as previous versions.
  • UiPath (OWASP 2026) - The Classic layout with a stronger, OWASP-recommended KDF iteration count.
  • Raw (caller-supplied key and IV) - A caller-supplied key and IV, for third-party interoperability. Requires Key Bytes Format to be Hex or Base64.
  • OpenSSL enc (Salted__ + PBKDF2-SHA256) - Produces openssl enc-compatible output.
• Key Bytes Format - How the Key string is interpreted. The following options are available: Hex and Base64. Required when Wire Format is Raw (caller-supplied key and IV); otherwise the key is treated as a password.
• IV - The initialization vector, used when Wire Format is Raw (caller-supplied key and IV). Interpreted according to Key Bytes Format. Optional - leave it empty to let the cipher generate one. Rejected for all other formats.
• KDF Iterations - The PBKDF2 iteration count. 0 uses the format's OWASP-recommended default (1,300,000 for UiPath (OWASP 2026), 600,000 for OpenSSL enc). Rejected for UiPath (Classic) and Raw (caller-supplied key and IV).
• AES Key Size - The AES key size, in bits. The following options are available: 128-bit, 192-bit, and 256-bit (default). Applies only when Algorithm is AES and Wire Format is OpenSSL enc (Salted__ + PBKDF2-SHA256). Must match the key size the peer uses. It is not stored in the wire format, so the encrypt and decrypt sides must use matching values.

PGP

These options apply when Algorithm is PGP.

• Public Key File Path - The path to the recipient's PGP public key file. Required when Algorithm is PGP.
• Private Key File Path - The path to your PGP private key file. Required only when Sign Data is enabled.
• Passphrase - The passphrase that unlocks your private key when signing. To provide it as a secure string instead of plain text, select the field's input menu and switch to the Passphrase (Secure) input (a SecureString).
• Sign Data - When enabled, signs the encrypted data using your private key. This field only supports Boolean values (True, False). The default value is False.

Je nach Ausgabepfad und wenn die Datei bereits vorhanden ist, können die folgenden Ergebnisse auftreten:

Name und Speicherort der Ausgabedatei	Überschreiben	Ausgabeergebnis
Aufheben	Aus	Eine Datei mit dem ursprünglichen Dateinamen und dem Suffix „_Verschlüsselt“. Wenn die Datei bereits vorhanden ist, wird ein Fehler ausgelöst.
Aufheben	Auf	Eine Datei mit dem ursprünglichen Dateinamen und dem Suffix „_Verschlüsselt“. Wenn die Datei bereits vorhanden ist, wird die Datei überschrieben.
Set (Satz)	Aus	Eine Datei gemäß Benutzereinstellung. Wenn die Datei bereits vorhanden ist, wird ein Fehler ausgelöst.
Set (Satz)	Auf	Eine Datei gemäß Benutzereinstellung. Wenn die Datei bereits vorhanden ist, wird die Datei überschrieben.

Ausgabe

• Encrypted File - Reference to the encrypted file retrieved by the activity for use in other activities.

Windows – Legacy-Konfiguration

Eigenschaften-Panel

Allgemein

• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld also leer ist und ein Fehler auftritt, wird die Ausführung des Projekts angehalten. Wenn der Wert auf True gesetzt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.
  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 encryption 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.

• Encrypted Filename - The file name you want to use to save the encrypted file.

• Input Path - The path to the file that you want to encrypt. This field supports only strings and String variables.

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

• Key Encoding - The encoding used to interpret the key specified in the Key property. This field supports only Encoding variables.

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

• Output file name and location - The path where you want to save the encrypted file. This field supports only strings and String variables.

• Overwrite - If a file already exists at the path specified in the OutputPath field, selecting this check box overwrites it. If unchecked, a new file is created. By default, this check box is cleared.

Sonstiges

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