com.nttdocomo.system.CertificateStore
Object
携帯電話のネイティブの証明書機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブのユーザ証明書データ(ユーザ証明書とそれに対応する秘密鍵)の 1 つのエントリを表しますが、 インスタンスを取得する手段はありません。
このクラスに定義されているエントリ ID のみ取得機能 (selectEntryId())の使い方や、
ネイティブのデータへのアクセス方法に関する規定の大原則は
com.nttdocomo.system パッケージの記述を参照して下さい。
なお、このクラスでは、
エントリ取得機能 (selectEntry、getEntry)
とエントリ登録機能 (addEntry) は提供されません。
また、エントリ ID のみ取得機能 (selectEntryId()) についても下記の点が大原則と異なります。
selectEntryIdについて:CERTIFICATE_UIM_ID となります。
| フィールドの概要 | |
static int |
CERTIFICATE_UIM_ID
UIM 内のユーザ証明書データのエントリ ID を表します(=0)。 |
| メソッドの概要 | |
static int |
selectEntryId()
ユーザ操作によりユーザ証明書データのエントリ ID を取得します。 |
| クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| フィールドの詳細 |
public static final int CERTIFICATE_UIM_ID
| メソッドの詳細 |
public static int selectEntryId()
throws InterruptedOperationException,
StoreException
エントリ ID の取得は、ユーザ証明書の有効期限切れや、無効化設定の有無に関わらず可能です。
取得したエントリ ID は、 PKCS7Signer.sign(int) の引数として指定します。
端末によっては、 i アプリから端末メモリ内の証明書を利用する機能をサポートしていない場合があります。 その場合には、例外 UnsupportedOperationException が発生します。
UnsupportedOperationException - 端末が i アプリから端末メモリ内の証明書を利用する機能をサポートしていない場合に発生します。
IllegalStateException - UIM の情報を取得できなかった場合に発生します。
UnsupportedOperationException - 端末に挿入されている UIM のバージョンが Version2
以降ではない場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、
ユーザ証明書データのエントリIDを取得できない場合に発生します。
InterruptedOperationException - 競合条件などにより、選択操作が異常終了した場合に発生します。
IllegalStateException - UIM 読み込み中の場合に発生します。
StoreException - ユーザ証明書データのエントリ ID が取得できない場合に発生します(UNDEFINED)。