Decrypt File

UiPath.Cryptography.Activities.DecryptFile

Description

Decrypts a file using a symmetric algorithm and key, or using PGP with a private key. The result is written to a new file.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, configuração multiplataforma

• Arquivo — o arquivo a ser descriptografado, armazenado como uma variável IResource . Selecione o sinal de mais para alternar para a entrada Caminho de entrada .
• Algorithm - A drop-down menu which enables you to select the decryption 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). Select PGP to decrypt with a private key instead of a symmetric key. The algorithm must match the one used to encrypt the input.
• Key - The key that you want to use to decrypt the specified 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).

Opções avançadas

Opções

• 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 decrypted file. This field supports only strings and String variables.
  Observação:

  Caminhos de pasta relativos são recomendados devido à estrutura de arquivos diferente entre máquinas Windows e Linux ao executar um projeto. Um caminho relativo segue o formato newFolder/newFileName.enc. A atividade cria a pasta de destino se ela ainda não existir.

• 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.
• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto continua independentemente de qualquer erro.

Symmetric wire format and interoperability

These options apply to the symmetric algorithms only. They let you decrypt ciphertext produced by external tools such as openssl enc, Java, and Python. Each option must match what was used at encrypt time.

• Wire Format - The symmetric ciphertext layout to decrypt. Must match the format used at encrypt time. 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). The IV, when present, is read from the ciphertext stream prefix automatically.
  • UiPath (OWASP 2026) - The Classic layout with a stronger, OWASP-recommended KDF iteration count.
  • Raw (caller-supplied key and IV) - A caller-supplied key, for third-party interoperability. Requires Key Bytes Format to be Hex or Base64.
  • OpenSSL enc (Salted__ + PBKDF2-SHA256) - Decrypts openssl enc-compatible input.
• 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.
• KDF Iterations - The PBKDF2 iteration count. Must match the value used at encrypt time, because it is not carried in the wire format. 0 uses the format's OWASP-recommended default. Rejected for UiPath (Classic) and Raw (caller-supplied key and IV).
• AES Key Size - The AES key size, in bits, used to encrypt the input. 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 producer used; it is not stored in the wire format.

PGP

These options apply when Algorithm is PGP.

• Private Key File Path - The path to your PGP private key file. Required when Algorithm is PGP.
• Passphrase - The passphrase that unlocks your private key. 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).
• Verify Signature - When enabled, verifies the PGP signature of the decrypted data using the public key. This field only supports Boolean values (True, False). The default value is False.
• Public Key File Path - The path to the signer's PGP public key file. Required only when Verify Signature is enabled.

Dependendo do caminho de saída e se o arquivo já existir, podem ocorrer os seguintes resultados:

Nome e local do arquivo de saída	Substituir	Resultado da saída
Desarmar	Desativado	Um arquivo com o nome de arquivo original + o sufixo "_Decrypted". Se o arquivo já existir, um erro é gerado.
Desarmar	Ligado	Um arquivo com o nome de arquivo original + o sufixo "_Decrypted". Se o arquivo já existir, ele será substituído.
DEFINIR	Desativado	Um arquivo de acordo com a preferência do usuário. Se o arquivo já existir, um erro é gerado.
DEFINIR	Ligado	Um arquivo de acordo com a preferência do usuário. Se o arquivo já existir, ele será substituído.

Saída

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

Windows - Configuração legada

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto continua independentemente de qualquer erro.
  Observação:

  Se esta atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

• DisplayName - O nome de exibição da atividade.

Entrada

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

  Observação:

  Ao usar o algoritmo AES GCM , a entrada de descriptografia deve ser fornecida no formato de (bytes concatenados): Salt (8bytes) + IV (12 bytes) + encryptedData (variable bytes) + Tag (16 bytes). A atividade também usa os seguintes parâmetros:

  • A contagem de iterações de PBKDF2 é de 10.000
  • A chave gerada tem 256 bits (32 bytes)

  Observe que a chave gerada de 256 bits não é a mesma que a opção de entrada Chave .

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

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.