Encrypt Text

Atividade Encrypt Text para criptografar uma string com um algoritmo e chave simétricos ou com a chave pública de um destinatário PGP.

UiPath.Cryptography.Activities.EncryptText

Description

Criptografa uma string usando um algoritmo e chave simétricos ou usando PGP com a chave pública de um destinatário. Retorna a saída criptografada como uma string: Base64 para algoritmos simétricos, ASCII para PGP.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, configuração multiplataforma

• Algoritmo — um menu suspenso que permite selecionar o algoritmo de criptografia 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). AES GCM e ChaCha20-Poly1305 (Non-FIPS) são algoritmos autenticados (AEAD) recomendados para novos fluxos de trabalho. Selecione PGP para criptografar com a chave pública de um destinatário em vez de uma chave simétrica.
• Text - The text that you want to encrypt. This field supports only strings and String variables.
• Chave - A chave que você deseja usar para criptografar a string especificada. 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 o texto de entrada em bytes antes da criptografia. Defina isso para corresponder à codificação esperada pela ferramenta de terceiros que consome 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ê produza um texto cifrado que interopera com ferramentas externas, openssl enc, Java e Python. Os fluxos de trabalho existentes que não definem o formato de Wire continuam produzindo a saída Clássica padrão, que permanece inalterada.

• Formato conectado - O layout de texto cifrado simétrico. 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). Produz a mesma saída das versões anteriores.
  • UiPath (OWASP 2026) - O layout Clássico com uma contagem de iterações KPD mais forte recomendada pelo OWASP.
  • Bruto (chave fornecida pelo chamador e IV) - Uma chave fornecida pelo chamador e IV, para interoperabilidade de terceiros. Requer que o Formato de Key Bytes seja Hex ou Base64.
  • OpenSSL eNC (Salted__ + RBKF2-SHA256) - Produz saída compatível com openssl enc .
• 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.
• IV - O vetor de inicialização, usado quando o Formato do Wire é Bruto (chave fornecida pelo chamador e IV). Interpretado de acordo com o Formato de Bytes de Chave. Opcional – deixe em branco para permitir que a cifra gere um. Rejeitado para todos os outros formatos.
• Iterações do KPD - A contagem de iterações RBKF2. 0 usa o padrão do formato recomendado pelo OWASP (1.300.000 para UiPath (OWASP 2026), 600.000 para OpenSSL eNC). Rejeitado para UiPath (Clássico) e Bruto (chave fornecida pelo chamador e IV).
• Tamanho da chave AES - O tamanho da chave AES, em bits. 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 par usa. Ele não é armazenado no formato de conexão, portanto, os lado de criptografia e descriptografia devem usar valores correspondentes.

PGP

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

• Caminho do arquivo da chave pública - O caminho para o arquivo da chave pública PGP do destinatário. Obrigatório quando o Algoritmo é PGP.
• Caminho do arquivo da chave privada - O caminho para seu arquivo da chave privada PGP. Obrigatório apenas quando Assinar dados está habilitado.
• Frase secreta - A frase secreta que desbloqueia sua chave privada ao assinar. 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).
• Assinar dados — quando habilitado, assina os dados criptografados usando sua chave privada. Este campo só aceita valores booleanos (True, False). O valor padrão é False.

Saída

• Encrypted Text - Reference to the encrypted 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 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.

  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 encrypt the specified string. This field supports only strings and String variables.

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

• Text - The text that you want to encrypt. 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 encrypted text, stored in a String variable.