UiPath Documentation
activities
latest
false
开发者活动
重要 :
请注意,此内容已使用机器翻译进行了部分本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。

加密文件

“加密文件”活动:使用对称算法和密钥或 PGP 收件人的公钥加密文件。

UiPath.Cryptography.Activities.EncryptFile

描述

使用对称算法和密钥或者结合使用 PGP 与收件人公钥来加密文件。结果将写入新文件。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、跨平台配置

  • 文件- 要加密的文件,存储为IResource变量。选择加号。文档图像菜单以切换到“输入路径”输入。
  • 算法- 此为下拉菜单,用于选择要使用的加密算法。提供以下选项: AES GCMChaCha20-Poly1305(非 FIPS)PGP - 相当良好的隐私协议(非 FIPS)AES(已弃用)DES (已弃用)RC2 (非 FIPS)(已弃用)Rijndael (非 FIPS)(已弃用)TripleDES(已弃用)AES GCMChaCha20-Poly1305(非 FIPS)是建议为新工作流使用的经过身份验证 (AEAD) 算法。选择“PGP” ,以使用收件人的公钥而不是对称密钥进行加密。
  • 密钥- 要用于加密文件的密钥。仅由对称算法使用。此字段仅支持字符串和String变量。要以安全字符串而非纯文本形式输入密钥,请选择字段的输入菜单,然后选择“切换到安全输入” - 这将使用密钥安全字符串属性(a SecureString )。

高级选项

选项
  • 密钥编码- 用于解释在“密钥”属性中指定的密钥的编码。下拉列表中列出了计算机上所有可用的文本编码(代码页),首先显示最常见的编码:系统默认值Unicode (UTF-8) (默认选项)、 UnicodeUnicode (Big-Endian)Unicode (UTF-32 )Unicode (UTF-32 Big-Endian)US-ASCII西欧 (ISO) 。列表中遵循其他区域和旧版代码页。
  • Output file name and location - The path where you want to save the encrypted file. This field supports only strings and String variables.
    备注:

    建议使用相对文件夹路径,以解决执行项目时 Windows 和 Linux 计算机之间不同的文件结构。相对路径采用newFolder/newFileName.enc格式。如果目标文件夹尚不存在,则活动将创建该文件夹。

  • 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.
  • “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(TrueFalse)。默认值为 False。因此,如果该字段为空且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。
对称连线格式和互操作性

这些选项仅适用于对称算法。它们用于生成与外部工具(例如openssl enc 、Java 和 Python)互操作的密文。未设置“连线格式”的现有工作流将继续生成默认的传统输出,该输出保持不变。

  • 连线格式- 对称密文布局。可选择以下选项:
    • UiPath(传统) (默认)- UiPath 的字节稳定布局( salt(8) + IV + ciphertext [+ tag] ,迭代次数为 10,000 次时为 pilot2-HMAC-SHA1)。生成与以前版本相同的输出。
    • UiPath (OWASP 2026) - 传统布局,具有更强的 OWASP 建议的 KFS 迭代计数。
    • 原始(调用者提供的密钥和 PV) - 调用者提供的密钥和 PV,用于第三方互操作性。要求密钥字节格式HexBase64
    • OpenSSL ec(Salted__ + VBKFS2-SHA256) - 生成兼容openssl enc输出。
  • 密钥字节格式- 如何解释“密钥”字符串。提供以下选项: “Hex”“Base64” 。当“线格式”“原始”(调用者提供的密钥和初始化向量)时为必填项;否则,密钥将被视为密码。
  • 初始化向量- 当“线格式”“原始”(调用者提供的密钥和初始化向量)时使用的初始化向量。根据密钥字节格式解读。可选- 将其留空,让密码生成密码。对于所有其他格式,则被拒绝。
  • “Kdf 迭代” - pbkdf2 迭代计数。0使用格式的 OWASP 推荐的默认值( UiPath (OWASP 2026)为 1,300,000, OpenSSL ec为 600,000)。UiPath(传统)原始数据(调用者提供的密钥和初始化密钥)已被拒绝。
  • “AES 密钥大小” - AES 密钥大小(以位为单位)。可用的选项如下: 128 位192 位256 位(默认)。仅当“算法”“AES”“传输格式”OpenSSL ec (Salted__ + PI-SHA256)时适用。必须与对等使用的密钥大小匹配。它不会以传输格式存储,因此加密和解密端必须使用匹配的值。
PGP

“算法”“PGP”时,这些选项适用。

  • 公钥文件路径- 收件人 PGP 公钥文件的路径。当“算法”“PGP”时为必需。
  • 私钥文件路径- PGP 私钥文件的路径。仅在启用“签名数据”时才需要。
  • 密码短语- 签名时用于解锁私钥的密码短语。要将其作为安全字符串而不是纯文本,请选择字段的输入菜单,然后切换到“密码(安全)”输入(a SecureString )。
  • 为数据签名- 启用后,使用您的私钥对加密数据进行签名。该字段仅支持“布尔值”( TrueFalse )。默认值为False

根据输出路径以及文件已存在的情况,可能会出现以下结果:

输出文件的名称和位置覆盖输出结果
取消设置关闭具有原始文件名和后缀的文件“_Encrypted”。如果文件已存在,则会引发错误。
取消设置启动具有原始文件名和后缀的文件“_Encrypted”。如果文件已存在,则该文件将被覆盖。
集合关闭符合用户首选项的文件。如果文件已存在,则会引发错误。
集合启动符合用户首选项的文件。如果文件已存在,则该文件将被覆盖。
输出
  • “加密文件” - 活动检索到的加密文件,以便在其他活动中使用。

Windows - 旧版配置

属性面板

常见
  • “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(TrueFalse)。默认值为 False。因此,如果该字段为空且活动引发错误,系统将停止执行项目。如果该值设为“True”,则无论出现何种错误,系统都将继续执行项目。
    备注:

    如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”,则系统在执行项目时不会捕获任何错误。

  • “显示名称”- 活动的显示名称。
输入
  • 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.

    备注:

    使用AES GCM算法时,解密输入必须以(连接的字节)格式提供: Salt (8bytes) + IV (12 bytes) + encryptedData (variable bytes) + Tag (16 bytes) 。该活动还使用以下参数:

    • PBKDF2 迭代计数为 10000
    • 生成的密钥为 256 位(32 字节)

    请注意,256 位生成的密钥与“密钥输入”选项不同。

  • 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.

其他
  • “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
  • 描述
  • 项目兼容性
  • Windows、跨平台配置
  • 高级选项
  • Windows - 旧版配置
  • 属性面板

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新