com.docomostar.system
クラス CertificateStore

Object
  com.docomostar.system.CertificateStore

public final class CertificateStore
extends Object

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

携帯電話のネイティブの証明書機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブのユーザ証明書データ(ユーザ証明書とそれに対応する秘密鍵)の 1 つのエントリを表しますが、 インスタンスを取得する手段はありません。

このクラスに定義されているエントリ ID のみ取得機能 (selectEntryId())の使い方や、 ネイティブのデータへのアクセス方法に関する規定の大原則は com.docomostar.system パッケージの記述を参照して下さい。

なお、このクラスでは、 エントリ取得機能 (selectEntry、getEntry) とエントリ登録機能 (addEntry) は提供されません。 また、エントリ ID のみ取得機能 (selectEntryId()) についても下記の点が大原則と異なります。

selectEntryIdについて:

UIM 内のユーザ証明書データのエントリ ID については、 常に CERTIFICATE_UIM_ID となります。

導入されたバージョン:

Star-1.0

フィールドの概要

static int

CERTIFICATE_UIM_ID UIM 内のユーザ証明書データのエントリ ID を表します(=0)。

メソッドの概要

static int

selectEntryId() ユーザ操作によりユーザ証明書データのエントリ ID を取得します。

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

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

フィールドの詳細

CERTIFICATE_UIM_ID

public static final int CERTIFICATE_UIM_ID

UIM 内のユーザ証明書データのエントリ ID を表します(=0)。

関連項目:

定数フィールド値

メソッドの詳細

selectEntryId

public static int selectEntryId()
                         throws InterruptedOperationException,
                                StoreException

ユーザ操作によりユーザ証明書データのエントリ ID を取得します。

エントリ ID の取得は、ユーザ証明書の有効期限切れや、無効化設定の有無に関わらず可能です。 取得したエントリ ID は、 PKCS7Signer.sign(int) の引数として指定します。

端末によっては、 Star アプリから端末メモリ内の証明書を利用する機能をサポートしていない場合があります。 その場合には、例外 UnsupportedOperationException が発生します。

戻り値:

取得したユーザ証明書データのエントリ ID を返します。 ユーザが選択操作をキャンセルすると -1 を返します。 また、選択可能なエントリが存在しない場合にも -1 を返します。

例外:

UnsupportedOperationException -
端末が Star アプリから端末メモリ内の証明書を利用する機能をサポートしていない場合に発生します。

IllegalStateException -
UIM の情報を取得できなかった場合に発生します。

UnsupportedOperationException -
端末に挿入されている UIM のバージョンが Version2 以降ではない場合に発生します。

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により、 ユーザ証明書データのエントリIDを取得できない場合に発生します。

InterruptedOperationException -
競合条件などにより、選択操作が異常終了した場合に発生します。

IllegalStateException -
UIM 読み込み中の場合に発生します。

StoreException -
(UNDEFINED)
ユーザ証明書データのエントリ ID が取得できない場合に発生します。