|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.security.SignatureSpi
Signature
クラスの Service Provider Interface (SPI) を定義します。これは、デジタル署名アルゴリズムの機能を提供するために使われます。デジタル署名は、デジタルデータの認証と整合性の保証のために使用されます。
特定の署名アルゴリズムの実装を提供する各暗号サービスプロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。
Signature
フィールドの概要 | |
protected SecureRandom |
appRandom
アプリケーション固有の乱数の発生源です。 |
コンストラクタの概要 | |
SignatureSpi()
|
メソッドの概要 | |
Object |
clone()
実装が複製可能な場合は複製を返します。 |
protected abstract Object |
engineGetParameter(String param)
推奨されていません。 |
protected abstract void |
engineInitSign(PrivateKey privateKey)
署名オブジェクトを、署名操作のために指定された非公開鍵で初期化します。 |
protected void |
engineInitSign(PrivateKey privateKey,
SecureRandom random)
署名オブジェクトを、署名操作のために指定された非公開鍵と乱数の発生源で初期化します。 |
protected abstract void |
engineInitVerify(PublicKey publicKey)
署名オブジェクトを、検証操作のために指定された公開鍵で初期化します。 |
protected void |
engineSetParameter(AlgorithmParameterSpec params)
署名エンジンを、指定されたパラメータセットを使って初期化します。 |
protected abstract void |
engineSetParameter(String param,
Object value)
推奨されていません。 engineSetParameter で置き換えます。 |
protected abstract byte[] |
engineSign()
これまでに更新されたすべてのデータのうちの署名データを返します。 |
protected int |
engineSign(byte[] outbuf,
int offset,
int len)
署名操作を終了し、最終的な署名バイトを、指定されたバッファ outbuf に offset から格納します。 |
protected abstract void |
engineUpdate(byte b)
署名または検証されるデータを、指定されたバイトで更新します。 |
protected abstract void |
engineUpdate(byte[] b,
int off,
int len)
署名または検証するデータを、指定されたバイトの配列を使って、指定されたオフセットから更新します。 |
protected abstract boolean |
engineVerify(byte[] sigBytes)
渡された署名を検証します。 |
クラス java.lang.Object から継承したメソッド |
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
protected SecureRandom appRandom
コンストラクタの詳細 |
public SignatureSpi()
メソッドの詳細 |
protected abstract void engineInitVerify(PublicKey publicKey) throws InvalidKeyException
publicKey
- 署名が検証されるアイデンティティの公開鍵InvalidKeyException
- 鍵の符号化が不適切な場合、パラメータが欠落しているなどの場合protected abstract void engineInitSign(PrivateKey privateKey) throws InvalidKeyException
privateKey
- 署名が生成されるアイデンティティの非公開鍵InvalidKeyException
- 鍵の符号化が不適切な場合、パラメータが欠落しているなどの場合protected void engineInitSign(PrivateKey privateKey, SecureRandom random) throws InvalidKeyException
この具象メソッドは、この定義済みの抽象クラスに追加されています (下位互換のため、抽象メソッドにはなれない)。
privateKey
- 署名が生成されるアイデンティティの非公開鍵random
- 乱数の発生源InvalidKeyException
- 鍵の符号化が不適切な場合、パラメータが欠落しているなどの場合protected abstract void engineUpdate(byte b) throws SignatureException
b
- 更新に使うバイトSignatureException
- エンジンが適切に初期化されていない場合protected abstract void engineUpdate(byte[] b, int off, int len) throws SignatureException
data
- バイトの配列off
- バイトの配列での開始オフセットlen
- オフセットから開始して使われるバイト数SignatureException
- エンジンが適切に初期化されていない場合protected abstract byte[] engineSign() throws SignatureException
SignatureException
- エンジンが適切に初期化されていない場合protected int engineSign(byte[] outbuf, int offset, int len) throws SignatureException
outbuf
に offset
から格納します。署名の形式は基になる署名方式に依存します。
署名実装は、その初期状態 (engineInitSign
メソッドの 1 つに呼び出された直後の状態) にリセットされます。リセットされたあとは、同じ非公開鍵を使ってさらに署名を生成するために再利用できます。
このメソッドは抽象メソッドでなければなりませんが、バイナリ互換を保つために具象メソッドのままにしておきます。互換性を配慮するプロバイダは、このメソッドをオーバーライドしてください。
outbuf
- 最終的な署名を格納するバッファoffset
- outbuf
に署名を格納するときのオフセットlen
- outbuf
内に署名用として割り当てられるバイト数。このデフォルト実装と SUN プロバイダの両方が部分的なダイジェストを返すとは限らない。このパラメータの値が実際の署名の長さよりも短い場合、このメソッドは SignatureException をスローする。このパラメータは、その値が実際の署名の長さより長いか等しい場合は無視されるoutbuf
に格納されたバイト数SignatureException
- エラーが発生した場合、または len
が実際の署名の長さより短い場合protected abstract boolean engineVerify(byte[] sigBytes) throws SignatureException
sigBytes
- 検証対象の署名バイトSignatureException
- エンジンが適切に初期化されていない場合、渡された署名が適切に符号化されていない場合、入力が間違っているなどの場合protected abstract void engineSetParameter(String param, Object value) throws InvalidParameterException
engineSetParameter
で置き換えます。
param
- パラメータの文字列識別子value
- パラメータ値InvalidParameterException
- param
がこの署名アルゴリズムエンジンに対して無効である場合、パラメータが設定済みで再設定できない場合、セキュリティ例外が発生したなどの場合protected void engineSetParameter(AlgorithmParameterSpec params) throws InvalidAlgorithmParameterException
params
を使ってアルゴリズムパラメータを設定できます。このようなオーバーライドでは、パラメータが無効な場合に InvalidAlgorithmParameterException がスローされます。このメソッドがオーバーライドされない場合は、このメソッドは常に UnsupportedOperationException をスローします。params
- パラメータInvalidAlgorithmParameterException
- 指定されたパラメータがこの署名エンジンに対して不適切な場合protected abstract Object engineGetParameter(String param) throws InvalidParameterException
param
- パラメータの文字列名InvalidParameterException
- param
がこのエンジンに対して無効なパラメータである場合、あるいはこのパラメータを取得しようとしている間に別の例外が発生した場合public Object clone() throws CloneNotSupportedException
Object
内の clone
CloneNotSupportedException
- Cloneable
をサポートしていない実装で呼び出された場合
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.