テキストを復号

UiPath.Cryptography.Activities.DecryptText

説明

Decrypts a string using a symmetric algorithm and key, or using PGP with a private key. Returns the plaintext string. The encrypted input is Base64-encoded for symmetric algorithms and ASCII-armored for PGP.

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows、クロスプラットフォームでの設定

• 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.
• テキスト - 復号するテキストです。このフィールドは、文字列と String 型変数のみをサポートします。
• Key - The key that you want to use to decrypt the specified text. 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).

詳細オプション

オプション

• Key Encoding - The encoding used to interpret the key specified in the Key property. Used by the symmetric algorithms only. 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.
• Text Encoding - The encoding used to convert the decrypted bytes back to text. Set this to match the encoding used by the tool that produced the ciphertext. Independent from Key Encoding - both offer the same full list of text encodings and default to Unicode (UTF-8). Used by the symmetric algorithms only.
• エラー発生時に実行を継続 - アクティビティがエラーをスローした場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白でエラーがスローされると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

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.

出力

• 復号済みのテキスト - 復号済みのテキストへの参照です。String 型変数に格納され、他のアクティビティで使用できます。

Windows - レガシでの設定

プロパティ パネル

共通

• エラー発生時に実行を継続 - アクティビティがエラーをスローした場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白でエラーがスローされると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
  注:

  このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True である場合、プロジェクトの実行時にエラーが捕捉されません。

• 表示名 - アクティビティの表示名です。

入力

• アルゴリズム - 使用する復号アルゴリズムを選択するためのドロップダウン メニューです。利用可能なオプションは、AES (非推奨)、AES GCM、DES (非推奨)、RC2 (非 FIPS) (非推奨)、Rijndael (非 FIPS) (非推奨)、TripleDES です。

  注:

  AES GCMアルゴリズムを使用する場合、復号化入力は(連結バイト)の形式で指定する必要があります。 Salt (8bytes) + IV (12 bytes) + encryptedData (variable bytes) + Tag (16 bytes)。このアクティビティでは、次のパラメーターも使用します。

  • PBKDF2 の反復回数は 10000 です。
  • 生成されるキーは 256 ビット (32 バイト) です。

  256 ビットで生成されるキーは、[キー] 入力オプションと同じではないことに注意してください。

• エンコード - 入力テキストと [キー] プロパティに指定するキーの解釈に使用するエンコードです。このフィールドでは Encoding 型変数のみがサポートされています。この変数型の詳細については、Microsoft の公式ドキュメントをご覧ください。

• キー - 指定したファイルの復号に使用するキーです。このフィールドは、文字列と String 型変数のみをサポートします。

• キー (SecureString) - 入力文字列の復号に使用する、セキュリティで保護された文字列です。

• テキスト - 復号するテキストです。このフィールドは、文字列と String 型変数のみをサポートします。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 結果 - 復号したテキストです。String 型変数に格納されます。