encrypt()

encrypt() 関数は、指定した暗号アルゴリズムとキーを使用してバイナリデータを暗号化し、バイナリで返します。

構文

パラメーター

CIPHER

アルゴリズム/モード/パディング 形式で構成された文字列です。モードとパディングを省略してアルゴリズムのみを入力すると、そのアルゴリズムのデフォルト値を適用します。

使用できるアルゴリズム、モード、パディングは Java Security Standard Algorithm Names のドキュメントを参照してください。

KEY

指定した暗号アルゴリズムに適合するサイズのバイナリキーです。アルゴリズムごとのキー長は以下のとおりです。

• AES: 16バイト（128ビット）、24バイト（192ビット）、32バイト（256ビット）から選択
• RSA: 128バイト（1024ビット）、256バイト（2048ビット）から選択

DATA

暗号化するバイナリデータです。

IV

CBC などの初期化ベクトル（IV、Initialization Vector）が必要な動作モードを使用する場合に指定するバイナリ値です。

説明

encrypt() 関数は Java の Cipher クラスを使用して、指定した暗号アルゴリズムとキーでバイナリデータを暗号化し、バイナリを返します。

KEY または DATA が null であるか、バイナリ型でない場合は null を返します。IV が指定されている場合、IV もバイナリ型でなければならず、そうでない場合は null を返します。暗号化中にエラーが発生した場合は null を返します。

エラーコード

使用例

1. AES アルゴリズムでデータを暗号化

   json "{}"
   | eval key = frombase64("mRcOlK9V47rjVL/RBYQYRw=="),
          data = encode("hello, world!"),
          encrypted = tobase64(encrypt("AES", key, data))
   | # encrypted: y7+NQQ9/9xGtbBq5pgBvCA==
   

2. CBC モードで IV を指定して暗号化

   json "{}"
   | eval key = frombase64("mRcOlK9V47rjVL/RBYQYRw=="),
          iv = randbytes(16),
          data = encode("hello, world!"),
          encrypted = encrypt("AES/CBC/PKCS5Padding", key, data, iv)
   

3. KEY または DATA が null の場合

   json "{}" | eval result = encrypt("AES", null, encode("data"))
   | # result: null
   

互換性

encrypt() 関数は Sonar 4.0以前のバージョンから提供されています。