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

解密文件

“解密文件”活动用于使用对称算法和密钥或使用 PGP 私钥解密文件。

UiPath.Cryptography.Activities.DecryptFile

描述

使用对称算法和密钥或者使用带有私钥的 PGP 来解密文件。结果将写入新文件。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、跨平台配置

  • 文件- 要解密的文件,存储为IResource变量。选择加号。文档图像菜单以切换到“输入路径”输入。
  • 算法- 此为下拉菜单,用于选择要使用的解密算法。提供以下选项: AES GCMChaCha20-Poly1305(非 FIPS)PGP - 相当良好的隐私协议(非 FIPS)AES(已弃用)DES (已弃用)RC2 (非 FIPS)(已弃用)Rijndael (非 FIPS)(已弃用)TripleDES(已弃用) 。选择“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 decrypted 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) - 调用者提供的密钥,用于第三方互操作性。要求密钥字节格式HexBase64
    • OpenSSL ec(Salted__ + VBKDM2-SHA256) - 解密openssl enc兼容的输入。
  • 密钥字节格式- 如何解释“密钥”字符串。提供以下选项: “Hex”“Base64” 。当“线格式”“原始”(调用者提供的密钥和初始化向量)时为必填项;否则,密钥将被视为密码。
  • “Kdf 迭代” - pbkdf2 迭代计数。必须匹配加密时使用的值,因为它不以传输格式传递。0使用 OWASP 推荐的格式默认值。UiPath(传统)原始数据(调用者提供的密钥和初始化密钥)已被拒绝。
  • “AES 密钥大小” - 用于加密输入的 AES 密钥大小(以位为单位)。可用的选项如下: 128 位192 位256 位(默认)。仅当“算法”“AES”“传输格式”OpenSSL ec (Salted__ + PI-SHA256)时适用。必须与生产者使用的密钥大小匹配;该文件不会以连线格式存储。
PGP

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

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

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

输出文件的名称和位置覆盖输出结果
取消设置关闭具有原始文件名 + 后缀的文件“_Decrypted”。如果文件已存在,则会引发错误。
取消设置启动具有原始文件名 + 后缀的文件“_Decrypted”。如果文件已存在,则该文件将被覆盖。
集合关闭符合用户首选项的文件。如果文件已存在,则会引发错误。
集合启动符合用户首选项的文件。如果文件已存在,则该文件将被覆盖。
输出
  • Decrypted File - Reference to the decrypted file retrieved by the activity for use in other activities.

Windows - 旧版配置

属性面板

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

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

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

    备注:

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

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

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

  • Decrypted Filename - The file name you want to use to save the decrypted file.

  • InputPath - The path to the file that you want to decrypt. This field supports only strings and String variables.

  • Key - The key that you want to use to decrypt 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 decrypt the input file.

  • Output file name and location - The path where you want to save the decrypted 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 论坛

保持更新