|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjava.security.KeyStoreSpi
public abstract class KeyStoreSpi
このクラスは、KeyStore
クラスの Service Provider Interface (SPI) を定義します。特定のキーストア型のキーストアの実装を提供する各暗号サービスプロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。
KeyStore
コンストラクタの概要 | |
---|---|
KeyStoreSpi()
|
メソッドの概要 | |
---|---|
abstract Enumeration<String> |
engineAliases()
このキーストアのすべての別名を一覧表示します。 |
abstract boolean |
engineContainsAlias(String alias)
このキーストアに、指定された別名が存在するかどうかを判定します。 |
abstract void |
engineDeleteEntry(String alias)
このキーストアから、指定された別名によって識別されるエントリを削除します。 |
boolean |
engineEntryInstanceOf(String alias,
Class<? extends KeyStore.Entry> entryClass)
指定された alias のキーストア Entry が、指定された entryClass のインスタンスまたはサブクラスであるかどうかを判定します。 |
abstract Certificate |
engineGetCertificate(String alias)
指定された別名に関連付けられた証明書を返します。 |
abstract String |
engineGetCertificateAlias(Certificate cert)
指定された証明書と一致する証明書がある最初のキーストアエントリの別名を返します。 |
abstract Certificate[] |
engineGetCertificateChain(String alias)
指定された別名に関連付けられた証明連鎖を返します。 |
abstract Date |
engineGetCreationDate(String alias)
指定された別名によって識別されるエントリの作成日を返します。 |
KeyStore.Entry |
engineGetEntry(String alias,
KeyStore.ProtectionParameter protParam)
指定された保護パラメータを使用して、指定された別名に対する KeyStore.Entry を取得します。 |
abstract Key |
engineGetKey(String alias,
char[] password)
指定されたパスワードを使用して、指定された別名に関連付けられた鍵を復元し、その鍵を返します。 |
abstract boolean |
engineIsCertificateEntry(String alias)
指定された別名で識別されるエントリが、 setCertificateEntry を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、true を返します。 |
abstract boolean |
engineIsKeyEntry(String alias)
指定された別名で識別されるエントリが、 setKeyEntry を呼び出して作成されたエントリ、あるいは PrivateKeyEntry または SecretKeyEntry を指定して setEntry を呼び出して作成されたエントリのいずれかである場合、true を返します。 |
abstract void |
engineLoad(InputStream stream,
char[] password)
指定された入力ストリームからキーストアをロードします。 |
void |
engineLoad(KeyStore.LoadStoreParameter param)
指定された KeyStore.LoadStoreParameter を使用してキーストアをロードします。 |
abstract void |
engineSetCertificateEntry(String alias,
Certificate cert)
指定された別名に、指定された証明書を割り当てます。 |
void |
engineSetEntry(String alias,
KeyStore.Entry entry,
KeyStore.ProtectionParameter protParam)
KeyStore.Entry を指定された別名で保存します。 |
abstract void |
engineSetKeyEntry(String alias,
byte[] key,
Certificate[] chain)
指定された別名に、すでに保護されている指定の鍵を割り当てます。 |
abstract void |
engineSetKeyEntry(String alias,
Key key,
char[] password,
Certificate[] chain)
指定された別名に指定された鍵を割り当て、指定されたパスワードでその鍵を保護します。 |
abstract int |
engineSize()
このキーストアのエントリ数を取得します。 |
void |
engineStore(KeyStore.LoadStoreParameter param)
指定された KeyStore.LoadStoreParmeter を使用してキーストアを格納します。 |
abstract void |
engineStore(OutputStream stream,
char[] password)
指定された出力ストリームにこのキーストアを格納し、指定されたパスワードでその整合性を保護します。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
---|
public KeyStoreSpi()
メソッドの詳細 |
---|
public abstract Key engineGetKey(String alias, char[] password) throws NoSuchAlgorithmException, UnrecoverableKeyException
setKeyEntry
を呼び出すか、あるいは PrivateKeyEntry
または SecretKeyEntry
を指定して setEntry
を呼び出すことでその別名に関連付けられている必要があります。
alias
- 別名password
- 鍵を復元するためのパスワード
NoSuchAlgorithmException
- 鍵を復元するためのアルゴリズムが見つからない場合
UnrecoverableKeyException
- 指定されたパスワードが間違っている場合など、鍵を復元できない場合public abstract Certificate[] engineGetCertificateChain(String alias)
setKeyEntry
を呼び出すか、あるいは PrivateKeyEntry
を指定して setEntry
を呼び出すことで別名に関連付けられている必要があります。
alias
- 別名
public abstract Certificate engineGetCertificate(String alias)
指定された別名によって識別されるエントリが、setCertificateEntry
を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry
を指定して setEntry
を呼び出して作成されたエントリのいずれかである場合、そのエントリ内に格納されている信頼できる証明書が返されます。
指定された別名によって識別されるエントリが、setKeyEntry
を呼び出して作成されたエントリ、PrivateKeyEntry
を指定して setEntry
を呼び出して作成されたエントリのいずれかである場合、そのエントリ内の証明連鎖 (存在する場合) の最初の要素が返されます。
alias
- 別名
public abstract Date engineGetCreationDate(String alias)
alias
- 別名
public abstract void engineSetKeyEntry(String alias, Key key, char[] password, Certificate[] chain) throws KeyStoreException
指定された鍵が java.security.PrivateKey
型である場合、対応する公開鍵を証明する証明連鎖も指定する必要があります。
指定された別名がすでに存在する場合は、それに関連したキーストア情報は、指定された鍵と証明連鎖によってオーバーライドされます。
alias
- 別名key
- 別名に関連付ける鍵password
- 鍵を保護するためのパスワードchain
- 対応する公開鍵の証明連鎖。指定された鍵が java.security.PrivateKey
型である場合にだけ必要
KeyStoreException
- 指定された鍵を保護できない場合や、この処理がほかの原因で失敗した場合public abstract void engineSetKeyEntry(String alias, byte[] key, Certificate[] chain) throws KeyStoreException
保護された鍵が java.security.PrivateKey
型である場合、対応する公開鍵を証明する証明連鎖も指定する必要があります。
指定された別名がすでに存在する場合は、それに関連したキーストア情報は、指定された鍵と証明連鎖によってオーバーライドされます。
alias
- 別名key
- 別名に関連付ける保護形式の鍵chain
- 保護された鍵が java.security.PrivateKey
型である場合にだけ有効な対応する公開鍵の証明連鎖
KeyStoreException
- この処理が失敗した場合public abstract void engineSetCertificateEntry(String alias, Certificate cert) throws KeyStoreException
指定された別名によって識別されるエントリが、setCertificateEntry
を呼び出して作成された既存エントリ、あるいは TrustedCertificateEntry
を指定して setEntry
を呼び出して作成された既存エントリのいずれかである場合、その既存エントリ内に格納されている信頼できる証明書が、指定された証明書で上書きされます。
alias
- 別名cert
- 証明書
KeyStoreException
- 指定された別名がすでに存在しており、そのエントリに信頼できる証明書が含まれていない場合、あるいはこの処理がほかの原因で失敗した場合public abstract void engineDeleteEntry(String alias) throws KeyStoreException
alias
- 別名
KeyStoreException
- エントリを削除できない場合public abstract Enumeration<String> engineAliases()
public abstract boolean engineContainsAlias(String alias)
alias
- 別名
public abstract int engineSize()
public abstract boolean engineIsKeyEntry(String alias)
setKeyEntry
を呼び出して作成されたエントリ、あるいは PrivateKeyEntry
または SecretKeyEntry
を指定して setEntry
を呼び出して作成されたエントリのいずれかである場合、true を返します。
alias
- 判定対象となるキーストアエントリの別名
public abstract boolean engineIsCertificateEntry(String alias)
setCertificateEntry
を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry
を指定して setEntry
を呼び出して作成されたエントリのいずれかである場合、true を返します。
alias
- 判定対象となるキーストアエントリの別名
public abstract String engineGetCertificateAlias(Certificate cert)
このメソッドは、指定された証明書を各キーストアエントリと照合します。処理対象のエントリが、setCertificateEntry
を呼び出して作成されたエントリ、あるいは TrustedCertificateEntry
を指定して setEntry
を呼び出して作成されたエントリである場合、指定された証明書はそのエントリの証明書と比較されます。
処理対象のエントリが、setKeyEntry
を呼び出して作成されたエントリ、あるいは PrivateKeyEntry
を指定して setEntry
を呼び出して作成されたエントリである場合、指定された証明書はそのエントリの証明連鎖の最初の要素と比較されます。
cert
- 照合する証明書
public abstract void engineStore(OutputStream stream, char[] password) throws IOException, NoSuchAlgorithmException, CertificateException
stream
- このキーストアを書き込む出力ストリームpassword
- キーストアの整合性を検査するためのパスワード
IOException
- データに入出力の問題があった場合
NoSuchAlgorithmException
- 適切なデータ整合性アルゴリズムが見つからなかった場合
CertificateException
- キーストアデータに含まれるどの証明書も格納できなかった場合public void engineStore(KeyStore.LoadStoreParameter param) throws IOException, NoSuchAlgorithmException, CertificateException
KeyStore.LoadStoreParmeter
を使用してキーストアを格納します。
param
- キーストアの格納方法を指定した KeyStore.LoadStoreParmeter
。 null
も指定可能
IllegalArgumentException
- 指定された KeyStore.LoadStoreParmeter
入力が認識されない場合
IOException
- データに入出力の問題があった場合
NoSuchAlgorithmException
- 適切なデータ整合性アルゴリズムが見つからなかった場合
CertificateException
- キーストアデータに含まれるどの証明書も格納できなかった場合public abstract void engineLoad(InputStream stream, char[] password) throws IOException, NoSuchAlgorithmException, CertificateException
パスワードを指定すると、キーストアがハードウェアトークンデバイス上に存在する場合などに、キーストアのロック解除やキーストアデータの完全性検査ができます。完全性検査用のパスワードが指定されなかった場合、完全性検査は実行されません。
stream
- キーストアのロード元の入力ストリームまたは null
password
- キーストアの完全性検査用パスワード、キーストアのロック解除用パスワード、または null
IOException
- キーストアデータで入出力または形式に関する問題が発生した場合、パスワードが必要であるのに指定されなかった場合、あるいは指定されたパスワードが間違っている場合
NoSuchAlgorithmException
- キーストアの整合性を検査するアルゴリズムが見つからなかった場合
CertificateException
- キーストアのどの証明書もロードできなかった場合public void engineLoad(KeyStore.LoadStoreParameter param) throws IOException, NoSuchAlgorithmException, CertificateException
KeyStore.LoadStoreParameter
を使用してキーストアをロードします。
このキーストアがすでにロードされている場合、このキーストアは再び初期化され、指定されたストリームからロードし直されます。
param
- キーストアのロード方法を指定した KeyStore.LoadStoreParameter
。null
も指定可能
IllegalArgumentException
- 指定された KeyStore.LoadStoreParmeter
入力が認識されない場合
IOException
- キーストアデータに入出力または形式の問題があった場合
NoSuchAlgorithmException
- キーストアの整合性を検査するアルゴリズムが見つからなかった場合
CertificateException
- キーストアのどの証明書もロードできなかった場合public KeyStore.Entry engineGetEntry(String alias, KeyStore.ProtectionParameter protParam) throws KeyStoreException, NoSuchAlgorithmException, UnrecoverableEntryException
KeyStore.Entry
を取得します。
alias
- この別名に対する KeyStore.Entry
を取得するprotParam
- Entry
の保護に使用される ProtectionParameter
。null
も指定可能
KeyStore.Entry
。そのようなエントリが存在しない場合は null
KeyStoreException
- 処理が失敗した場合
NoSuchAlgorithmException
- エントリを復元するためのアルゴリズムが見つからない場合
UnrecoverableEntryException
- 指定された protParam
が不十分または無効である場合public void engineSetEntry(String alias, KeyStore.Entry entry, KeyStore.ProtectionParameter protParam) throws KeyStoreException
KeyStore.Entry
を指定された別名で保存します。指定された保護パラメータは、Entry
を保護するために使用されます。
指定された別名のエントリがすでに存在する場合、そのエントリは上書きされます。
alias
- この別名で KeyStore.Entry
を保存entry
- 保存する Entry
protParam
- Entry
の保護に使用される ProtectionParameter
。null
も指定可能
KeyStoreException
- この処理が失敗した場合public boolean engineEntryInstanceOf(String alias, Class<? extends KeyStore.Entry> entryClass)
alias
のキーストア Entry
が、指定された entryClass
のインスタンスまたはサブクラスであるかどうかを判定します。
alias
- 別名entryClass
- エントリクラス
alias
のキーストア Entry
が、指定された entryClass
のインスタンスまたはサブクラスである場合は true、そうでない場合は false
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。