decrypt()

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

構文

パラメーター

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）が必要な動作モードを使用するときに指定するバイナリ値です。

説明

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

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

エラーコード

使用例

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

   json "{}"
   | eval key = frombase64("mRcOlK9V47rjVL/RBYQYRw=="),
          encrypted = frombase64("y7+NQQ9/9xGtbBq5pgBvCA=="),
          decrypted = decode(decrypt("AES", key, encrypted))
   | # decrypted: hello, world!
   

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

   json "{}"
   | eval key = frombase64("mRcOlK9V47rjVL/RBYQYRw=="),
          iv = frombase64("AAAAAAAAAAAAAAAAAAAAAA=="),
          encrypted = frombase64("..."),
          decrypted = decrypt("AES/CBC/PKCS5Padding", key, encrypted, iv)
   

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

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

互換性

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