KeyStore (Java Platform SE 7)

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 が格納されます。これは信頼できる証明書と呼ばれますが、それは、キーストアの所有者が、証明書内の公開鍵が実際に証明書のサブジェクト (所有者) によって識別されたアイデンティティーに属することを信頼するためです。
  この種類のエントリは、ほかの組織の認証に使うことができます。
キーストア内の各エントリは、「別名」文字列によって識別されます。非公開鍵とそれに関連付けられた証明書チェーンの場合は、これらの文字列は、エンティティー自体が認証するというように、方法別に区別されます。たとえば、エンティティーが異なる証明書発行局を使ったり、異なる公開鍵アルゴリズムを使ったりして、エンティティー自体を認証することも可能です。
別名の大文字と小文字が区別されるかどうかは、実装によって異なります。問題の発生を防ぐため、KeyStore 内では、大文字と小文字の区別が異なるだけの別名を使用しないようにしてください。
キーストアが持続性があるかどうか、および持続性がある場合に使われるメカニズムは、ここでは指定されません。これにより、重要な (秘密または非公開) 鍵を保護するためのさまざまな技術を使うことができます。スマートカードまたはその他の統合暗号化エンジン (SafeKeyper) を使うことも 1 つの方法です。また、ファイルなどのより単純なメカニズムをさまざまな形式で使うこともできます。
KeyStore オブジェクトを要求する典型的な方法としては、デフォルトのタイプを利用する方法と、特定のキーストアタイプを指定する方法があります。
- デフォルトのタイプを利用するには、次のようにします。
```
    KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());
 
```
  システムは、デフォルトタイプのキーストア実装を返します。
- 特定のキーストアタイプを指定するには、次のようにします。
```
      KeyStore ks = KeyStore.getInstance("JKS");
 
```
  システムは、環境内で利用可能な実装のうち、指定されたキーストアタイプにもっとも適したものを返します。
キーストアにアクセスできるようにするには、ロード (loaded) する必要があります。
```
    KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());

    // get user password and file input stream
    char[] password = getPassword();

    java.io.FileInputStream fis = null;
    try {
        fis = new java.io.FileInputStream("keyStoreName");
        ks.load(fis, password);
    } finally {
        if (fis != null) {
            fis.close();
        }
    }
 
```
上記の load メソッドを使って空のキーストアを作成するには、InputStream 引数として null を渡します。
キーストアのロードが完了すると、既存のエントリをキーストアから読み取ったり、新しいエントリをキーストアに書き込んだりできます。
```
    KeyStore.ProtectionParameter protParam =
        new KeyStore.PasswordProtection(password);

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

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

    // store away the keystore
    java.io.FileOutputStream fos = null;
    try {
        fos = new java.io.FileOutputStream("newKeyStoreName");
        ks.store(fos, password);
    } finally {
        if (fos != null) {
            fos.close();
        }
    }
 
```
なお、上記サンプルコードで示したように、キーストアのロード、非公開鍵エントリの保護、秘密鍵エントリの保護、およびキーストアの格納には同じパスワードを使用できますが、異なるパスワードやその他の保護パラメータも使用できます。
Java プラットフォームの実装は、すべて次の標準の KeyStore タイプをサポートする必要があります。
- PKCS12
このタイプについては、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの KeyStore のセクションで説明されています。サポートされているその他のタイプについては、実装のリリースノートを参照してください。
導入されたバージョン:

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 セキュリティープロパティーファイルに指定されているデフォルトのキーストアタイプを返します。ただし、そのようなプロパティーが存在しない場合は「jks」(「Java keystore」の略語) という文字列を返します。
`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
```
    指定されたタイプのキーストアオブジェクトを返します。
    このメソッドは、最優先の Provider から順に、登録済みのセキュリティー Provider のリストをトラバースします。指定されたタイプをサポートする最初の Provider の KeyStoreSpi 実装をカプセル化する新しい KeyStore オブジェクトが返されます。
    登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。
    
    パラメータ:
    type - キーストアのタイプ。標準のキーストアタイプについては、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの KeyStore のセクションを参照。
    
    戻り値:
    指定されたタイプのキーストアオブジェクト。
    
    例外:
    
    KeyStoreException - 指定されたタイプの KeyStoreSpi 実装をサポートする Provider が存在しない場合。
    関連項目:
    Provider
  - getInstance
```
public static KeyStore getInstance(String type,
                   String provider)
                            throws KeyStoreException,
                                   NoSuchProviderException
```
    指定されたタイプのキーストアオブジェクトを返します。
    指定されたプロバイダの KeyStoreSpi 実装をカプセル化する新しい KeyStore オブジェクトが返されます。指定したプロバイダは、セキュリティープロバイダリストに登録する必要があります。
    登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。
    
    パラメータ:
    type - キーストアのタイプ。標準のキーストアタイプについては、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの KeyStore のセクションを参照。
    provider - プロバイダ名。
    
    戻り値:
    指定されたタイプのキーストアオブジェクト。
    
    例外:
    
    KeyStoreException - 指定されたプロバイダに指定されたタイプの KeyStoreSpi 実装がない場合。
    
    NoSuchProviderException - 指定されたプロバイダがセキュリティープロバイダリストに登録されていない場合。
    
    IllegalArgumentException - プロバイダ名が null または空の場合。
    関連項目:
    Provider
  - getInstance
```
public static KeyStore getInstance(String type,
                   Provider provider)
                            throws KeyStoreException
```
    指定されたタイプのキーストアオブジェクトを返します。
    指定された Provider オブジェクトの KeyStoreSpi 実装をカプセル化する新しい KeyStore オブジェクトが返されます。指定された Provider オブジェクトは、プロバイダリストに登録する必要はありません。
    
    パラメータ:
    type - キーストアのタイプ。標準のキーストアタイプについては、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの KeyStore のセクションを参照。
    provider - プロバイダ。
    
    戻り値:
    指定されたタイプのキーストアオブジェクト。
    
    例外:
    
    KeyStoreException - 指定された Provider オブジェクトに指定されたタイプの KeyStoreSpi 実装がない場合。
    
    IllegalArgumentException - 指定されたプロバイダが null の場合。
    導入されたバージョン:
    
    1.4
    
    関連項目:
    Provider
  - getDefaultType
```
public static final String getDefaultType()
```
    Java セキュリティープロパティーファイルに指定されているデフォルトのキーストアタイプを返します。ただし、そのようなプロパティーが存在しない場合は「jks」(「Java keystore」の略語) という文字列を返します。Java セキュリティープロパティーファイルは、<JAVA_HOME>/lib/security/java.security という名前のファイルに格納されています。<JAVA_HOME> は java.home システムプロパティーの値を参照しており、JRE のインストールディレクトリを示します。
    デフォルトのキーストアタイプを使用するのは、アプリケーションで 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 - 別名
    
    戻り値:
    証明書チェーン。順番は、ユーザー証明書が最初で、0 個以上の証明書発行局が続きます。指定された別名が存在しないか、証明書チェーンを含んでいない場合は 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
  - ロード
```
public final void load(InputStream stream,
        char[] password)
                throws IOException,
                       NoSuchAlgorithmException,
                       CertificateException
```
    指定された入力ストリームからこのキーストアをロードします。
    パスワードを指定すると、キーストアがハードウェアトークンデバイス上に存在する場合などに、キーストアのロック解除やキーストアデータの整合性検査ができます。整合性検査用のパスワードが指定されなかった場合、整合性検査は実行されません。
    空のキーストアを作成する場合、あるいはキーストアをストリームから初期化できない場合は、stream 引数として null を渡します。
    このキーストアがすでにロードされている場合、このキーストアは再び初期化され、指定されたストリームからロードし直されます。
    
    パラメータ:
    stream - キーストアのロード元の入力ストリームまたはnull
    password - キーストアの整合性検査用パスワード、キーストアのロック解除用パスワード、または null
    
    例外:
    
    IOException - キーストアデータで入出力または形式に関する問題が発生した場合、パスワードが必要であるのに指定されなかった場合、または指定されたパスワードが間違っている場合。パスワードが正しくなかったためにエラーが発生した場合、IOException の cause は UnrecoverableKeyException
    
    NoSuchAlgorithmException - キーストアの整合性を検査するアルゴリズムが見つからなかった場合
    
    CertificateException - キーストアのどの証明書もロードできなかった場合
  - ロード
```
public final void load(KeyStore.LoadStoreParameter param)
                throws IOException,
                       NoSuchAlgorithmException,
                       CertificateException
```
    指定された LoadStoreParameter を使用してこのキーストアをロードします。
    このキーストアがすでにロードされている場合、このキーストアは再び初期化され、指定されたストリームからロードし直されます。
    
    パラメータ:
    param - キーストアのロード方法を指定した LoadStoreParameter。null も指定可能
    
    例外:
    
    IllegalArgumentException - 指定された LoadStoreParameter 入力が認識されない場合
    
    IOException - キーストアデータに入出力または形式の問題があった場合。ProtectionParameter が正しくなかった (たとえばパスワードが正しくなかった) ためにエラーが発生した場合、IOException の cause は UnrecoverableKeyException
    
    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 が不十分または無効である場合
    
    UnrecoverableKeyException - エントリが PrivateKeyEntry または SecretKeyEntry で、指定された 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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス KeyStore

ネストされたクラスのサマリー

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

KeyStore

メソッドの詳細

getInstance

getInstance

getInstance

getDefaultType

getProvider

getType

getKey

getCertificateChain

getCertificate

getCreationDate

setKeyEntry

setKeyEntry

setCertificateEntry

deleteEntry

aliases

containsAlias

size

isKeyEntry

isCertificateEntry

getCertificateAlias

store

store

ロード

ロード

getEntry

setEntry

entryInstanceOf