Decrypt File

Atividade Decrypt File para descriptografar um arquivo com um algoritmo e chave simétricos ou com uma chave privada PGP.

UiPath.Cryptography.Activities.DecryptFile

Description

Descriptografa um arquivo usando um algoritmo e chave simétricos ou usando PGP com uma chave privada. O resultado é gravado em um novo arquivo.

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 .
• Algoritmo - Um menu suspenso que permite selecionar o algoritmo de descriptografia que você deseja usar. As seguintes opções estão disponíveis: AES GCM, ChaCha20-Poly1305 (Non-FIPS), PGP - Razoavelmente Boa Privacidade (Non-FIPS), AES (Obsoleto), DES (Obsoleto), RC2 (Non-FIPS) (Obsoleto) e Rijndael (Non-FIPS) (obsoleto) e TriplicadoDES (Obsoleto). Selecione PGP para descriptografar com uma chave privada em vez de uma chave simétrica. O algoritmo deve corresponder ao usado para criptografar a entrada.
• Chave - A chave que você deseja usar para descriptografar o arquivo especificado. Usado apenas pelos algoritmos simétricos. Este campo é compatível apenas com strings e variáveis String . Para inserir a chave como uma string segura em vez de texto simples, selecione o menu de entrada do campo e escolha Alternar para entrada segura - isso usa a propriedade String Segura da Chave (um SecureString).

Opções avançadas

Opções

• Codificação de chave - A codificação usada para interpretar a chave especificada na propriedade Chave . O menu suspenso lista todas as codificações de texto (páginas de código) disponíveis na máquina, com as mais comuns exibidas primeiro: Padrão do sistema, Unicode (UTF-8) (padrão), Unicode, Unicode (Big-Endian), Unicode (UTF-32 ) . As páginas adicionais de código regional e legado seguem na lista.
• 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.

Formato de conexão simétrica e interoperabilidade

Essas opções se aplicam apenas aos algoritmos simétricos. Eles permitem que você descriptografe o texto criptografado produzido por ferramentas externas, openssl enc, Java e Python. Cada opção deve corresponder ao que foi usado no momento da criptografia.

• Formato de conexão — o layout de texto cifrado simétrico a ser descriptografado. Deve corresponder ao formato usado no momento da criptografia. As seguintes opções estão disponíveis:
  • UiPath (Clássico) (padrão) - o layout estável de bytes da UiPath (salt(8) + IV + ciphertext [+ tag], PFKF2-HTAC-SHA1 em 10.000 iterações). O IV, quando presente, é lido do prefixo do fluxo de texto cifrado automaticamente.
  • UiPath (OWASP 2026) - O layout Clássico com uma contagem de iterações KPD mais forte recomendada pelo OWASP.
  • Bruta (chave fornecida pelo chamador e IV) - Uma chave fornecida pelo chamador, para interoperabilidade de terceiros. Requer que o Formato de Key Bytes seja Hex ou Base64.
  • OpenSSL eNC (Salted__ + RBKF2-SHA256) - Descriptografa openssl enc-compatível com a entrada.
• Formato de bytes de chave - Como a string de chave é interpretada. As seguintes opções estão disponíveis: Hex e Base64. Necessário quando o Formato da conexão é Bruto (chave fornecida pelo chamador e IV); caso contrário, a chave será tratada como uma senha.
• Iterações do KPD - A contagem de iterações RBKF2. Deve corresponder ao valor usado no momento da criptografia, porque ele não é carregado no formato de conexão. 0 o padrão OWASP do formato. Rejeitado para UiPath (Clássico) e Bruto (chave fornecida pelo chamador e IV).
• Tamanho da chave AES - O tamanho da chave AES, em bits, usada para criptografar a entrada. As seguintes opções estão disponíveis: 128 bits, 192 bits e 256 bits (padrão). Aplica-se apenas quando o Algoritmo é AES e o Formato da Ligação é OpenSSL ec (Salted__ + RBKF2-SHA256). Deve corresponder ao tamanho da chave que o produtor usou; não é armazenado no formato de informações.

PGP

Essas opções se aplicam quando o Algoritmo é PGP.

• Caminho do arquivo da chave privada - O caminho para seu arquivo da chave privada PGP. Obrigatório quando o Algoritmo é PGP.
• Frase secreta - A frase secreta que desbloqueia sua chave privada. Para fornecê-la como uma string segura em vez de texto simples, selecione o menu de entrada do campo e alterne para a entrada Frase secreta (Segura) (um SecureString).
• Verificar assinatura - Quando habilitado, verifica a assinatura PGP dos dados descriptografados usando a chave pública. Este campo só aceita valores booleanos (True, False). O valor padrão é False.
• Caminho do arquivo da chave pública - O caminho para o arquivo da chave pública PGP do signatário. Necessário apenas quando a opção Verificar Assinatura está habilitada.

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.