java.security.cert
클래스 CertStore

java.lang.Object 
  java.security.cert.CertStore

public class CertStore
extends Object 

리포지터리(repository)로부터 Certificate와 CRL를 얻는 클래스입니다.

이 클래스에서는 「Java 암호화 아키텍쳐」로 설명되고 있는 것 같은 프로바이더 베이스의 아키텍쳐를 사용합니다. CertStore를 작성하려면, static getInstance 메서드 가운데 1개를 호출해, 작성하는 CertStore 형태, 적용 가능한 초기화 파라미터, 프로바이더명 (생략 가능)을 건네줍니다.

CertStore를 작성하면, getCertificates 메서드와 getCRLs 메서드를 호출하는 것으로 Certificate와 CRL를 취득할 수 있습니다 .

비공개키와 신뢰할 수 있는 인증서 의 캐쉬에 액세스 하는 KeyStore 과는 달리, CertStore는 거대하게 될 우려가 있는 신뢰되어 있지 않은 인증서와 CRL 리포지터리(repository)에 액세스 하도록 설계되고 있습니다. 예를 들어, CertStore LDAP 구현에서는 LDAP 프로토콜과 RFC 서비스 속성으로서 정의된 schema를 사용해, 1개 이상의 디렉토리에 포함된 인증서와 CRL에 액세스 할 수 있습니다. 표준의 CertStore 형의 상세한 것에 대하여는 「Java Certification Path API Programmer's Guide 」의 부록 A를 참조하십시오.

병행 액세스

CertStore 객체의 모든 public 메서드는 thread 세이프가 아니면 안됩니다. 즉, 그러한 public 메서드는 악영향을 주는 일 없이, 단일 CertStore 객체 (또는 1개 이상) 상에서 복수 thread가 병행해 호출할 수 있습니다 . 이것에 의해 예를 들어 차례차례로 인증서를 검색하면서, 동시에 CertPathBuilder를 사용해 CRL를 검색할 수 있습니다 .

또, 이 클래스의 static 메서드는 thread 세이프인 것이 보증되고 있습니다. 이 클래스에서 정의되고 있는 static 메서드는 악영향을 주는 일 없이, 복수 thread가 병행해 호출할 수 있습니다 .

도입된 버전 :

1.4

생성자 개요

protected

CertStore (CertStoreSpi storeSpi, Provider provider, String type, CertStoreParameters params) 지정된 형태의 CertStore 객체를 작성해, 지정된 프로바이더의 구현 (SPI 객체)을 거기에 캡슐화합니다.

메서드 개요

Collection <? extends Certificate >	getCertificates (CertSelector selector) 지정한 셀렉터에 일치하는 Certificate Collection을 리턴합니다.
CertStoreParameters	getCertStoreParameters () CertStore를 초기화하기 위한 파라미터를 리턴합니다.
Collection <? extends CRL >	getCRLs (CRLSelector selector) 지정한 셀렉터에 일치하는 CRL Collection을 리턴합니다.
static String	getDefaultType () Java 시큐러티 프로퍼티 파일로 가리키는 디폴트의 CertStore 형을 리턴합니다.
static CertStore	getInstance (String type, CertStoreParameters params) 지정한 CertStore 형을 구현해, 지정한 파라미터로 초기화되는 CertStore를 리턴합니다.
static CertStore	getInstance (String type, CertStoreParameters params, Provider provider) 지정한 프로바이더가 제공해, 지정한 파라미터로 초기화되는 지정한 CertStore를 구현하는 CertStore 객체를 리턴합니다.
static CertStore	getInstance (String type, CertStoreParameters params, String provider) 지정한 프로바이더가 제공해, 지정한 파라미터로 초기화되는 지정한 CertStore를 구현하는 CertStore 객체를 리턴합니다.
Provider	getProvider () 이 CertStore 프로바이더를 리턴합니다.
String	getType () 이 CertStore 형태를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

CertStore

protected CertStore(CertStoreSpi  storeSpi,
                    Provider  provider,
                    String  type,
                    CertStoreParameters  params)

지정된 형태의 CertStore 객체를 작성해, 지정된 프로바이더의 구현 (SPI 객체)을 거기에 캡슐화합니다.

파라미터:

storeSpi - 프로바이더의 구현

provider - 프로바이더

type - 타입

params - 초기화 파라미터. null도 가능

메서드의 상세

getCertificates

public final Collection <?  extends Certificate > getCertificates(CertSelector  selector)
                                                        throws CertStoreException 

지정한 셀렉터에 일치하는 Certificate Collection을 리턴합니다. 셀렉터에 일치하는 Certificate가 없는 경우는 비어있는 Collection가 리턴됩니다 .

CertStore 형태에 따라서는 셀렉터에 일치하는 Certificate 모든 것이 결과의 Collection에 포함되지 않는 것이 있습니다. 예를 들어 LDAP CertStore에 서는 디렉토리내의 모든 엔트리를 검색하지 않습니다. 대신에 검색하는 Certificate가 포함된다고 생각되는 엔트리에 좁혀 검색합니다.

CertStore 안에는 인증서를 찾아내기 위한 특정의 조건을 포함한 비 null CertSelector가 제공되지 않는 한, CertStoreException을 Throw 하는 것이 있습니다 (특히 LDAP CertStore). 발행자나 피인증자의 이름은 특별히 도움이 되는 조건이 됩니다.

파라미터:

selector - 리턴된 Certificate를 선택하기 위해서 이용하는 CertSelector. null을 지정하면, 지원 되고 있는 경우는 모든 Certificate를 돌려준다

반환값:

지정한 셀렉터에 일치하는 Certificate Collection. null은 되지 않는다

예외:

CertStoreException - 예외가 발생하는 경우

getCRLs

public final Collection <?  extends CRL > getCRLs(CRLSelector  selector)
                                        throws CertStoreException 

지정한 셀렉터에 일치하는 CRL Collection을 리턴합니다. 셀렉터에 일치하는 CRL가 없는 경우는 비어있는 Collection가 리턴됩니다 .

CertStore 형태에 따라서는 셀렉터에 일치하는 CRL 모든 것이 결과의 Collection에 포함되지 않는 것이 있습니다. 예를 들어 LDAP CertStore에 서는 디렉토리내의 모든 엔트리를 검색하지 않습니다. 대신에 검색하는 CRL가 포함된다고 생각되는 엔트리에 좁혀 검색합니다.

CertStore 안에는 인증서를 찾아내기 위한 특정의 조건을 포함한 비 null CRLSelector가 제공되지 않는 한, CertStoreException을 Throw 하는 것이 있습니다 (특히 LDAP CertStore). 발행자의 이름이나 체크 대상의 인증서는 특별히 도움이 됩니다.

파라미터:

selector - 리턴된 CRL를 선택하기 위해서 이용하는 CRLSelector. null을 지정하면, 지원 되고 있는 경우는 모든 CRL를 돌려준다

반환값:

지정한 셀렉터에 일치하는 CRL Collection. null은 되지 않는다

예외:

CertStoreException - 예외가 발생하는 경우

getInstance

public static CertStore  getInstance(String  type,
                                    CertStoreParameters  params)
                             throws InvalidAlgorithmParameterException,

                                    NoSuchAlgorithmException 

지정한 CertStore 형을 구현해, 지정한 파라미터로 초기화되는 CertStore를 리턴합니다.

지정한 CertStore 형의 구현을 디폴트의 프로바이더 패키지가 제공하고 있는 경우는 그 구현을 포함한 CertStore 인스턴스가 리턴됩니다 . 디폴트 패키지로 목적의 형태가 제공되어 있지 않은 경우에는 다른 패키지가 검색됩니다.

리턴된 CertStore는 지정된 CertStoreParameters로 초기화됩니다. 필요한 파라미터의 형태는 CertStore 형태에 따라서 다릅니다. CertStoreParameters 객체의 복제를 지정하고 있는 것에 주의해 주세요.

파라미터:

type - 요구한 CertStore 형의 이름

params - 초기화 파라미터. null도 가능

반환값:

지정한 CertStore 형을 구현하는 CertStore 객체

예외:

NoSuchAlgorithmException - 요구되는 형태가 디폴트의 프로바이더 패키지에도, 검색한 것 외의 프로바이더 패키지에도 없는 경우

InvalidAlgorithmParameterException - 지정된 초기화 파라미터가 이 CertStore에 대해서 부적절한 경우

getInstance

public static CertStore  getInstance(String  type,
                                    CertStoreParameters  params,
                                    String  provider)
                             throws InvalidAlgorithmParameterException,

                                    NoSuchAlgorithmException,

                                    NoSuchProviderException 

지정한 프로바이더가 제공해, 지정한 파라미터로 초기화되는 지정한 CertStore를 구현하는 CertStore 객체를 리턴합니다.

리턴된 CertStore는 지정된 CertStoreParameters로 초기화됩니다. 필요한 파라미터의 형태는 CertStore 형태에 따라서 다릅니다. CertStoreParameters 객체의 복제를 지정하고 있는 것에 주의해 주세요.

파라미터:

type - 요구된 CertStore 형

params - 초기화 파라미터. null도 가능

provider - 프로바이더명

반환값:

지정한 프로바이더가 제공하는 지정한 형태를 구현하는 CertStore 객체

예외:

NoSuchAlgorithmException - 지정된 프로바이더에 요구한 형태가 없는 경우

InvalidAlgorithmParameterException - 지정된 초기화 파라미터가 이 CertStore에 대해서 부적절한 경우

NoSuchProviderException - 프로바이더가 설정되어 있지 않은 경우

IllegalArgumentException - provider가 null인 경우

getInstance

public static CertStore  getInstance(String  type,
                                    CertStoreParameters  params,
                                    Provider  provider)
                             throws NoSuchAlgorithmException,

                                    InvalidAlgorithmParameterException 

지정한 프로바이더가 제공해, 지정한 파라미터로 초기화되는 지정한 CertStore를 구현하는 CertStore 객체를 리턴합니다. 주: provider는 등록되어 있을 필요는 없습니다.

리턴된 CertStore는 지정된 CertStoreParameters로 초기화됩니다. 필요한 파라미터의 형태는 CertStore 형태에 따라서 다릅니다. CertStoreParameters 객체의 복제를 지정하고 있는 것에 주의해 주세요.

파라미터:

type - 요구된 CertStore 형

params - 초기화 파라미터. null도 가능

provider - 프로바이더

반환값:

지정한 프로바이더가 제공하는 지정한 형태를 구현하는 CertStore 객체

예외:

NoSuchAlgorithmException - 지정된 프로바이더에 요구한 형태가 없는 경우

InvalidAlgorithmParameterException - 지정된 초기화 파라미터가 이 CertStore에 대해서 부적절한 경우

IllegalArgumentException - provider가 null인 경우

getCertStoreParameters

public final CertStoreParameters  getCertStoreParameters()

CertStore를 초기화하기 위한 파라미터를 리턴합니다. 돌려주고지기 전의 CertStoreParameters객체는 복제입니다.

반환값:

이 CertStore를 초기화하는 파라미터. null도 가능

getType

public final String  getType()

이 CertStore 형태를 리턴합니다.

반환값:

이 CertStore 형태

getProvider

public final Provider  getProvider()

이 CertStore 프로바이더를 리턴합니다.

반환값:

이 CertStore 프로바이더

getDefaultType

public static final String  getDefaultType()

Java 시큐러티 프로퍼티 파일로 가리키는 디폴트의 CertStore 형을 리턴합니다. 디폴트의 CertStore 형을 나타내는 프로퍼티가 없는 경우는 캐릭터 라인 「LDAP」를 리턴합니다. Java 시큐러티 프로퍼티 파일은 <JAVA_HOME>/lib/security/java.security 라고 하는 파일에 있습니다. <JAVA_HOME>는 JDK가 인스톨 되고 있는 디렉토리입니다.

디폴트의 CertStore 형을 사용하는 것은 어플리케이션으로 getInstance 메서드를 호출할 때 하드 코드 된 형태를 사용하지 않는 경우 및 사용자가 독자적인 형태를 지정하지 않을 때에 디폴트의 CertStore 형을 제공하는 경우입니다.

디폴트의 CertStore 형을 변경하려면, Java 시큐러티 프로퍼티 파일의 certstore.type 시큐러티 프로퍼티의 값을 목적의 형태로 설정합니다.

반환값:

Java 시큐러티 프로퍼티 파일로 지정된 디폴트의 CertStore 형. 프로퍼티가 존재하지 않는 경우는 캐릭터 라인 「LDAP」