Skip to main content
指定されたデータまたはファイルをAES アルゴリズムを使用して暗号化します。

必要なパラメータ

  • keyVaultEntry: キーに使用する暗号化されたVault アイテムの名前。このVault アイテムに保存される値は、keyVaultEntryFormat で設定されたエンコードに一致し、選択したアルゴリズムの長さ要件を満たす必要があります。
  • ivVaultEntry: 初期化ベクトル(IV)に使用する暗号化されたVault アイテムの名前。このVault アイテムに保存される値は、ivVaultEntryFormat で設定されたエンコードに一致し、選択したアルゴリズムの長さ要件を満たす必要があります。

オプションのパラメータ

  • algorithm: 暗号化に使用するアルゴリズムの名前。現在、AES のみがサポートされる値です。128、192、256ビットのキー長に対応しています。
  • cipherMode: データを処理して暗号化するために使用する方式。使用可能な値はCBCECBOFBCFBCTS8OFB8CFBGCMCTRXTS です。デフォルトはCBC です。
  • paddingMode: メッセージを暗号化する際に余分なデータや欠落したデータを処理し、平文が正しく構築されるようにするために使用する方式。使用可能な値はPKCS7ZerosNoneANSIX923ISO10126 です。デフォルトはPKCS7 です。
  • keyVaultEntryFormat: keyVaultEntry アイテムに保存される値のエンコード。使用可能な値はHEXBASE648BITRAW です。デフォルトはHEX です。
  • ivVaultEntryFormat: ivVaultEntry アイテムに保存される値のエンコード。使用可能な値はHEXBASE648BITRAW です。デフォルトはHEX です。
  • data: 暗号化するデータ。
  • file: 暗号化するファイル。
  • outFile: 暗号化したデータを保存するファイル。
  • inFormat: 暗号化された入力データに使用するフォーマット。使用可能な値はHEXBASE648BITRAW です。デフォルトはHEX です。
  • outFormat: 暗号化された出力データに使用するフォーマット。使用可能な値はHEXBASE648BITRAW です。デフォルトはHEX です。

アウトプット属性

  • data: outFile が指定されていない場合の、暗号化されたデータ。
  • outFile: outFile が指定された場合の、暗号化されたデータを含むファイル。

次の例では、cryptoEncrypt オペレーションを使用して特定の値を暗号化します。デフォルトのAES アルゴリズムと、keyVaultEntryFormat およびivVaultEntryFormat パラメータのデフォルトのHEX エンコードを使用します。デフォルトを使用するため、これらのパラメータを明示的に設定する必要はありません。これは、keyVaultEntry およびivVaultEntry の「key」と「iv」のVault アイテムに保存される値が、ちょうど128ビットのHEX エンコードの値でなければならないことを意味します。例:
  • 「key」Vault アイテムに保存される値:7A3F9D5C1E8B6A407D2E4C9F5B1A6D3E
  • 「iv」Vault アイテムに保存される値:C1D4A7F82E395B6C4D7A1E3F9B02586D
正しい長さまたはエンコードの値を使用しないと、暗号化処理中にエラーが発生します。