java.security.cert

クラス CertificateFactory

java.lang.Object

java.security.cert.CertificateFactory

public class CertificateFactory
extends Object

このクラスは、証明書ファクトリの機能を定義します。証明書ファクトリは、証明書オブジェクト、証明書パス (CertPath) および証明書の取り消しリスト (CRL) オブジェクトを符号から生成するために使用します。

複数の証明書からなる符号化では、互いに関連性がないと思われる証明書のコレクションを解析する場合に、generateCertificates を使用します。そうでない場合は、CertPath (証明書チェーン) を生成して CertPathValidator で検証するときに generateCertPath を使用します。

X.509 の証明書ファクトリは、java.security.cert.X509Certificate のインスタンスである証明書、および java.security.cert.X509CRL のインスタンスである CRL を返します。

次の例は、Base64 で符号化された証明書を持つファイルを読み出します。これらの証明書は、先頭が -----BEGIN CERTIFICATE----- によって区切られ、終端が -----END CERTIFICATE----- によって区切られます。generateCertificate の各呼び出しが 1 つの証明書だけを使用し、入力ストリームの読み出し位置がファイル内の次の証明書に置かれるように、FileInputStream (mark および reset をサポートしていない) を BufferedInputStream (これらのメソッドをサポート) に変換します。

 FileInputStream fis = new FileInputStream(filename);
 BufferedInputStream bis = new BufferedInputStream(fis);

 CertificateFactory cf = CertificateFactory.getInstance("X.509");

 while (bis.available() > 0) {
    Certificate cert = cf.generateCertificate(bis);
    System.out.println(cert.toString());
 }
 

次の例は、ファイル内に保存された PKCS#7 形式の認証応答を解析し、そこから証明書をすべて抽出します。

 FileInputStream fis = new FileInputStream(filename);
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 Collection c = cf.generateCertificates(fis);
 Iterator i = c.iterator();
 while (i.hasNext()) {
    Certificate cert = (Certificate)i.next();
    System.out.println(cert);
 }
 

Java プラットフォームの実装は、すべて次の標準の CertificateFactory タイプをサポートする必要があります。

• X.509

また、次の標準の CertPath 符号化にも対応する必要があります。

• PKCS7
• PkiPath

タイプおよび符号化については、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの CertificateFactory セクションおよび CertPath Encodings セクションで説明されています。サポートされているその他のタイプや符号化については、実装のリリースノートを参照してください。

導入されたバージョン:

1.2

関連項目:

Certificate, X509Certificate, CertPath, CRL, X509CRL

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

コンストラクタ

修飾子	コンストラクタと説明
protected	CertificateFactory(CertificateFactorySpi certFacSpi, Provider provider, String type) 指定されたタイプの CertificateFactory オブジェクトを作成し、指定されたプロバイダの実装 (SPI オブジェクト) をそこにカプセル化します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Certificate	generateCertificate(InputStream inStream) 証明書オブジェクトを生成し、入力ストリーム inStream から読み込まれたデータで初期化します。
Collection<? extends Certificate>	generateCertificates(InputStream inStream) 指定された入力ストリーム inStream から読み込まれた証明書のコレクションビュー (空の場合もある) を返します。
CertPath	generateCertPath(InputStream inStream) CertPath オブジェクトを生成し、InputStream である inStream から読み込まれたデータで初期化します。
CertPath	generateCertPath(InputStream inStream, String encoding) CertPath オブジェクトを生成し、InputStream である inStream から読み込まれたデータで初期化します。
CertPath	generateCertPath(List<? extends Certificate> certificates) CertPath オブジェクトを生成し、Certificate の List で初期化します。
CRL	generateCRL(InputStream inStream) 証明書の取り消しリスト (CRL) オブジェクトを生成し、入力ストリーム inStream から読み込まれたデータで初期化します。
Collection<? extends CRL>	generateCRLs(InputStream inStream) 指定された入力ストリーム inStream から読み込まれた CRL のコレクションビュー (空の場合もある) を返します。
Iterator<String>	getCertPathEncodings() この証明書ファクトリでサポートする CertPath のエンコーディングの繰り返しを返します。繰り返しの最初はデフォルトのエンコーディングになります。
static CertificateFactory	getInstance(String type) 指定されたタイプの証明書を実装する証明書ファクトリオブジェクトを返します。
static CertificateFactory	getInstance(String type, Provider provider) 指定されたタイプの証明書ファクトリオブジェクトを返します。
static CertificateFactory	getInstance(String type, String provider) 指定されたタイプの証明書ファクトリオブジェクトを返します。
Provider	getProvider() この証明書ファクトリのプロバイダを返します。
String	getType() この証明書ファクトリに関連した証明書タイプの名前を返します。

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

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

コンストラクタの詳細

CertificateFactory

protected CertificateFactory(CertificateFactorySpi certFacSpi,
                  Provider provider,
                  String type)

指定されたタイプの CertificateFactory オブジェクトを作成し、指定されたプロバイダの実装 (SPI オブジェクト) をそこにカプセル化します。

パラメータ:

certFacSpi - プロバイダの実装。

provider - プロバイダ。

type - 証明書タイプ。

メソッドの詳細

getInstance

public static final CertificateFactory getInstance(String type)
                                            throws CertificateException

指定されたタイプの証明書を実装する証明書ファクトリオブジェクトを返します。

このメソッドは、最優先の Provider から順に、登録済みのセキュリティー Provider のリストをトラバースします。指定されたタイプをサポートする最初の Provider の CertificateFactorySpi 実装をカプセル化する新しい CertificateFactory オブジェクトが返されます。

登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。

パラメータ:

type - 要求された証明書タイプの名前。標準の証明書タイプについては、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの CertificateFactory のセクションを参照。

戻り値:

指定されたタイプの証明書ファクトリオブジェクト。

例外:

CertificateException - 指定されたタイプの CertificateFactorySpi 実装をサポートするプロバイダが存在しない場合。

関連項目:

Provider

getInstance

public static final CertificateFactory getInstance(String type,
                             String provider)
                                            throws CertificateException,
                                                   NoSuchProviderException

指定されたタイプの証明書ファクトリオブジェクトを返します。

指定されたプロバイダの CertificateFactorySpi 実装をカプセル化する新しい CertificateFactory オブジェクトが返されます。指定したプロバイダは、セキュリティープロバイダリストに登録する必要があります。

登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。

パラメータ:

type - 証明書タイプ。標準の証明書タイプについては、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの CertificateFactory のセクションを参照。

provider - プロバイダ名。

戻り値:

指定されたタイプの証明書ファクトリオブジェクト。

例外:

CertificateException - 指定されたプロバイダに指定されたアルゴリズムの CertificateFactorySpi の実装がない場合。

NoSuchProviderException - 指定されたプロバイダがセキュリティープロバイダリストに登録されていない場合。

IllegalArgumentException - プロバイダ名が null または空の場合。

関連項目:

Provider

getInstance

public static final CertificateFactory getInstance(String type,
                             Provider provider)
                                            throws CertificateException

指定されたタイプの証明書ファクトリオブジェクトを返します。

指定された Provider オブジェクトの CertificateFactorySpi 実装をカプセル化する新しい CertificateFactory オブジェクトが返されます。指定された Provider オブジェクトは、プロバイダリストに登録する必要はありません。

パラメータ:

type - 証明書タイプ。標準の証明書タイプについては、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの CertificateFactory のセクションを参照。

provider - プロバイダ。

戻り値:

指定されたタイプの証明書ファクトリオブジェクト。

例外:

CertificateException - 指定された Provider オブジェクトに指定されたアルゴリズムの CertificateFactorySpi の実装がない場合。

IllegalArgumentException - provider が null の場合。

導入されたバージョン:

1.4

関連項目:

Provider

getProvider

public final Provider getProvider()

この証明書ファクトリのプロバイダを返します。

戻り値:

この証明書ファクトリのプロバイダ。

getType

public final String getType()

この証明書ファクトリに関連した証明書タイプの名前を返します。

戻り値:

この証明書ファクトリに関連付けられた証明書タイプの名前。

generateCertificate

public final Certificate generateCertificate(InputStream inStream)
                                      throws CertificateException

証明書オブジェクトを生成し、入力ストリーム inStream から読み込まれたデータで初期化します。

この証明書ファクトリによってサポートされている特殊形式の証明書を利用するために、返された証明書オブジェクトを対応する証明書クラスに型キャストできます。たとえば、この証明書ファクトリが X.509 証明書を実装する場合、返された証明書オブジェクトを X509Certificate クラスに型キャストできます。

X.509 証明書の証明書ファクトリの場合は、inStream で提供される証明書は DER で符号化される必要があり、バイナリまたはプリント可能 (Base64) な符号で提供されることもあります。証明書が Base64 の符号で提供された場合、先頭は -----BEGIN CERTIFICATE----- によって区切られ、終端は -----END CERTIFICATE----- によって区切られる必要があります。

指定された入力ストリームが mark および reset をサポートしていない場合、このメソッドは入力ストリーム全体を使用します。そうでない場合、このメソッドが呼び出されるたびに証明書を 1 つ消費し、入力ストリームの読み込み位置は、固有の end-of-certificate マーカーのあとで次に使用可能なバイトに設定されます。固有の end-of-certificate マーカー (EOF 以外) が入力ストリームのデータに含まれず、証明書が構文解析されたあとでデータが続く場合は、CertificateException がスローされます。

パラメータ:

inStream - 証明書データを持つ入力ストリーム。

戻り値:

入力ストリームのデータを使って初期化された証明書オブジェクト。

例外:

CertificateException - 構文解析エラーの場合。

getCertPathEncodings

public final Iterator<String> getCertPathEncodings()

この証明書ファクトリでサポートする CertPath のエンコーディングの繰り返しを返します。繰り返しの最初はデフォルトのエンコーディングになります。標準の符号化名とその形式については、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの CertPath 符号化のセクションを参照。

返された Iterator を remove メソッドで変更しようとすると、UnsupportedOperationException がスローされます。

戻り値:

サポートされる CertPath 符号化の名前 (String) を反復する Iterator

導入されたバージョン:

1.4

generateCertPath

public final CertPath generateCertPath(InputStream inStream)
                                throws CertificateException

CertPath オブジェクトを生成し、InputStream である inStream から読み込まれたデータで初期化します。データはデフォルトの符号化がされていると仮定されます。デフォルトの符号化の名前は、getCertPathEncodings メソッドで返される Iterator の最初の要素になります。

パラメータ:

inStream - データが含まれる InputStream

戻り値:

InputStream からのデータで初期化された CertPath

例外:

CertificateException - 復号化中に例外が発生した場合

導入されたバージョン:

1.4

generateCertPath

public final CertPath generateCertPath(InputStream inStream,
                        String encoding)
                                throws CertificateException

CertPath オブジェクトを生成し、InputStream である inStream から読み込まれたデータで初期化します。データは指定した符号化がされていると仮定されます。標準の符号化名とその形式については、Java 暗号化アーキテクチャー標準アルゴリズム名のドキュメントの CertPath 符号化のセクションを参照。

パラメータ:

inStream - データが含まれる InputStream

encoding - データで使用される符号化

戻り値:

InputStream からのデータで初期化された CertPath

例外:

CertificateException - 復号化中に例外が発生した場合、または要求された符号化がサポートされていない場合

導入されたバージョン:

1.4

generateCertPath

public final CertPath generateCertPath(List<? extends Certificate> certificates)
                                throws CertificateException

CertPath オブジェクトを生成し、Certificate の List で初期化します。

提供される証明書は、CertificateFactory でサポートされているタイプである必要があります。これらは、指定された List オブジェクトからコピーされます。

パラメータ:

certificates - Certificate の List

戻り値:

提供された証明書のリストで初期化された CertPath

例外:

CertificateException - 例外が発生する場合

導入されたバージョン:

1.4

generateCertificates

public final Collection<? extends Certificate> generateCertificates(InputStream inStream)
                                                             throws CertificateException

指定された入力ストリーム inStream から読み込まれた証明書のコレクションビュー (空の場合もある) を返します。

この証明書ファクトリによってサポートされている特殊な形式の証明書を利用するために、返されたコレクションビューの各要素を対応する証明書クラスに型キャストできます。たとえば、この証明書ファクトリが X.509 証明書を実装する場合、返されたコレクション内の要素を X509Certificate クラスに型キャストできます。

X.509 証明書で使う証明書ファクトリの場合、inStream には、generateCertificate で説明されている形式の、DER で符号化された一連の証明書が格納されます。また、inStream には PKCS#7 証明書チェーンが格納されます。これは PKCS#7 SignedData オブジェクトであり、上位フィールドは certificates だけです。特に、署名および内容は無視されます。この形式の場合、複数の証明書を 1 回でダウンロードできます。証明書がない場合は、空のコレクションが返されます。

指定された入力ストリームが mark および reset をサポートしていない場合、このメソッドは入力ストリーム全体を使用します。

パラメータ:

inStream - 証明書を持つ入力ストリーム。

戻り値:

入力ストリームからのデータを使って初期化された java.security.cert.Certificate オブジェクトのコレクションビュー。空の場合もある。

例外:

CertificateException - 構文解析エラーの場合。

generateCRL

public final CRL generateCRL(InputStream inStream)
                      throws CRLException

証明書の取り消しリスト (CRL) オブジェクトを生成し、入力ストリーム inStream から読み込まれたデータで初期化します。

この証明書ファクトリによってサポートされている特殊な形式の CRL を利用するために、返された CRL オブジェクトを対応する CRL クラスに型キャストできます。たとえば、この証明書ファクトリが X.509 CRL を実装する場合、返された CRL オブジェクトを X509CRL クラスに型キャストできます。

指定された入力ストリームが mark および reset をサポートしていない場合、このメソッドは入力ストリーム全体を使用します。そうでない場合、このメソッドが呼び出されるたびに CRL を 1 つ消費し、入力ストリームの読み込み位置は、固有の end-of-CRL マーカーのあとで次に使用可能なバイトに設定されます。固有の end-of-CRL マーカー (EOF 以外) が入力ストリームのデータに含まれず、CRL が構文解析されたあとでデータが続く場合は、CRLException がスローされます。

パラメータ:

inStream - CRL データを持つ入力ストリーム。

戻り値:

入力ストリームのデータを使って初期化された CRL オブジェクト。

例外:

CRLException - 構文解析エラーの場合。

generateCRLs

public final Collection<? extends CRL> generateCRLs(InputStream inStream)
                                             throws CRLException

指定された入力ストリーム inStream から読み込まれた CRL のコレクションビュー (空の場合もある) を返します。

この証明書ファクトリによってサポートされている特殊な形式の CRL を利用するために、返されたコレクションビューの各要素を対応する CRL クラスに型キャストできます。たとえば、この証明書ファクトリが X.509 CRL を実装する場合、返されたコレクション内の要素を X509CRL クラスに型キャストできます。

X.509 CRL の証明書ファクトリの場合は、inStream には、DER で符号化された一連の CRL が格納されます。また、inStream には PKCS#7 CRL セットが格納されます。これは PKCS#7 SignedData オブジェクトであり、上位フィールドは crls だけです。特に、署名および内容は無視されます。この形式の場合、複数の CRL を 1 回でダウンロードできます。CRL がない場合は、空のコレクションが返されます。

指定された入力ストリームが mark および reset をサポートしていない場合、このメソッドは入力ストリーム全体を使用します。

パラメータ:

inStream - CRL を持つ入力ストリーム。

戻り値:

入力ストリームからのデータを使って初期化された java.security.cert.CRL オブジェクトのコレクションビュー。空の場合もある。

例外:

CRLException - 構文解析エラーの場合。