Datei verschlüsseln (Encrypt File)

Aktivität „Encrypt File“ zum Verschlüsseln einer Datei mit einem symmetrischen Algorithmus und Schlüssel oder mit dem öffentlichen Schlüssel eines PGP-Empfängers.

UiPath.Cryptography.Activities.EncryptFile

Beschreibung

Verschlüsselt eine Datei mit einem symmetrischen Algorithmus und Schlüssel oder mithilfe von PGP mit dem öffentlichen Schlüssel eines Empfängers. Das Ergebnis wird in eine neue Datei geschrieben.

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.
• Algorithmus – Ein Dropdownmenü, mit dem Sie den Verschlü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). AES GCM undpaket (Non-FIPS) sind authentifizierte Algorithmen (AEAD), die für neue Workflows empfohlen werden. Wählen Sie PGP aus, um mit dem öffentlichen Schlüssel eines Empfängers anstelle eines symmetrischen Schlüssels zu verschlüsseln.
• Schlüssel – Der Schlüssel, den Sie zum Verschlüsseln der Datei 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. 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.
• 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.

Ein symmetrisches Installationsformat und Interoperabilität

Diese Optionen gelten nur für die symmetrischen Algorithmen. Mit ihnen können Sie Verschlüsselungstext erzeugen, der mit externen Tools wie openssl enc, Java und Python interagiert. Vorhandene Workflows, die das Datenformat nicht festlegen, erzeugen weiterhin die klassische Standardausgabe, die unverändert ist.

• Nachrichtenformat – Das symmetrische Verschlüsselungstextlayout. 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). Erzeugt die gleiche Ausgabe wie frühere Versionen.
  • UiPath (OWASP 2026) – Das klassische Layout mit einer stärkeren, von OWASP empfohlenen Anzahl von KDF-Iterationen.
  • Unformatiert (vom Anrufer bereitgestellter Schlüssel und ID) – Ein vom Anrufer bereitgestellter Schlüssel und ID für die Interoperabilität mit Drittanbietern. Erfordert das Format der Schlüsselbytes als Hex oder Base64.
  • OpenSSL enc (Salted__ + PBKDF2-SHA256) – Erstellt openssl enc-kompatible Ausgabe.
• 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.
• IV – Der Initialisierungsvektor, der verwendet wird, wenn das Nachrichtenformat unformatiert ist (vom Aufrufer bereitgestellter Schlüssel und IV). Interpretiert gemäß dem Key Bytes Format. Optional – Lassen Sie die Angabe leer, damit die Verschlüsselung einen generiert. Für alle anderen Formate abgelehnt.
• KDF-Iterationen – Die Anzahl der PBKDF2-Iterationen. 0 verwendet den von OWASP empfohlenen Standardwert des Formats (1.300.000 für UiPath (OWASP 2026) und 600.000 für OpenSSL enc). Abgelehnt für UiPath (klassisch) und Unformatiert (vom Anrufer bereitgestellter Schlüssel und IV).
• AES-Schlüsselgröße – Die AES-Schlüsselgröße in Bits. 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 Schlüsselgröße übereinstimmen, die der Peer verwendet. Er wird nicht im Nachrichtenformat gespeichert, daher müssen die Seiten zum Verschlüsseln und Entschlüsseln übereinstimmende Werte verwenden.

PGP

Diese Optionen gelten, wenn der Algorithmus PGP ist.

• Dateipfad des öffentlichen Schlüssels – Der Pfad zur Datei mit dem öffentlichen PGP-Schlüssel des Empfängers. Erforderlich, wenn der Algorithmus PGP ist.
• Dateipfad für den privaten Schlüssel – Der Pfad zu Ihrer PGP-Datei mit dem privaten Schlüssel. Nur erforderlich, wenn Daten signieren aktiviert ist.
• Passphrase – Die Passphrase, die Ihren privaten Schlüssel beim Signieren freischaltet. 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).
• Daten signieren – Wenn diese Option aktiviert ist, werden die verschlüsselten Daten mit Ihrem privaten Schlüssel signiert. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist 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

• Verschlüsselte Datei – Verweis auf die verschlüsselte Datei, die von der Aktivität zur Verwendung in anderen Aktivitäten abgerufen wurde.

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.