Decrypt Text

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

UiPath.Cryptography.Activities.DecryptText

Description

Descriptografa uma string usando um algoritmo e chave simétricos ou usando PGP com uma chave privada. Retorna a string de texto simples. A entrada criptografada é codificada em Base64 para algoritmos simétricos e protegida em ASCII para PGP.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, configuração multiplataforma

• 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.
• Text - The text that you want to decrypt. This field supports only strings and String variables.
• Chave - A chave que você deseja usar para descriptografar o texto 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 . Usado apenas pelos algoritmos simétricos. 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.
• Codificação de texto — a codificação usada para converter os bytes descriptografados de volta para o texto. Defina isso para corresponder à codificação usada pela ferramenta que produziu o texto cifrado. Independente da Codificação de Chave - ambos oferecem a mesma lista completa de codificações de texto e padrão para Unicode (UTF-8). Usado apenas pelos algoritmos simétricos.
• Continue On Error - Specifies if the automation should continue even if the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

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.

Saída

• Decrypted Text - Reference to the decrypted text stored in a String variable for use in other activities.

Windows - Configuração legada

Painel de Propriedades

Comum

• Continue On Error - Specifies if the automation should continue even if the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  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 .

• Codificação — a codificação usada para interpretar o texto de entrada e a chave especificada na propriedade Key . Este campo é compatível apenas com variáveis Encoding . Para obter mais informações sobre esse tipo de variável, consulte a documentação oficial da Microsoft.

• Key - The key that you want to use to decrypt the specified file. This field supports only strings and String variables.

• Key Secure String - The secure string used to decrypt the input string.

• Text - The text that you want to decrypt. This field supports only strings and String variables.

Diversos

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

Saída

• Result - The decrypted text, stored in a String variable.