テキストを復号

UiPath.Cryptography.Activities.DecryptText

説明

対称アルゴリズムとキーを使用して、または秘密キーでPGPを使用して文字列を復号化します。プレーンテキストの文字列を返します。暗号化された入力は、対称アルゴリズムの場合は Base64 でエンコードされ、PGP の場合は ASCII アーマードです。

プロジェクトの対応 OS

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

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

• アルゴリズム - 使用する復号アルゴリズムを選択できるドロップダウン メニューです。次のオプションを使用できます: AES GCM、ChaCha20-Poly1305 (非 FIPS)、PGP - Pretty Good Privacy (非 FIPS)、AES (非推奨)、DES (非推奨)、RC2 (非 FIPS) (非推奨)、Rijndael (非 FIPS) (非推奨)、および TripleDES (非推奨)。PGP を選択して、対称キーではなく秘密キーで復号化します。アルゴリズムは、入力の暗号化に使用されるアルゴリズムと一致する必要があります。
• テキスト - 復号するテキストです。このフィールドは、文字列と String 型変数のみをサポートします。
• キー - 指定したテキストの復号に使用するキーです。対称アルゴリズムでのみ使用されます。このフィールドは、文字列と String 変数のみをサポートします。キーをプレーン テキストではなくセキュリティで保護された文字列として入力するには、フィールドの入力メニューを選択し、[ セキュリティで保護された入力に切り替え ] を選択します。この場合、[ キーによるセキュリティで保護された文字列 ] プロパティ (a の SecureString) が使用されます。

詳細オプション

オプション

• キーのエンコード - [ キー ] プロパティで指定されたキーの解釈に使用するエンコードです。対称アルゴリズムでのみ使用されます。ドロップダウンには、マシンで使用可能なすべてのテキスト エンコード (コード ページ) が一覧表示され、最も一般的なもの (システム デフォルト、Unicode (UTF-8) (既定)、Unicode、Unicode (ビッグ エンディアン)、Unicode (UTF-32)、Unicode (UTF-32 ビッグ エンディアン)、US-ASCII および西ヨーロッパ (ISO)) が最初に表示されます。追加のリージョン コード ページとレガシ コード ページが一覧に続きます。
• テキストのエンコード - 復号されたバイトをテキストに変換し直すために使用するエンコードです。暗号文を生成したツールで使用されるエンコードと一致するように設定します。キーエンコーディングとは無関係 - どちらもテキストエンコーディングの完全なリストを提供し、デフォルトはUnicode(UTF-8)です。対称アルゴリズムでのみ使用されます。
• エラー発生時に実行を継続 - アクティビティがエラーをスローした場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白でエラーがスローされると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

対称ワイヤフォーマットと相互運用性

これらのオプションは、対称アルゴリズムにのみ適用されます。これらのツールを使用すると、 openssl enc、Java、Python などの外部ツールによって生成された暗号文を復号できます。各オプションは、暗号化時に使用されたオプションと一致する必要があります。

• ワイヤ形式 - 復号する対称暗号文のレイアウトです。暗号化時に使用された形式と一致する必要があります。次のオプションが利用できます。
  • UiPath (クラシック) (既定) - UiPath のバイト安定レイアウト (salt(8) + IV + ciphertext [+ tag]、PBKDF2-HMAC-SHA1 反復回数 10,000 回)。IV が存在する場合は、暗号文ストリーム接頭辞から自動的に読み取られます。
  • UiPath (OWASP 2026) - クラシック レイアウトに、OWASP 推奨の KDF の反復回数が増えました。
  • Raw (呼び出し元が指定したキーと IV) - サードパーティの相互運用性のために、呼び出し元が指定したキーです。[キー バイトの形式] を 16 進数または Base64 にする必要があります。
  • OpenSSL enc (Salted__ + PBKDF2-SHA256) - 互換性のある入力 openssl enc復号します。
• キーのバイト形式 - キー 文字列の解釈方法。使用できるオプションは 、Hex と Base64です。[ワイヤ形式(Wire Format)] が [Raw(呼び出し元指定のキーと IV))] の場合は必須です。それ以外の場合、キーはパスワードとして扱われます。
• KDF 反復 - PBKDF2 反復回数です。ワイヤ形式では伝送されないため、暗号化時に使用された値と一致する必要があります。0 では、この形式の OWASP 推奨のデフォルトが使用されます。UiPath (クラシック) および Raw (呼び出し元指定のキーと IV) を理由に拒否されました。
• AES キー サイズ - 入力の暗号化に使用される AES キーのサイズ (ビット単位) です。使用できるオプションは、 128 ビット、 192 ビット、 および 256 ビット (既定) です。[アルゴリズム(Algorithm)] が AES で、[ワイヤ形式(Wire Format)] が OpenSSL enc(Salted__ + PBKDF2-SHA256)の場合にのみ適用されます。プロデューサーが使用したキー サイズと一致する必要があります。ワイヤ形式では保存されません。

PGP

これらのオプションは、アルゴリズムがPGPの場合に適用されます。

• 秘密キー ファイルのパス - PGP 秘密キー ファイルへのパスです。アルゴリズムがPGPの場合は必須です。
• パスフレーズ - 秘密キーのロックを解除するパスフレーズです。プレーン テキストではなくセキュア文字列として指定するには、フィールドの入力メニューを選択し、[ パスフレーズ(セキュア)(Passphrase (Secure) )] 入力( SecureString)に切り替えます。
• 署名の検証 - 有効にすると、公開キーを使用して復号化されたデータの PGP 署名が検証されます。このフィールドでは Boolean 値 (True、 False) のみがサポートされています。既定値は [ Falseです。
• 公開キー ファイルのパス - 署名者の PGP 公開キー ファイルへのパスです。[署名の検証] が有効な場合にのみ必要です。

出力

• 復号済みのテキスト - 復号済みのテキストへの参照です。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 型変数に格納されます。