モジュール java.base

パッケージ java.security.cert

クラスPKIXParameters

java.lang.Object

java.security.cert.PKIXParameters

すべての実装されたインタフェース:

Cloneable, CertPathParameters

直系の既知のサブクラス:

PKIXBuilderParameters

public class PKIXParameters extends Object implements CertPathParameters

PKIX CertPathValidatorアルゴリズムの入力で使用されるパラメータです。

PKIX CertPathValidatorではこれらのパラメータを使用し、PKIX証明書パス検査アルゴリズムに従ってCertPathを検査します。

PKIXParametersオブジェクトをインスタンス化するには、アプリケーションでPKIX証明書パス検査アルゴリズムで定義されるもっとも信頼できるCAを1つ以上指定しなければいけません。 もっとも信頼できるCAは、2つのコンストラクタのどちらかを使用して指定されます。 PKIXParameters(Set)を呼び出す場合は、TrustAnchorオブジェクトのSetを指定します。それぞれのTrustAnchorオブジェクトではもっとも信頼できるCAを特定します。 またアプリケーションは、信頼できる証明書エントリが含まれるKeyStoreインスタンスを指定してPKIXParameters(KeyStore)を呼び出すことができます。それぞれの証明書エントリがもっとも信頼できるCAになります。

PKIXParametersオブジェクトが作成されると、(たとえばsetInitialPoliciesまたはsetDateを呼び出して)ほかのパラメータを指定し、PKIXParametersが検査対象のCertPathとともにCertPathValidator.validateに渡されます。

設定されていない(またはnullに設定されている)パラメータは、それぞれのデフォルト値に設定されます。 dateパラメータのデフォルト値はnullで、パスが検証されたときの現在時刻を示します。 そのほかのパラメータのデフォルト値はほとんど制約されません。

並行アクセス

特に断らないかぎり、このクラスで定義されているメソッドはスレッドセーフではありません。 単一のオブジェクトに並行アクセスする必要のある複数スレッドは、スレッド間で同期をとり、必要に応じてロックする必要があります。 複数のスレッドがそれぞれ個別のオブジェクトを処理する場合、それらのスレッドは同期する必要はありません。

導入されたバージョン:

1.4

関連項目:

• CertPathValidator

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

コンストラクタ

コンストラクタ	説明
PKIXParameters(KeyStore keystore)	もっとも信頼できるCAのセットを、指定したKeyStoreに含まれる信頼できる証明書エントリから生成する、PKIXParametersのインスタンスを作成します。
PKIXParameters(Set<TrustAnchor> trustAnchors)	もっとも信頼できるCAからなる指定したSetで、PKIXParametersのインスタンスを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	addCertPathChecker(PKIXCertPathChecker checker)	PKIXCertPathCheckerを証明書パス・チェッカのリストに追加します。
void	addCertStore(CertStore store)	CertStoreを、証明書とCRLを見つけるために使用されるCertStoreのリストの最後に追加します。
Object	clone()	このPKIXParametersオブジェクトのコピーを作成します。
List<PKIXCertPathChecker>	getCertPathCheckers()	証明書パス・チェッカのListを返します。
List<CertStore>	getCertStores()	証明書とCRLを見つけるために使用されるCertStoreの不変なListを返します。
Date	getDate()	証明書パスの妥当性が判断される時刻を返します。
Set<String>	getInitialPolicies()	どの初期ポリシーも証明書パス処理のために証明書ユーザーにとって許容できるような初期ポリシー識別子(OID文字列)の不変なSetを返します。
boolean	getPolicyQualifiersRejected()	PolicyQualifiersRejectedフラグを取得します。
String	getSigProvider()	署名プロバイダの名前を返します。設定されていない場合はnullを返します。
CertSelector	getTargetCertConstraints()	ターゲット証明書に要求された制約を返します。
Set<TrustAnchor>	getTrustAnchors()	もっとも信頼できるCAの不変なSetを返します。
boolean	isAnyPolicyInhibited()	任意のポリシーOIDが証明書に含まれるとき、そのポリシーOIDが処理されるべきかどうかをチェックします。
boolean	isExplicitPolicyRequired()	明示的なポリシーが要求されているかどうかをチェックします。
boolean	isPolicyMappingInhibited()	ポリシー・マッピングが抑制されているかどうかをチェックします。
boolean	isRevocationEnabled()	RevocationEnabledフラグをチェックします。
void	setAnyPolicyInhibited(boolean val)	任意のポリシーOIDが証明書に含まれるときに、そのポリシーOIDが処理されなければならないかどうかを判断する状態を設定します。
void	setCertPathCheckers(List<PKIXCertPathChecker> checkers)	追加の証明書パス・チェッカのListを設定します。
void	setCertStores(List<CertStore> stores)	証明書とCRLを見つけるために使用されるCertStoreのリストを設定します。
void	setDate(Date date)	証明書パスの妥当性が判断される時刻を設定します。
void	setExplicitPolicyRequired(boolean val)	ExplicitPolicyRequiredフラグを設定します。
void	setInitialPolicies(Set<String> initialPolicies)	初期ポリシー識別子(OID文字列)のSetを設定して、証明書パス処理のためにどの初期ポリシーも証明書ユーザーが許容できることを示します。
void	setPolicyMappingInhibited(boolean val)	PolicyMappingInhibitedフラグを設定します。
void	setPolicyQualifiersRejected(boolean qualifiersRejected)	PolicyQualifiersRejectedフラグを設定します。
void	setRevocationEnabled(boolean val)	RevocationEnabledフラグを設定します。
void	setSigProvider(String sigProvider)	署名プロバイダの名前を設定します。
void	setTargetCertConstraints(CertSelector selector)	ターゲット証明書に要求された制約を設定します。
void	setTrustAnchors(Set<TrustAnchor> trustAnchors)	もっとも信頼できるCAのSetを設定します。
String	toString()	パラメータを説明する書式付き文字列を返します。

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

PKIXParameters

public PKIXParameters(Set<TrustAnchor> trustAnchors) throws InvalidAlgorithmParameterException

もっとも信頼できるCAからなる指定したSetで、PKIXParametersのインスタンスを作成します。 セットの各要素はTrustAnchorです。

以後の変更から保護するために、Setは複製されています。

パラメータ:

trustAnchors - TrustAnchorのSet

例外:

InvalidAlgorithmParameterException - 指定されたSetが空((trustAnchors.isEmpty()== true))である場合

NullPointerException - 指定されたSetがnullである場合

ClassCastException - Setの要素のいずれかがjava.security.cert.TrustAnchor型ではない場合

PKIXParameters

public PKIXParameters(KeyStore keystore) throws KeyStoreException, InvalidAlgorithmParameterException

もっとも信頼できるCAのセットを、指定したKeyStoreに含まれる信頼できる証明書エントリから生成する、PKIXParametersのインスタンスを作成します。 信頼できるX509Certificatesを含むキーストア・エントリだけが対象となり、それ以外の証明書タイプはすべて無視されます。

パラメータ:

keystore - もっとも信頼できるCAのセットが生成されるKeyStore

例外:

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

InvalidAlgorithmParameterException - キーストアに信頼できる証明書エントリが1つも含まれない場合

NullPointerException - キーストアがnullである場合

メソッドの詳細

getTrustAnchors

public Set<TrustAnchor> getTrustAnchors()

もっとも信頼できるCAの不変なSetを返します。

戻り値:

TrustAnchorの不変のSet。nullにはならない

関連項目:

• setTrustAnchors(java.util.Set<java.security.cert.TrustAnchor>)

setTrustAnchors

public void setTrustAnchors(Set<TrustAnchor> trustAnchors) throws InvalidAlgorithmParameterException

もっとも信頼できるCAのSetを設定します。

以後の変更から保護するために、Setは複製されています。

パラメータ:

trustAnchors - TrustAnchorのSet

例外:

InvalidAlgorithmParameterException - 指定されたSetが空((trustAnchors.isEmpty()== true))である場合

NullPointerException - 指定されたSetがnullである場合

ClassCastException - セットの要素のいずれかが型java.security.cert.TrustAnchorではない場合

関連項目:

• getTrustAnchors()

getInitialPolicies

public Set<String> getInitialPolicies()

どの初期ポリシーも証明書パス処理のために証明書ユーザーにとって許容できるような初期ポリシー識別子(OID文字列)の不変なSetを返します。 デフォルトの戻り値は空のSetで、どのポリシーも許容可能として解釈されます。

戻り値:

String形式の初期ポリシーOIDの不変のSet、または空のSet (どのポリシーも許容できることを意味する)。 nullを返すことはない。

関連項目:

• setInitialPolicies(java.util.Set<java.lang.String>)

setInitialPolicies

public void setInitialPolicies(Set<String> initialPolicies)

初期ポリシー識別子(OID文字列)のSetを設定して、証明書パス処理のためにどの初期ポリシーも証明書ユーザーが許容できることを示します。 デフォルトでは、どのポリシーも(つまりすべてのポリシーを)許容できるため、どのポリシーも許容できるようにしたいユーザーはこのメソッドを呼び出す必要はありません。または、空のSet (またはnull)で呼び出すことができます。

以後の変更から保護するために、Setは複製されています。

パラメータ:

initialPolicies - String形式の初期ポリシーOIDのSet (またはnull)

例外:

ClassCastException - セットの要素のいずれかが型Stringではない場合

関連項目:

• getInitialPolicies()

setCertStores

public void setCertStores(List<CertStore> stores)

証明書とCRLを見つけるために使用されるCertStoreのリストを設定します。 使用されるCertStoreがない場合には、nullになります。 リスト中の最初のCertStoreは、後のエントリに優先します。

以後の変更から保護するために、Listは複製されています。

パラメータ:

stores - CertStoreのList、またはnull

例外:

ClassCastException - リストの要素のいずれかが型java.security.cert.CertStoreではない場合

関連項目:

• getCertStores()

addCertStore

public void addCertStore(CertStore store)

CertStoreを、証明書とCRLを見つけるために使用されるCertStoreのリストの最後に追加します。

パラメータ:

store - 追加されるCertStore。 nullの場合、ストアは無視される(リストに追加されない)。

getCertStores

public List<CertStore> getCertStores()

証明書とCRLを見つけるために使用されるCertStoreの不変なListを返します。

戻り値:

CertStoreの不変なList (空は可、nullは不可)

関連項目:

• setCertStores(java.util.List<java.security.cert.CertStore>)

setRevocationEnabled

public void setRevocationEnabled(boolean val)

RevocationEnabledフラグを設定します。 このフラグがtrueの場合、PKIXRevocationCheckerがCertPathChecker (詳細は、次の説明を参照してください)として渡されないかぎり、基礎となるPKIXサービス・プロバイダのデフォルト取消しチェック・メカニズムが使用されます。 falseの場合、デフォルトの取消しチェック・メカニズムは無効にされます(使用されない)。

PKIXParametersオブジェクトが作成されると、このフラグはtrueに設定されます。 各サービス・プロバイダではPKIXに準拠するために取消しチェックをサポートする必要があるので、この設定は取消しをチェックするもっとも一般的な方法を反映しています。 PKIXサービス・プロバイダのデフォルトの取消しチェック・メカニズムを使用することが実際的でないときや、代替の取消しチェック・メカニズムが代わりをするときは(addCertPathCheckerまたはsetCertPathCheckersメソッドを呼び出すことによっても)、高度なアプリケーションでこのフラグをfalseに設定する必要があります。

PKIXRevocationCheckerがaddCertPathCheckerまたはsetCertPathCheckersメソッドを介してパラメータとして渡される場合、RevocationEnabledフラグの設定に関係なく失効をチェックするために使用されます。

パラメータ:

val - RevocationEnabledフラグの新しい値

isRevocationEnabled

public boolean isRevocationEnabled()

RevocationEnabledフラグをチェックします。 このフラグがtrueの場合、PKIXRevocationCheckerがCertPathCheckerとして渡されないかぎり、基礎となるPKIXサービス・プロバイダのデフォルト取消しチェック・メカニズムが使用されます。 falseの場合、デフォルトの取消しチェック・メカニズムは無効にされます(使用されない)。 このフラグの値を設定する詳細については、setRevocationEnabledメソッドを参照してください。

戻り値:

RevocationEnabledフラグの現在の値

setExplicitPolicyRequired

public void setExplicitPolicyRequired(boolean val)

ExplicitPolicyRequiredフラグを設定します。 このフラグがtrueの場合、許容できるポリシーがそれぞれの証明書で明示的に特定されている必要があります。 デフォルトでExplicitPolicyRequiredフラグはfalseです。

パラメータ:

val - 明示的なポリシーが要求されている場合はtrue、そうでない場合はfalse

isExplicitPolicyRequired

public boolean isExplicitPolicyRequired()

明示的なポリシーが要求されているかどうかをチェックします。 このフラグがtrueの場合、許容できるポリシーがそれぞれの証明書で明示的に特定されている必要があります。 デフォルトでExplicitPolicyRequiredフラグはfalseです。

戻り値:

明示的なポリシーが要求されている場合はtrue、そうでない場合はfalse

setPolicyMappingInhibited

public void setPolicyMappingInhibited(boolean val)

PolicyMappingInhibitedフラグを設定します。 このフラグがtrueの場合、ポリシー・マッピングは抑制されています。 デフォルトでポリシー・マッピングは抑制されていません(フラグはfalse)。

パラメータ:

val - ポリシー・マッピングが抑制されている場合はtrue、そうでない場合はfalse

isPolicyMappingInhibited

public boolean isPolicyMappingInhibited()

ポリシー・マッピングが抑制されているかどうかをチェックします。 このフラグがtrueの場合、ポリシー・マッピングは抑制されています。 デフォルトでポリシー・マッピングは抑制されていません(フラグはfalse)。

戻り値:

ポリシー・マッピングが抑制されている場合はtrue、そうでない場合はfalse

setAnyPolicyInhibited

public void setAnyPolicyInhibited(boolean val)

任意のポリシーOIDが証明書に含まれるときに、そのポリシーOIDが処理されなければならないかどうかを判断する状態を設定します。 デフォルトでは、ポリシーOIDは抑制されません(isAnyPolicyInhibited()はfalseを返す)。

パラメータ:

val - 任意のポリシーOIDが抑制される場合はtrue、そうでない場合はfalse

isAnyPolicyInhibited

public boolean isAnyPolicyInhibited()

任意のポリシーOIDが証明書に含まれるとき、そのポリシーOIDが処理されるべきかどうかをチェックします。

戻り値:

任意のポリシーOIDが抑制されている場合はtrue、そうでない場合はfalse

setPolicyQualifiersRejected

public void setPolicyQualifiersRejected(boolean qualifiersRejected)

PolicyQualifiersRejectedフラグを設定します。 このフラグがtrueの場合、クリティカルにマークされている証明書ポリシー機能拡張にポリシー修飾子を含む証明書は、拒否されます。 フラグがfalseの場合、この理由では拒否されません。

PKIXParametersオブジェクトが作成されると、このフラグはtrueに設定されます。 この設定は、ポリシー修飾子を処理するためのもっとも一般的な(かつ簡単な)方法を反映します。 より複雑なポリシーを使用するアプリケーションでは、このフラグをfalseに設定する必要があります。

PKIX証明書パス検査アルゴリズムでは、クリティカルにマークされた証明書ポリシー拡張機能のポリシー修飾子が必ず処理され、検査されるように指定します。 ポリシー修飾子が処理および検査されないと、その証明書パスは拒否されます。 policyQualifiersRejectedフラグがfalseに設定されている場合、PKIX互換のためにこの方法ですべてのポリシー修飾子を検査するかどうかは、アプリケーションによって異なります。

パラメータ:

qualifiersRejected - PolicyQualifiersRejectedフラグの新しい値

関連項目:

• getPolicyQualifiersRejected()
• PolicyQualifierInfo

getPolicyQualifiersRejected

public boolean getPolicyQualifiersRejected()

PolicyQualifiersRejectedフラグを取得します。 このフラグがtrueの場合、クリティカルにマークされている証明書ポリシー機能拡張にポリシー修飾子を含む証明書は、拒否されます。 フラグがfalseの場合、この理由では拒否されません。

PKIXParametersオブジェクトが作成されると、このフラグはtrueに設定されます。 この設定は、ポリシー修飾子を処理するためのもっとも一般的な(かつ簡単な)方法を反映します。 より複雑なポリシーを使用するアプリケーションでは、このフラグをfalseに設定する必要があります。

戻り値:

PolicyQualifiersRejectedフラグの現在の値

関連項目:

• setPolicyQualifiersRejected(boolean)

getDate

public Date getDate()

証明書パスの妥当性が判断される時刻を返します。 nullの場合、現在時刻が使われます。

以後の変更から保護するために、返されるDateは複製されています。

戻り値:

Date。設定されていない場合はnull

関連項目:

• setDate(java.util.Date)

setDate

public void setDate(Date date)

証明書パスの妥当性が判断される時刻を設定します。 nullの場合、現在時刻が使われます。

以後の変更から保護するために、ここで提供されるDateは複製されています。

パラメータ:

date - Date。現在時刻の場合はnull

関連項目:

• getDate()

setCertPathCheckers

public void setCertPathCheckers(List<PKIXCertPathChecker> checkers)

追加の証明書パス・チェッカのListを設定します。 指定したListにPKIXCertPathCheckerでないオブジェクトが含まれる場合は無視されます。

指定した各PKIXCertPathCheckerでは、証明書の追加チェックを実装しています。 通常、証明書に含まれている専用の機能拡張を、処理および検査しているかどうかをチェックします。 それぞれのPKIXCertPathCheckerは、チェックを行うために必要な初期化パラメータでインスタンス化されなければいけません。

高度なアプリケーションでは、このメソッドによりPKIX CertPathValidatorやCertPathBuilderを拡張できます。 処理された、または検査された証明書のぞれぞれに対し、指定したPKIXCertPathCheckerが、PKIX CertPathValidatorやCertPathBuilderによってそれぞれ順番に呼び出されます。

これらの追加PKIXCertPathCheckerが設定されているかどうかにかかわらず、PKIX CertPathValidatorやCertPathBuilderでは要求された各証明書のPKIXチェックをすべて実行する必要があります。 このルールの例外の1つに、RevocationEnabledフラグがfalseに設定された場合があります(setRevocationEnabledメソッド参照)。

以後の変更から保護するために、ここで提供されるListとリスト内の各PKIXCertPathCheckerは複製されています。

パラメータ:

checkers - PKIXCertPathCheckerのList。 nullの場合、追加のチェッカは使用されない。

例外:

ClassCastException - リストの要素のいずれかが型java.security.cert.PKIXCertPathCheckerではない場合

関連項目:

• getCertPathCheckers()

getCertPathCheckers

public List<PKIXCertPathChecker> getCertPathCheckers()

証明書パス・チェッカのListを返します。 返されたListは不変であり、List内の各PKIXCertPathCheckerは以後の変更から保護するために複製されています。

戻り値:

PKIXCertPathCheckerの不変なList (空は可、nullは不可)

関連項目:

• setCertPathCheckers(java.util.List<java.security.cert.PKIXCertPathChecker>)

addCertPathChecker

public void addCertPathChecker(PKIXCertPathChecker checker)

PKIXCertPathCheckerを証明書パス・チェッカのリストに追加します。 詳細は、setCertPathCheckersメソッドを参照してください。

以後の変更から保護するために、PKIXCertPathCheckerは複製されています。

パラメータ:

checker - チェックのリストに追加されるPKIXCertPathChecker。 nullの場合、チェッカは無視される(リストに追加されない)。

getSigProvider

public String getSigProvider()

署名プロバイダの名前を返します。設定されていない場合はnullを返します。

戻り値:

署名プロバイダの名前、またはnull

関連項目:

• setSigProvider(java.lang.String)

setSigProvider

public void setSigProvider(String sigProvider)

署名プロバイダの名前を設定します。 Signatureオブジェクトを作成するときには、指定したプロバイダが推奨されます。 null、または設定されていない場合は、アルゴリズムをサポートする、最初に見つかったプロバイダが使用されます。

パラメータ:

sigProvider - 署名プロバイダの名前、またはnull

関連項目:

• getSigProvider()

getTargetCertConstraints

public CertSelector getTargetCertConstraints()

ターゲット証明書に要求された制約を返します。 制約はCertSelectorのインスタンスとして返されます。 nullの場合は、制約が定義されていません。

以後の変更から保護するために、返されるCertSelectorは複製されています。

戻り値:

ターゲット証明書の制約を指定するCertSelector、またはnull

関連項目:

• setTargetCertConstraints(java.security.cert.CertSelector)

setTargetCertConstraints

public void setTargetCertConstraints(CertSelector selector)

ターゲット証明書に要求された制約を設定します。 制約はCertSelectorのインスタンスとして指定されます。 nullの場合は、制約が定義されていません。

以後の変更から保護するために、指定されたCertSelectorは複製されています。

パラメータ:

selector - ターゲット証明書の制約を指定するCertSelector、またはnull

関連項目:

• getTargetCertConstraints()

clone

public Object clone()

このPKIXParametersオブジェクトのコピーを作成します。 コピーに変更を加えても元の属性には影響ありません。また逆の場合も同じです。

定義:

clone、インタフェースCertPathParameters

オーバーライド:

clone、クラスObject

戻り値:

このPKIXParametersオブジェクトのコピー

関連項目:

• Cloneable

toString

public String toString()

パラメータを説明する書式付き文字列を返します。

オーバーライド:

toString、クラスObject

戻り値:

パラメータを説明する書式付き文字列。