KeyAgreementSpi (Java 2 Platform SE 5.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Standard Ed. 5.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.crypto
クラス KeyAgreementSpi

java.lang.Object
  javax.crypto.KeyAgreementSpi

public abstract class KeyAgreementSpi
extends Object
extends Object

このクラスは、KeyAgreement クラスの Service Provider Interface (SPI) を定義します。特定の鍵合意アルゴリズムの実装を提供する各暗号化サービスプロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。

共有の秘密情報の確立に関係する鍵は、鍵ジェネレータ (KeyPairGenerator または KeyGenerator) の 1 つ、または KeyFactory によって、あるいは鍵合意プロトコル (@see #engineDoPhase(java.security.Key, boolean) engineDoPhase) の中間段階の結果として作成されます。

鍵交換の対応関係ごとに、engineDoPhase を呼び出す必要があります。たとえば、鍵交換の相手が 1 つの場合は、lastPhase フラグを true に設定して engineDoPhase を 1 回呼び出す必要があります。鍵交換の相手が 2 つの場合は、最初は lastPhase フラグを false に設定し、2 回目は true に設定して、engineDoPhase を 2 回呼び出す必要があります。鍵交換の相手の数は任意です。

導入されたバージョン:: 1.4
関連項目:: KeyGenerator, SecretKey

コンストラクタの概要
`KeyAgreementSpi()`

メソッドの概要
`protected abstract Key`	`engineDoPhase(Key key, boolean lastPhase)` この鍵合意に関係する相手のだれかから受け取った、指定された鍵を使用してこの鍵合意の次の段階を実行します。
`protected abstract byte[]`	`engineGenerateSecret()` 共有の秘密情報を生成して新しいバッファ内に返します。
`protected abstract int`	`engineGenerateSecret(byte[] sharedSecret, int offset)` 共有の秘密情報を生成して、`offset` から始まる `sharedSecret` バッファ内に格納します。
`protected abstract SecretKey`	`engineGenerateSecret(String algorithm)` 共有の秘密情報を作成して、それを要求されたアルゴリズム型の秘密鍵オブジェクトとして返します。
`protected abstract void`	`engineInit(Key key, AlgorithmParameterSpec params, SecureRandom random)` 指定された鍵、アルゴリズムパラメータのセット、および乱数の発生源を使用してこの鍵合意を初期化します。
`protected abstract void`	`engineInit(Key key, SecureRandom random)` 指定された鍵と乱数の発生源でこの鍵合意を初期化します。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

コンストラクタの詳細

KeyAgreementSpi

public KeyAgreementSpi()

メソッドの詳細

engineInit

protected abstract void engineInit(Key key,
                                   SecureRandom random)
                            throws InvalidKeyException

指定された鍵と乱数の発生源でこの鍵合意を初期化します。指定された鍵には、この鍵合意に必要なすべてのアルゴリズムパラメータを含める必要があります。

鍵合意アルゴリズムが乱数バイトを必要とする場合は、指定された乱数の発生源 random から取得します。ただし、基本となるアルゴリズム実装が乱数バイトを必要としない場合、random は無視されます。

パラメータ:: key - 当事者の非公開情報。たとえば、Diffie-Hellman の鍵合意の場合は、当事者自身の Diffie-Hellman 非公開鍵; random - 乱数のソース
例外:: InvalidKeyException - 指定された鍵がこの鍵合意に不適切な場合。たとえば、型が間違っている場合、またはアルゴリズムの型に互換性がない場合

engineInit

protected abstract void engineInit(Key key,
                                   AlgorithmParameterSpec params,
                                   SecureRandom random)
                            throws InvalidKeyException,
                                   InvalidAlgorithmParameterException

指定された鍵、アルゴリズムパラメータのセット、および乱数の発生源を使用してこの鍵合意を初期化します。

パラメータ:: key - 当事者の非公開情報。たとえば、Diffie-Hellman の鍵合意の場合は、当事者自身の Diffie-Hellman 非公開鍵; params - 鍵合意パラメータ; random - 乱数のソース
例外:: InvalidKeyException - 指定された鍵がこの鍵合意に不適切な場合。たとえば、型が間違っている場合、またはアルゴリズムの型に互換性がない場合; InvalidAlgorithmParameterException - 指定されたパラメータがこの鍵合意に不適切な場合

engineDoPhase

protected abstract Key engineDoPhase(Key key,
                                     boolean lastPhase)
                              throws InvalidKeyException,
                                     IllegalStateException

この鍵合意に関係する相手のだれかから受け取った、指定された鍵を使用してこの鍵合意の次の段階を実行します。

パラメータ:: key - この段階の鍵。たとえば、2 当事者間の Diffie-Hellman の場合は、相手の Diffie-Hellman 公開鍵; lastPhase - これがこの鍵合意の最後の段階かどうかを示すフラグ
戻り値:: この段階の結果の (中間) 鍵。この段階で鍵が生成されない場合は null
例外:: InvalidKeyException - 指定された鍵がこの段階に不適切な場合; IllegalStateException - この鍵合意が初期化されていない場合

engineGenerateSecret

protected abstract byte[] engineGenerateSecret()
                                        throws IllegalStateException

共有の秘密情報を生成して新しいバッファ内に返します。

このメソッドは、この KeyAgreementSpi オブジェクトをリセットするので、さらにほかの鍵合意に再使用できます。この鍵合意が engineInit メソッドの 1 つで再初期化されない場合、その後の鍵合意では、同じ非公開情報とアルゴリズムパラメータが使用されます。

戻り値:: 共有の秘密情報の入った新しいバッファ
例外:: IllegalStateException - この鍵合意がまだ完了していない場合

engineGenerateSecret

protected abstract int engineGenerateSecret(byte[] sharedSecret,
                                            int offset)
                                     throws IllegalStateException,
                                            ShortBufferException

共有の秘密情報を生成して、offset から始まる sharedSecret バッファ内に格納します。

sharedSecret バッファが小さすぎて結果を保持できない場合は、ShortBufferException がスローされます。この場合、より大きな出力バッファを使用してこの呼び出しを繰り返します。

パラメータ:: sharedSecret - 共有の秘密情報を格納するバッファ; offset - 共有の秘密情報が格納される sharedSecret 内のオフセット
戻り値:: sharedSecret に格納されたバイト数
例外:: IllegalStateException - この鍵合意がまだ完了していない場合; ShortBufferException - 指定された出力バッファが小さすぎて秘密情報を保持できない場合

engineGenerateSecret

protected abstract SecretKey engineGenerateSecret(String algorithm)
                                           throws IllegalStateException,
                                                  NoSuchAlgorithmException,
                                                  InvalidKeyException

共有の秘密情報を作成して、それを要求されたアルゴリズム型の秘密鍵オブジェクトとして返します。

パラメータ:: algorithm - 要求された秘密鍵アルゴリズム
戻り値:: 共有の秘密鍵
例外:: IllegalStateException - この鍵合意がまだ完了していない場合; NoSuchAlgorithmException - 要求された秘密鍵アルゴリズムがない場合; InvalidKeyException - 共有の秘密鍵データを使用して、要求されたアルゴリズム型の秘密鍵を生成できない場合 (たとえば、鍵データが短すぎる)