com.nttdocomo.security.PKCS7SignedData
Object
PKCS#7 SignedData
フォーマットに準拠したデジタル署名付きデータを定義します。
このクラスはデジタル署名付きデータそのものを表しますが、
デジタル署名付きデータの生成は PKCS7Signer
クラスで行います。
本クラスのコンストラクタや PKCS7Signer.sign()
メソッドを呼び出すことにより、
PKCS7SignedData オブジェクトが生成されます。
生成された PKCS7SignedData オブジェクトから
get 系メソッドを呼び出すことによって、
デジタル署名付きデータに含まれる情報やデータを取得することができます。
また、verify() メソッドを呼び出すことにより、
デジタル署名付きデータの検証を行うことが出来ます。
PKCS7Signer,
X509Certificate| コンストラクタの概要 | |
PKCS7SignedData(byte[] data)
指定されたバイナリデータから PKCS7SignedData オブジェクトを生成します。 |
|
| メソッドの概要 | |
X509Certificate[] |
getCertificates()
デジタル署名付きデータに含まれている全ての証明書を取得します。 |
byte[] |
getContent()
デジタル署名付きデータに含まれているコンテント(inner content)を、 バイナリデータとして取得します。 |
byte[] |
getEncoded()
デジタル署名付きデータをバイナリデータとして返します。 |
boolean |
verify()
デジタル署名付きデータの検証を行います。 |
| クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| コンストラクタの詳細 |
public PKCS7SignedData(byte[] data)
指定できるバイナリデータは、 PKCS#7 SignedData フォーマットに準拠し、 DER に従ってエンコードされた ASN.1 形式の バイナリデータです。 それ以外のバイナリデータが指定された場合、 不正なフォーマットのデータが指定されたとして例外が発生します。
data - デジタル署名付きデータのバイナリデータを指定します。
NullPointerException - 引数 data が null の場合に発生します。
IllegalArgumentException - 引数 data に指定されたデータのフォーマットが不正の場合に発生します。
IllegalStateException - UIM の情報を取得できなかった場合に発生します。
UnsupportedOperationException - 端末に挿入されている UIM のバージョンが Version2
以降ではない場合に発生します。
| メソッドの詳細 |
public byte[] getEncoded()
public byte[] getContent()
コンテントとは、PKCS#7 フォーマットの要素 content に指定されているデータのことです。
public X509Certificate[] getCertificates()
public boolean verify()
throws SignatureException,
CertificateException
検証に成功した場合は true が返されますが、 検証に失敗した場合は false を返さず、 失敗理由に従って例外が発生します。
IllegalStateException -
UIM 読み込み中の場合に発生します。
CertificateException -
検証対象の署名に対応する Root
証明書を端末が保持していなかった、または、
その証明書が有効期限切れなどで失効していた場合に発生します
(UNTRUSTED_CA)。
SignatureException - 検証結果を得られなかった場合、
または、検証の結果が失敗だった場合に発生します (UNDEFINED)。