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 kr 이상의 디렉토리에 저장된 증명서와 CRL 에 액세스 할 수 있습니다. 표준의 CertStore 형의 상세한 것에 대하여는 「Java Certification Path API Programmer's Guide 」의 부록 A 를 참조해 주세요.

병행 액세스

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

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

도입된 버젼:

1.4

생성자의 개요

protected

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

메소드의 개요

Collection	getCertificates (CertSelector selector) 지정한 실렉터에 일치하는 Certificate 의 Collection 를 돌려줍니다.
CertStoreParameters	getCertStoreParameters () CertStore 를 초기화하기 위한 파라미터를 돌려줍니다.
Collection	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  getCertificates(CertSelector  selector)
                                 throws CertStoreException 

지정한 실렉터에 일치하는 Certificate 의 Collection 를 돌려줍니다. 실렉터에 일치하는 Certificate 가 없는 경우는 하늘의 Collection 가 돌려주어집니다.

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

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

파라미터:

selector - 돌려주어지는 Certificate 를 선택하기 위해서 이용하는 CertSelector. null 를 지정하면(자), 서포트되고 있는 경우는 모든 Certificate 를 돌려줍니다.

반환값:

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

예외:

CertStoreException - 예외가 발생하는 경우

getCRLs

public final Collection  getCRLs(CRLSelector  selector)
                         throws CertStoreException 

지정한 실렉터에 일치하는 CRL 의 Collection 를 돌려줍니다. 실렉터에 일치하는 CRL 가 없는 경우는 하늘의 Collection 가 돌려주어집니다.

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

CertStore 안에는 증명서를 찾아내기 위한 특정의 조건을 포함한 비 null 의 CRLSelector 가 제공되지 않는 이상CertStoreException 를 슬로우 하는 것이 있습니다 (특히 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> 는 SDK 가 인스톨 되고 있는 디렉토리입니다.

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

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

반환값:

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