java.security
クラス KeyStore

java.lang.Object
  java.security.KeyStore

public class KeyStore
extends Object

このクラスは、暗号化の鍵と証明書の格納場所を表現したものです。

KeyStore は異なる型のエントリを管理します。個々のエントリ型は KeyStore.Entry インタフェースを実装します。次の 3 つの基本 KeyStore.Entry 実装が提供されています。

• KeyStore.PrivateKeyEntry

  この型のエントリには、暗号化 PrivateKey が格納されます。許可されないアクセスを防ぐために保護形式で格納できるようになっています。また、対応する公開鍵の証明連鎖もいっしょに格納されます。

  非公開鍵と証明連鎖は、指定されたエンティティによって自身の認証のために使用されます。この認証が利用されるのは、ソフトウェア配布組織がソフトウェアのリリースやライセンス供与の一貫として JAR ファイルに署名する場合などです。

• KeyStore.SecretKeyEntry

  この型のエントリには暗号化 SecretKey が格納されます。なお、許可されないアクセスを防ぐために保護形式で格納できるようになっています。

• KeyStore.TrustedCertificateEntry

  この型のエントリには別の組織に属する単一の公開鍵 Certificate が格納されます。これが「信頼できる証明書」と呼ばれる理由は、証明書に含まれている公開鍵が実際に、証明書の「被認証者」(所有者) 欄に記載されているアイデンティティのものであることを、キーストアの所有者が信用しているからです。

  この型のエントリは、ほかの組織の認証に使用できます。

キーストア内の各エントリは「別名」文字列によって識別されます。非公開鍵とそれに関連する証明連鎖の場合、これらの文字列によって、エンティティが自身を認証するさまざまな方法が区別されます。たとえば、エンティティは自身を認証する際に、異なる証明書発行局を使ったり、異なる公開鍵アルゴリズムを使ったりできます。

キーストアが持続性があるかどうか、および持続性がある場合に使われる機構は、ここでは指定されません。これにより、重要な (秘密または非公開) 鍵を保護するためのさまざまな技術を使うことができます。スマートカードまたはその他の統合暗号化エンジン (SafeKeyper) を使うことも 1 つの方法です。また、ファイルなどのより単純な機構をさまざまな形式で使うこともできます。

KeyStore オブジェクトを要求する典型的な方法としては、デフォルトの型を利用する方法と、特定のキーストア型を指定する方法があります。

• デフォルトの型を利用するには、次のようにします。

  
      KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());
   

  システムは、デフォルト型のキーストア実装を返します。

• 特定のキーストア型を指定するには、次のようにします。

  
        KeyStore ks = KeyStore.getInstance("JKS");
   

  システムは、環境内で利用可能な実装のうち、指定されたキーストア型にもっとも適したものを返します。

特定のキーストアにアクセスできるようにするには、そのキーストアをロードする必要があります。

    KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());

    // get user password and file input stream
    char[] password = getPassword();
    java.io.FileInputStream fis =
        new java.io.FileInputStream("keyStoreName");
    ks.load(fis, password);
    fis.close();
 

上記の load メソッドを使って空のキーストアを作成するには、InputStream 引数として null を渡します。

キーストアのロードが完了すると、既存のエントリをキーストアから読み取ったり、新しいエントリをキーストアに書き込んだりできます。

    // get my private key
    KeyStore.PrivateKeyEntry pkEntry = (KeyStore.PrivateKeyEntry)
        ks.getEntry("privateKeyAlias", password);
    PrivateKey myPrivateKey = pkEntry.getPrivateKey();

    // save my secret key
    javax.crypto.SecretKey mySecretKey;
    KeyStore.SecretKeyEntry skEntry =
        new KeyStore.SecretKeyEntry(mySecretKey);
    ks.setEntry("secretKeyAlias", skEntry, password);

    // store away the keystore
    java.io.FileOutputStream fos =
        new java.io.FileOutputStream("newKeyStoreName");
    ks.store(fos, password);
    fos.close();
 

なお、上記サンプルコードで示したように、キーストアのロード、非公開鍵エントリの保護、秘密鍵エントリの保護、およびキーストアの格納には同じパスワードを使用できますが、異なるパスワードやその他の保護パラメータも使用できます。

導入されたバージョン:

1.2

関連項目:

PrivateKey, SecretKey, Certificate

入れ子のクラスの概要

static class	KeyStore.Builder インスタンス化すべき KeyStore オブジェクトを記述したクラスです。
static class	KeyStore.CallbackHandlerProtection CallbackHandler をカプセル化した ProtectionParameter です。
static interface	KeyStore.Entry KeyStore エントリの種類に対するマーカーインタフェースです。
static interface	KeyStore.LoadStoreParameter KeyStore の load パラメータと store パラメータに対するマーカーインタフェースです。
static class	KeyStore.PasswordProtection ProtectionParameter のパスワードベースの実装です。
static class	KeyStore.PrivateKeyEntry 特定の PrivateKey と対応する証明連鎖が格納された KeyStore エントリです。
static interface	KeyStore.ProtectionParameter キーストアの保護パラメータに対するマーカーインタフェースです。
static class	KeyStore.SecretKeyEntry 特定の SecretKey が格納された KeyStore エントリです。
static class	KeyStore.TrustedCertificateEntry 信頼できる Certificate が格納された KeyStore エントリです。

コンストラクタの概要

protected

KeyStore(KeyStoreSpi keyStoreSpi, Provider provider, String type) 指定された型の KeyStore オブジェクトを作成し、そのオブジェクトで、指定されたプロバイダの実装である SPI オブジェクトをカプセル化します。

メソッドの概要

Enumeration<String>	aliases() このキーストアのすべての別名を一覧表示します。
boolean	containsAlias(String alias) このキーストアに、指定された別名が存在するかどうかを判定します。
void	deleteEntry(String alias) このキーストアから、指定された別名によって識別されるエントリを削除します。
boolean	entryInstanceOf(String alias, Class<? extends KeyStore.Entry> entryClass) 指定された alias のキーストア Entry が、指定された entryClass のインスタンスまたはサブクラスであるかどうかを判定します。
Certificate	getCertificate(String alias) 指定された別名に関連付けられた証明書を返します。
String	getCertificateAlias(Certificate cert) 指定された証明書と一致する証明書がある最初のキーストアエントリの別名を返します。
Certificate[]	getCertificateChain(String alias) 指定された別名に関連付けられた証明連鎖を返します。
Date	getCreationDate(String alias) 指定された別名によって識別されるエントリの作成日を返します。
static String	getDefaultType() Java セキュリティプロパティファイルに指定されているデフォルトのキーストア型を返します。
KeyStore.Entry	getEntry(String alias, KeyStore.ProtectionParameter protParam) 指定された保護パラメータを使用して、指定された別名に対するキーストア Entry を取得します。
static KeyStore	getInstance(String type) 指定された型のキーストアオブジェクトを作成します。
static KeyStore	getInstance(String type, Provider provider) 指定されたプロバイダから、指定されたキーストア型のキーストアオブジェクトを生成します。
static KeyStore	getInstance(String type, String provider) 指定されたプロバイダから、指定されたキーストア型のキーストアオブジェクトを作成します。
Key	getKey(String alias, char[] password) 指定されたパスワードを使用して、指定された別名に関連付けられた鍵を復元し、その鍵を返します。
Provider	getProvider() このキーストアのプロバイダを返します。
String	getType() このキーストアの型を返します。
boolean	isCertificateEntry(String alias) 指定された別名で識別されるエントリが、setCertificateEntry を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、true を返します。
boolean	isKeyEntry(String alias) 指定された別名で識別されるエントリが、setKeyEntry を呼び出して作成されたエントリ、あるいは PrivateKeyEntry または SecretKeyEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、true を返します。
void	load(InputStream stream, char[] password) 指定された入力ストリームからこのキーストアをロードします。
void	load(KeyStore.LoadStoreParameter param) 指定された LoadStoreParameter を使用してこのキーストアをロードします。
void	setCertificateEntry(String alias, Certificate cert) 指定された別名に、指定された信頼できる証明書を割り当てます。
void	setEntry(String alias, KeyStore.Entry entry, KeyStore.ProtectionParameter protParam) キーストア Entry を指定された別名で保存します。
void	setKeyEntry(String alias, byte[] key, Certificate[] chain) 指定された別名に、すでに保護されている指定の鍵を割り当てます。
void	setKeyEntry(String alias, Key key, char[] password, Certificate[] chain) 指定された別名に指定された鍵を割り当て、指定されたパスワードでその鍵を保護します。
int	size() このキーストアのエントリ数を取得します。
void	store(KeyStore.LoadStoreParameter param) 指定された LoadStoreParameter を使用してこのキーストアを格納します。
void	store(OutputStream stream, char[] password) 指定された出力ストリームにこのキーストアを格納し、指定されたパスワードでその整合性を保護します。

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

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

コンストラクタの詳細

KeyStore

protected KeyStore(KeyStoreSpi keyStoreSpi,
                   Provider provider,
                   String type)

指定された型の KeyStore オブジェクトを作成し、そのオブジェクトで、指定されたプロバイダの実装である SPI オブジェクトをカプセル化します。

パラメータ:

keyStoreSpi - プロバイダの実装

provider - プロバイダ

type - キーストア型

メソッドの詳細

getInstance

public static KeyStore getInstance(String type)
                            throws KeyStoreException

指定された型のキーストアオブジェクトを作成します。

指定された型のキーストアの実装をデフォルトのプロバイダパッケージが提供する場合は、その実装を含む KeyStore のインスタンスが返されます。デフォルトパッケージに要求されるキーストア型がない場合は、ほかのパッケージを検索します。

パラメータ:

type - キーストア型。標準のキーストア型については、「Java 暗号化アーキテクチャ API 仕様 & リファレンス」の付録 A を参照

戻り値:

指定された型のキーストアオブジェクト

例外:

KeyStoreException - 要求されるキーストア型が、デフォルトのプロバイダパッケージにも、検索したほかのプロバイダパッケージにもない場合

getInstance

public static KeyStore getInstance(String type,
                                   String provider)
                            throws KeyStoreException,
                                   NoSuchProviderException

指定されたプロバイダから、指定されたキーストア型のキーストアオブジェクトを作成します。

パラメータ:

type - キーストア型。標準のキーストア型については、「Java 暗号化アーキテクチャ API 仕様 & リファレンス」の付録 A を参照

provider - プロバイダ名

戻り値:

指定されたプロバイダが提供する、指定された型のキーストアオブジェクト

例外:

KeyStoreException - プロバイダに、要求されたキーストア型がない場合

NoSuchProviderException - プロバイダが設定されていない場合

IllegalArgumentException - プロバイダの名前が null か空の場合

関連項目:

Provider

getInstance

public static KeyStore getInstance(String type,
                                   Provider provider)
                            throws KeyStoreException

指定されたプロバイダから、指定されたキーストア型のキーストアオブジェクトを生成します。注: provider は登録されている必要はありません。

パラメータ:

type - キーストア型。標準のキーストア型については、「Java 暗号化アーキテクチャ API 仕様 & リファレンス」の付録 A を参照

provider - プロバイダ

戻り値:

指定されたプロバイダが提供する、指定された型のキーストアオブジェクト

例外:

KeyStoreException - プロバイダに、要求されたキーストア型がない場合

IllegalArgumentException - provider が null の場合

導入されたバージョン:

1.4

関連項目:

Provider

getDefaultType

public static final String getDefaultType()

Java セキュリティプロパティファイルに指定されているデフォルトのキーストア型を返します。ただし、そのようなプロパティが存在しない場合は「jks」(Java keystore の略語) という文字列を返します。Java セキュリティプロパティは、<JAVA_HOME>/lib/security/java.security というファイル内に格納されています。ここで、<JAVA_HOME> は、JDK のインストール先ディレクトリです。

デフォルトのキーストア型を使用するのは、アプリケーションで getInstance メソッドを呼び出すときに、ハードコードされたキーストア型を使用しない場合、およびユーザが独自のキーストア型を指定しないときに、デフォルトのキーストア型を提供する場合です。

デフォルトのキーストア型を変更するには、Java セキュリティプロパティファイルの keystore.type セキュリティプロパティの値を目的のキーストア型に設定します。

戻り値:

Java セキュリティプロパティファイルで指定されたデフォルトのキーストア型。プロパティが存在しない場合は、「jks」の文字列

getProvider

public final Provider getProvider()

このキーストアのプロバイダを返します。

戻り値:

このキーストアのプロバイダ

getType

public final String getType()

このキーストアの型を返します。

戻り値:

このキーストアの型

getKey

public final Key getKey(String alias,
                        char[] password)
                 throws KeyStoreException,
                        NoSuchAlgorithmException,
                        UnrecoverableKeyException

指定されたパスワードを使用して、指定された別名に関連付けられた鍵を復元し、その鍵を返します。この鍵は、setKeyEntry を呼び出すか、あるいは PrivateKeyEntry または SecretKeyEntry を指定して setEntry を呼び出すことでその別名に関連付けられている必要があります。

パラメータ:

alias - 別名

password - 鍵を復元するためのパスワード

戻り値:

要求される鍵。指定された別名が存在しないか、鍵関連エントリを識別しない場合は null

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

NoSuchAlgorithmException - 鍵を復元するためのアルゴリズムが見つからない場合

UnrecoverableKeyException - 指定されたパスワードが間違っている場合など、鍵を復元できない場合

getCertificateChain

public final Certificate[] getCertificateChain(String alias)
                                        throws KeyStoreException

指定された別名に関連付けられた証明連鎖を返します。この証明連鎖は、setKeyEntry を呼び出すか、あるいは PrivateKeyEntry を指定して setEntry を呼び出すことで別名に関連付けられている必要があります。

パラメータ:

alias - 別名

戻り値:

証明連鎖。順番は、ユーザ証明書が最初でルート証明書発行局が最後。指定された別名が存在しないか、証明連鎖を含んでいない場合は null

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

getCertificate

public final Certificate getCertificate(String alias)
                                 throws KeyStoreException

指定された別名に関連付けられた証明書を返します。

指定された別名によって識別されるエントリが、setCertificateEntry を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、そのエントリ内に格納されている信頼できる証明書が返されます。

指定された別名によって識別されるエントリが、setKeyEntry を呼び出して作成されたエントリ、あるいは PrivateKeyEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、そのエントリ内の証明連鎖の最初の要素が返されます。

パラメータ:

alias - 別名

戻り値:

証明書。指定された別名が存在しないか、または証明書を含まない場合は null

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

getCreationDate

public final Date getCreationDate(String alias)
                           throws KeyStoreException

指定された別名によって識別されるエントリの作成日を返します。

パラメータ:

alias - 別名

戻り値:

このエントリの作成日。指定された別名が存在しない場合は null

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

setKeyEntry

public final void setKeyEntry(String alias,
                              Key key,
                              char[] password,
                              Certificate[] chain)
                       throws KeyStoreException

指定された別名に指定された鍵を割り当て、指定されたパスワードでその鍵を保護します。

指定された鍵が java.security.PrivateKey 型である場合、対応する公開鍵を証明する証明連鎖も指定する必要があります。

指定された別名がすでに存在する場合は、それに関連したキーストア情報は、指定された鍵と証明連鎖によってオーバーライドされます。

パラメータ:

alias - 別名

key - 別名に関連付ける鍵

password - 鍵を保護するためのパスワード

chain - 対応する公開鍵の証明連鎖。指定された鍵が java.security.PrivateKey 型である場合にだけ必要

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合、指定された鍵を保護できない場合、あるいはこの処理がほかの原因で失敗した場合

setKeyEntry

public final void setKeyEntry(String alias,
                              byte[] key,
                              Certificate[] chain)
                       throws KeyStoreException

指定された別名に、すでに保護されている指定の鍵を割り当てます。

保護された鍵が java.security.PrivateKey 型である場合、対応する公開鍵を証明する証明連鎖も指定する必要があります。基本となるキーストアの実装の型が jks の場合、key は PKCS #8 標準の定義に従って EncryptedPrivateKeyInfo として符号化されている必要があります。

指定された別名がすでに存在する場合は、それに関連したキーストア情報は、指定された鍵と証明連鎖によってオーバーライドされます。

パラメータ:

alias - 別名

key - 別名に関連付ける保護形式の鍵

chain - 保護された鍵が java.security.PrivateKey 型である場合にだけ有効な対応する公開鍵の証明連鎖

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合、またはこの処理がほかの原因で失敗した場合

setCertificateEntry

public final void setCertificateEntry(String alias,
                                      Certificate cert)
                               throws KeyStoreException

指定された別名に、指定された信頼できる証明書を割り当てます。

指定された別名によって識別されるエントリが、setCertificateEntry を呼び出して作成された既存エントリ、あるいは TrustedCertificateEntry を指定して setEntry を呼び出して作成された既存エントリのいずれかである場合、その既存エントリ内に格納されている信頼できる証明書が、指定された証明書で上書きされます。

パラメータ:

alias - 別名

cert - 証明書

例外:

KeyStoreException - キーストアが初期化されていない場合、指定された別名がすでに存在していてもそれによって識別されるエントリが信頼できる証明書を含んでいない場合、あるいはこの処理がほかの原因で失敗した場合

deleteEntry

public final void deleteEntry(String alias)
                       throws KeyStoreException

このキーストアから、指定された別名によって識別されるエントリを削除します。

パラメータ:

alias - 別名

例外:

KeyStoreException - キーストアが初期化されていない場合、あるいはエントリを削除できない場合

aliases

public final Enumeration<String> aliases()
                                  throws KeyStoreException

このキーストアのすべての別名を一覧表示します。

戻り値:

別名の列挙

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

containsAlias

public final boolean containsAlias(String alias)
                            throws KeyStoreException

このキーストアに、指定された別名が存在するかどうかを判定します。

パラメータ:

alias - 別名

戻り値:

別名が存在する場合は true、そうでない場合は false

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

size

public final int size()
               throws KeyStoreException

このキーストアのエントリ数を取得します。

戻り値:

このキーストアのエントリ数

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

isKeyEntry

public final boolean isKeyEntry(String alias)
                         throws KeyStoreException

指定された別名で識別されるエントリが、setKeyEntry を呼び出して作成されたエントリ、あるいは PrivateKeyEntry または SecretKeyEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、true を返します。

パラメータ:

alias - 判定対象となるキーストアエントリの別名

戻り値:

指定された別名で識別されるエントリが鍵関連エントリである場合は true、そうでない場合は false

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

isCertificateEntry

public final boolean isCertificateEntry(String alias)
                                 throws KeyStoreException

指定された別名で識別されるエントリが、setCertificateEntry を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、true を返します。

パラメータ:

alias - 判定対象となるキーストアエントリの別名

戻り値:

指定された別名で識別されるエントリに信頼できる証明書エントリが含まれている場合は true、そうでない場合は false

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

getCertificateAlias

public final String getCertificateAlias(Certificate cert)
                                 throws KeyStoreException

指定された証明書と一致する証明書がある最初のキーストアエントリの別名を返します。

このメソッドは、指定された証明書を各キーストアエントリと照合します。処理対象のエントリが、setCertificateEntry を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry を指定して setEntry を呼び出して作成されたエントリである場合、指定された証明書はそのエントリの証明書と比較されます。

処理対象のエントリが、setKeyEntry を呼び出して作成されたエントリ、あるいはPrivateKeyEntry を指定して setEntry を呼び出して作成されたエントリである場合、指定された証明書はそのエントリの証明連鎖の最初の要素と比較されます。

パラメータ:

cert - 照合する証明書

戻り値:

一致する証明書を含む最初のエントリの別名。そのようなエントリがこのキーストアに存在しない場合は null

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

store

public final void store(OutputStream stream,
                        char[] password)
                 throws KeyStoreException,
                        IOException,
                        NoSuchAlgorithmException,
                        CertificateException

指定された出力ストリームにこのキーストアを格納し、指定されたパスワードでその整合性を保護します。

パラメータ:

stream - このキーストアを書き込む出力ストリーム

password - キーストアの整合性を検査するためのパスワード

例外:

KeyStoreException - キーストアが初期化 (ロード) されていない場合

IOException - データに入出力の問題があった場合

NoSuchAlgorithmException - 適切なデータ整合性アルゴリズムが見つからなかった場合

CertificateException - キーストアデータに含まれるどの証明書も格納できなかった場合

store

public final void store(KeyStore.LoadStoreParameter param)
                 throws KeyStoreException,
                        IOException,
                        NoSuchAlgorithmException,
                        CertificateException

指定された LoadStoreParameter を使用してこのキーストアを格納します。

パラメータ:

param - キーストアの格納方法を指定した LoadStoreParameter。 null も指定可能

例外:

IllegalArgumentException - 指定された LoadStoreParameter 入力が認識されない場合

KeyStoreException - キーストアが初期化 (ロード) されていない場合

IOException - データに入出力の問題があった場合

NoSuchAlgorithmException - 適切なデータ整合性アルゴリズムが見つからなかった場合

CertificateException - キーストアデータに含まれるどの証明書も格納できなかった場合

導入されたバージョン:

1.5

load

public final void load(InputStream stream,
                       char[] password)
                throws IOException,
                       NoSuchAlgorithmException,
                       CertificateException

指定された入力ストリームからこのキーストアをロードします。

パスワードを指定すると、キーストアがハードウェアトークンデバイス上に存在する場合などに、キーストアのロック解除やキーストアデータの完全性検査ができます。完全性検査用のパスワードが指定されなかった場合、完全性検査は実行されません。

空のキーストアを作成する場合、あるいはキーストアをストリームから初期化できない場合は、stream 引数として null を渡します。

このキーストアがすでにロードされている場合、このキーストアは再び初期化され、指定されたストリームからロードし直されます。

パラメータ:

stream - キーストアのロード元の入力ストリームまたは null

password - キーストアの完全性検査用パスワード、キーストアのロック解除用パスワード、または null

例外:

IOException - キーストアデータで入出力または形式に関する問題が発生した場合、パスワードが必要であるのに指定されなかった場合、あるいは指定されたパスワードが間違っている場合

NoSuchAlgorithmException - キーストアの整合性を検査するアルゴリズムが見つからなかった場合

CertificateException - キーストアのどの証明書もロードできなかった場合

load

public final void load(KeyStore.LoadStoreParameter param)
                throws IOException,
                       NoSuchAlgorithmException,
                       CertificateException

指定された LoadStoreParameter を使用してこのキーストアをロードします。

このキーストアがすでにロードされている場合、このキーストアは再び初期化され、指定されたストリームからロードし直されます。

パラメータ:

param - キーストアのロード方法を指定した LoadStoreParameter。 null も指定可能

例外:

IllegalArgumentException - 指定された LoadStoreParameter 入力が認識されない場合

IOException - キーストアデータに入出力または形式の問題があった場合

NoSuchAlgorithmException - キーストアの整合性を検査するアルゴリズムが見つからなかった場合

CertificateException - キーストアのどの証明書もロードできなかった場合

導入されたバージョン:

1.5

getEntry

public final KeyStore.Entry getEntry(String alias,
                                     KeyStore.ProtectionParameter protParam)
                              throws NoSuchAlgorithmException,
                                     UnrecoverableEntryException,
                                     KeyStoreException

指定された保護パラメータを使用して、指定された別名に対するキーストア Entry を取得します。

パラメータ:

alias - この別名に対するキーストア Entry を取得

protParam - Entry の保護に使用される ProtectionParameter。null も指定可能

戻り値:

指定された別名に対するキーストア Entry。そのようなエントリが存在しない場合は null

例外:

NullPointerException - alias が null の場合

NoSuchAlgorithmException - エントリを復元するためのアルゴリズムが見つからない場合

UnrecoverableEntryException - 指定された protParam が不十分または無効である場合

KeyStoreException - キーストアが初期化 (ロード) されていない場合

導入されたバージョン:

1.5

関連項目:

setEntry(String, KeyStore.Entry, KeyStore.ProtectionParameter)

setEntry

public final void setEntry(String alias,
                           KeyStore.Entry entry,
                           KeyStore.ProtectionParameter protParam)
                    throws KeyStoreException

キーストア Entry を指定された別名で保存します。保護パラメータは、Entry を保護するために使用されます。

指定された別名のエントリがすでに存在する場合、そのエントリは上書きされます。

パラメータ:

alias - この別名でキーストア Entry を保存

entry - 保存する Entry

protParam - Entry の保護に使用される ProtectionParameter。null も指定可能

例外:

NullPointerException - alias または entry が null の場合

KeyStoreException - キーストアが初期化 (ロード) されていない場合、あるいはこの処理がほかの原因で失敗した場合

導入されたバージョン:

1.5

関連項目:

getEntry(String, KeyStore.ProtectionParameter)

entryInstanceOf

public final boolean entryInstanceOf(String alias,
                                     Class<? extends KeyStore.Entry> entryClass)
                              throws KeyStoreException

指定された alias のキーストア Entry が、指定された entryClass のインスタンスまたはサブクラスであるかどうかを判定します。

パラメータ:

alias - 別名

entryClass - エントリクラス

戻り値:

指定された alias のキーストア Entry が、指定された entryClass のインスタンスまたはサブクラスである場合は true、そうでない場合は false

例外:

NullPointerException - alias または entryClass が null の場合

KeyStoreException - キーストアが初期化 (ロード) されていない場合

導入されたバージョン:

1.5