com.nttdocomo.security
クラス CipherSessionKey

Object
  com.nttdocomo.security.CipherSessionKey

public final class CipherSessionKey

extends Object

[iアプリオプションAPI]

セッション鍵を表すクラスです。

導入されたバージョン:

DoJa-5.1 (905i)

メソッドの概要

SymmetricCipher	createSymmetricCipher(int cipher, byte[] iv, boolean encrypt) セッション鍵と指定された暗号化方式、初期化ベクタから共通鍵暗号オブジェクトを生成します。
byte[]	getEncryptedSessionKey() 暗号化されたセッション鍵を取得します。

クラス Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getEncryptedSessionKey

public byte[] getEncryptedSessionKey()

暗号化されたセッション鍵を取得します。

取得される鍵の値はこのオブジェクトが内部で保持している配列のコピーです。

戻り値:

暗号化されたセッション鍵をバイト配列で返します。

関連項目:

CipherPBE.createCipherSessionKey(int), CipherPBE.createCipherSessionKey(byte[])

createSymmetricCipher

public SymmetricCipher createSymmetricCipher(int cipher,
                                             byte[] iv,
                                             boolean encrypt)

セッション鍵と指定された暗号化方式、初期化ベクタから共通鍵暗号オブジェクトを生成します。

暗号化/復号化を指定することにより、暗号化用または復号化用のオブジェクトとなります。

暗号化方式には、SymmetricCipherで定義されている暗号化方式を指定します。 暗号化方式に未定義の値を指定した場合には例外が発生します。 初期化ベクタには、暗号化方式の暗号化ブロックサイズと等しいサイズのバイト配列を指定します。 初期化ベクタに null が指定された場合には例外が発生します。 このオブジェクトのセッション鍵の鍵長、または初期化ベクタのサイズが、指定した暗号化方式と異なる場合には例外が発生します。

暗号化する場合には、任意の暗号化方式、初期化ベクタを指定できます。 復号化する場合には、各パラメータに暗号化で使用した値を指定しなければなりません。 暗号化で使用したものと異なった値を指定した場合には、 SymmetricCipher.execute(byte[])、SymmetricCipher.executeFinal(byte[])で正しく復号化されません。

ミニマムスペック:

ミニマムスペックでは、このオブジェクトから生成できる SymmetricCipher オブジェクトは 1 つです。

パラメータ:

cipher - SymmetricCipherクラスで定義されている暗号化方式を指定します。

iv - 初期化ベクタを指定します。

encrypt - 暗号化する場合にはtrueを、復号化する場合にはfalseを指定します。

戻り値:

SymmetricCipher オブジェクトを返します。

例外:

NullPointerException - 引数 iv に null が指定された場合に発生します。

IllegalArgumentException - 引数 cipher に不正な値が指定された場合に発生します。

IllegalArgumentException - セッション鍵の鍵長または初期化ベクタのサイズが暗号化方式に対応していない場合や、 このメソッドで指定した暗号化方式と CipherPBE.createCipherSessionKey(int) で指定した暗号化方式が異なる場合に発生します。

IllegalStateException - SymmetricCipher オブジェクトが作成できない場合に発生します。

関連項目:

SymmetricCipher, CipherPBE.createCipherSessionKey(int), CipherPBE.createCipherSessionKey(byte[])