- 概要
- 暗号化
- データベース
- Java
- Python
- Web API
開発者向けのアクティビティ
UiPath.Cryptography.Activities.EncryptText
説明
対称アルゴリズムと鍵を使用するか、受信者の公開鍵で 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 (非推奨)。AES GCM および ChaCha20-Poly1305 (非 FIPS) は、新しいワークフローに推奨される認証済み (AEAD) アルゴリズムです。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 回)。以前のバージョンと同じ出力を生成します。 - UiPath (OWASP 2026) - クラシック レイアウトに、OWASP 推奨の KDF の反復回数が増えました。
- Raw (呼び出し元が指定したキーと IV) - サードパーティの相互運用性のために、呼び出し元が指定したキーと IV。[キー バイトの形式] を 16 進数または Base64 にする必要があります。
- OpenSSL enc (Salted__ + PBKDF2-SHA256) -
openssl enc互換の出力を生成します。
- UiPath (クラシック) (既定) - UiPath のバイト安定レイアウト (
- キーのバイト形式 - キー 文字列の解釈方法。使用できるオプションは 、Hex と Base64です。[ワイヤ形式(Wire Format)] が [Raw(呼び出し元指定のキーと IV))] の場合は必須です。それ以外の場合、キーはパスワードとして扱われます。
- IV - [ワイヤ形式 ] が [Raw] ( 呼び出し元指定のキーと IV) の場合に使用される初期化ベクトル。キーバイト形式に従って解釈されます。任意 - 暗号で生成するには空のままにします。他のすべてのフォーマットでは拒否されました。
- KDF 反復 - PBKDF2 反復回数です。
0では、この形式の OWASP 推奨のデフォルト ( UiPath (OWASP 2026) の場合は 1,300,000、 OpenSSL enc の場合は 600,000) が使用されます。UiPath (クラシック) および Raw (呼び出し元指定のキーと IV) を理由に拒否されました。 - AES キー サイズ - AES キーのサイズ (ビット単位) です。使用できるオプションは、 128 ビット、 192 ビット、 および 256 ビット (既定) です。[アルゴリズム(Algorithm)] が AES で、[ワイヤ形式(Wire Format)] が OpenSSL enc(Salted__ + PBKDF2-SHA256)の場合にのみ適用されます。ピアが使用するキー サイズと一致する必要があります。ワイヤ形式では格納されないため、暗号化側と復号化側は一致する値を使用する必要があります。
PGP
これらのオプションは、アルゴリズムがPGPの場合に適用されます。
- 公開キー ファイルのパス - 受信者の PGP 公開キー ファイルへのパスです。アルゴリズムがPGPの場合は必須です。
- 秘密キー ファイルのパス - PGP 秘密キー ファイルへのパスです。[データに署名] が有効な場合にのみ必要です。
- パスフレーズ - 署名時に秘密キーのロックを解除するパスフレーズです。プレーン テキストではなくセキュア文字列として指定するには、フィールドの入力メニューを選択し、[ パスフレーズ(セキュア)(Passphrase (Secure) )] 入力(
SecureString)に切り替えます。 - データに署名 - 有効化すると、秘密キーを使用して暗号化されたデータに署名します。このフィールドでは Boolean 値 (
True、False) のみがサポートされています。既定値は [Falseです。
出力
- 暗号化済みのテキスト - 暗号化済みのテキストへの参照です。
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型変数に格納されます。