Decrypt Text

Activité Décrypter le texte pour déchiffrer une chaîne avec un algorithme et une clé symétriques, ou avec une clé PGP privée.

UiPath.Cryptography.Activities.DecryptText

Description

Décrypte une chaîne à l'aide d'un algorithme et d'une clé symétriques, ou à l'aide de PGP avec une clé privée. Renvoie la chaîne de texte brut. L'entrée chiffrée est encodée en Base64 pour les algorithmes symétriques et renforcée au format ASCII pour PGP.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, configuration multiplate-forme

• Algorithme : un menu déroulant qui vous permet de sélectionner l'algorithme de déchiffrement que vous souhaitez utiliser. Les options suivantes sont disponibles: AES GCM, ChatCha20-Poly1305 (Non-FIPS), PGP - Trust Layer (Non-FIPS), AES (obsolète), DES (obsolète), RC2 (non-FIPS) (obsolète), Rijndael (Non-FIPS) (Obsolète) et tripleDES (Obsolète). Sélectionnez PGP pour déchiffrer avec une clé privée au lieu d’une clé symétrique. L'algorithme doit correspondre à celui utilisé pour chiffrer l'entrée.
• Text - The text that you want to decrypt. This field supports only strings and String variables.
• Clé - Clé que vous souhaitez utiliser pour déchiffrer le texte spécifié. Utilisé par les algorithmes symétriques uniquement. Ce champ ne prend en charge que les chaînes et les variables String . Pour entrer la clé sous forme de chaîne sécurisée au lieu de texte brut, sélectionnez le menu de saisie du champ et choisissez Activer/Désactiver l’entrée sécurisée - cela utilise la propriété Key Secure String (une SecureString).

Options avancées

Options

• Encodage de clé : l'encodage utilisé pour interpréter la clé spécifiée dans la propriété Clé . Utilisé par les algorithmes symétriques uniquement. La liste déroulante répertorie tous les encodages de texte (pages de code) disponibles sur la machine, les plus courants étant affichés en premier: Valeur par défaut système, Unicode (UTF-8) (par défaut), Unicode, Unicode (Big-EnAuthentic), Unicode (UTF-32 ) . Des pages de code régional et hérité supplémentaires suivent dans la liste.
• Encodage de texte : l'encodage utilisé pour reconvertir les octets déchiffrés en texte. Définissez ce champ pour qu'il corresponde à l'encodage utilisé par l'outil ayant produit le texte chiffré. Indépendant de l'encodage de clé : les deux offrent la même liste complète d'encodages de texte et utilisent par défaut Unicode. Utilisé par les algorithmes symétriques uniquement.
• 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.

Format de fichiers symétrique et interopérabilité

Ces options s'appliquent uniquement aux algorithmes symétriques. Ils vous permettent de déchiffrer le texte chiffré produit par des outils externes tels que openssl enc, Java et Python. Chaque option doit correspondre à ce qui a été utilisé au moment du chiffrement.

• Format de fil de discussion : la mise en page du texte chiffré chiffré à déchiffrer. Doit correspondre au format utilisé au moment du chiffrement. Les options suivantes sont disponibles:
  • UiPath (classique) : (par défaut): mise en page byte-stable d'UiPath (salt(8) + IV + ciphertext [+ tag], PCompilation. Le IV, lorsqu’il est présent, est lu automatiquement à partir du préfixe du flux de texte chiffré.
  • UiPath : La mise en page classique avec un nombre d'itérations KDF plus élevé recommandé par OWASP.
  • Brut (clé fournie par l'appelant et IV) : une clé fournie par l'appelant, pour l'interopérabilité avec des tiers. Nécessite le format des octets de clé hexadécimal ou Base64.
  • OpenSSL enc - Décrypte l'entrée compatible openssl enc .
• Format d'octets de clé : comment la chaîne de clé est interprétée. Les options suivantes sont disponibles: Hex et Base64. Requis lorsque le format de fil de discussion est brut (clé fournie par l'appelant et IV); sinon, la clé est traitée comme un mot de passe.
• Itérations KPDF - Le nombre d’itérations PCompiles. Doit correspondre à la valeur utilisée au moment du chiffrement, car elle n’est pas conservée dans le format de fil de discussion. 0 utilise la valeur par défaut recommandée par OWASP du format. Rejeté pour UiPath (classique) et Raw (clé fournie par l'appelant et IV).
• Taille de la clé AES : la taille de la clé AES, en bits, utilisée pour chiffrer l'entrée. Les options suivantes sont disponibles: 128 bits, 192 bits et 256 bits (par défaut). S’applique uniquement lorsque l’algorithme est AES et que le format de fil de discussion est OpenSSL enc. Doit correspondre à la taille de la clé utilisée par le producteur; elle n'est pas stockée dans le format fil.

PGP

Ces options s'appliquent lorsque l'algorithme est défini sur PGP.

• Chemin du fichier de clé privée : le chemin d’accès à votre fichier de clé PGP privée. Requis lorsque l'algorithme est PGP.
• Phrase de passe : la phrase de passe qui déverrouille votre clé privée. Pour le fournir sous forme de chaîne sécurisée au lieu de texte brut, sélectionnez le menu d'entrée du champ et passez à l'entrée Mot de passe (Sécurisé) ( SecureString)
• Vérifier la signature - Lorsque cette option est activée, la signature PGP des données déchiffrées est vérifiée à l’aide de la clé publique. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False.
• Chemin du fichier de clé publique : le chemin d’accès au fichier de clé publique PGP du signataire. Obligatoire uniquement lorsque l'option Vérifier la signature est activée.

Sortie

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

Configuration Windows - Héritage

Panneau propriétés

Commun

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

  Si cette activité est incluse dans Essayer de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

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

  Remarque :

  Lors de l'utilisation de l'algorithme AES GCM , l'entrée de déchiffrement doit être fournie au format de (octets concaténés) : Salt (8bytes) + IV (12 bytes) + encryptedData (variable bytes) + Tag (16 bytes). L'activité utilise également les paramètres suivants :

  • Le nombre d'itérations PBKDF2 est de 10 000
  • La clé générée est de 256 bits (32 octets)

  Notez que la Clé générée 256 bits n'est pas la même que l'option d'entrée Clé .

• Encoding : l'encodage utilisé pour interpréter le texte d'entrée et la clé spécifiés dans la propriété Key. Ce champ prend uniquement en charge les variables Encoding. Pour plus d'informations sur ce type de variable, consultez la documentation officielle de 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.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

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