java.security
클래스 KeyStore

java.lang.Object 
  java.security.KeyStore

public class KeyStore
extends Object 

이 클래스는 암호화의 키와 인증서 의 포함 장소를 표현한 것입니다.

KeyStore는 다른 형태의 엔트리를 관리합니다. 개개의 엔트리형은 KeyStore.Entry인터페이스를 구현합니다. 다음의 3개의 기본 KeyStore.Entry 구현이 제공되고 있습니다.

• KeyStore.PrivateKeyEntry

  이 형태의 엔트리에는 암호화 PrivateKey가 포함됩니다. 허가되지 않는 액세스를 막기 위해서 보호 형식에서 포함할 수 있게 되어 있습니다. 또, 대응하는 공개키의 증명 연쇄도 함께 포함됩니다.

  비공개키와 증명 연쇄는 지정된 엔티티에 의해 자신의 인증을 위해서 사용됩니다. 이 인증이 이용되는 것은 소프트웨어 배포 조직이 소프트웨어의 릴리스나 라이센스 공여의 일관으로서 JAR 파일에 서명하는 경우 등입니다.

• KeyStore.SecretKeyEntry

  이 형태의 엔트리에는 암호화 SecretKey가 포함됩니다. 덧붙여 허가되지 않는 액세스를 막기 위해서 보호 형식에서 포함할 수 있게 되어 있습니다.

• KeyStore.TrustedCertificateEntry

  이 형태의 엔트리에는 다른 조직에 속하는 단일의 공개키 Certificate가 포함됩니다. 이것이 「신뢰할 수 있는 인증서 」라고 불리는 이유는 인증서에 포함되어 있는 공개키가 실제로 인증서 의 「피인증자」(소유자) 란에 기재되어 있는자식 덴티티의 것임을 키스토어 의 소유자가 신용하고 있기 때문입니다.

  이 형태의 엔트리는 다른 조직의 인증에 사용할 수 있습니다.

키스토어 내의 각 엔트리는 「별명」캐릭터 라인에 의해 식별됩니다. 비공개키와 거기에 관련된 증명 연쇄의 경우, 이러한 캐릭터 라인에의해 엔티티가 자신을 인증하는 다양한 방법이 구별됩니다. 예를 들어 엔티티는 자신을 인증할 때에 다른 인증서 발행국을 사용하거나 다른 공개키 알고리즘을 사용하거나 할 수 있습니다.

키스토어가 지속성이 있을지 어떨지 및 지속성이 있는 경우에 사용되는 도구는 여기에서는 지정되지 않습니다. 이것에 의해 중요한 (비밀 또는 비공개) 키를 보호하기 위한 다양한 기술을 사용할 수 있습니다. 스마트 카드 또는 그 외의 통합 암호화 엔진 (SafeKeyper)을 사용하는 일도 1개의 방법입니다. 또, 파일등의 보다 단순한 도구를 다양한 형식에서 사용할 수도 있습니다.

KeyStore 객체를 요구하는 전형적인 방법으로서는 디폴트의 형태를 이용하는 방법과 특정의 키스토어 형을 지정하는 방법이 있습니다.

• 디폴트의 형태를 이용하려면, 다음과 같이 합니다.

  
      KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());
   

  시스템은 디폴트형의 키스토어 구현을 리턴합니다.

• 특정의 키스토어 형을 지정하려면, 다음과 같이 합니다.

  
        KeyStore ks = KeyStore.getInstance("JKS");
   

  시스템은 환경내에서 이용 가능한 구현 가운데, 지정된 키스토어 형에 가장 적합한 것을 리턴합니다.

특정의 키스토어에 액세스 할 수 있도록 하려면, 그 키스토어를로드 할 필요가 있습니다.

    KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());

    // get user password and file input stream
    char[] password = getPassword();
    java.io.FileInputStream fis =
        new java.io.FileInputStream("keyStoreName");
    ks.load(fis, password);
    fis.close();
 

상기의 load 메서드를 사용해 비어있는 키스토어를 작성하려면, InputStream인수로서 null을 건네줍니다.

키스토어 의 로드가 완료하면, 기존의 엔트리를 키스토어 로부터 읽어내거나 새로운 엔트리를 키스토어에 출력하거나 할 수 있습니다.

    // get my private key
    KeyStore.PrivateKeyEntry pkEntry = (KeyStore.PrivateKeyEntry)
        ks.getEntry("privateKeyAlias", password);
    PrivateKey myPrivateKey = pkEntry.getPrivateKey();

    // save my secret key
    javax.crypto.SecretKey mySecretKey;
    KeyStore.SecretKeyEntry skEntry =
        new KeyStore.SecretKeyEntry(mySecretKey);
    ks.setEntry("secretKeyAlias", skEntry, password);

    // store away the keystore
    java.io.FileOutputStream fos =
        new java.io.FileOutputStream("newKeyStoreName");
    ks.store(fos, password);
    fos.close();
 

덧붙여 상기 샘플 코드로 가리킨 것처럼, 키스토어 의 로드, 비공개키 엔트리의 보호, 비밀키 엔트리의 보호 및 키스토어 의 포함에는 같은 패스워드를 사용할 수 있습니다만, 다른 패스워드나 그 외의 보호 파라미터도 사용할 수 있습니다.

도입된 버전 :

1.2

관련 항목:

PrivateKey, SecretKey, Certificate

중첩(Nested) 클래스 개요

static class	KeyStore.Builder 인스턴스화 해야 할 KeyStore 객체를 기술한 클래스입니다.
static class	KeyStore.CallbackHandlerProtection CallbackHandler를 캡슐화한 ProtectionParameter 입니다.
static interface	KeyStore.Entry KeyStore 엔트리의 종류에 대한 마커 인터페이스입니다.
static interface	KeyStore.LoadStoreParameter KeyStore load 파라미터와 store 파라미터에 대한 마커 인터페이스입니다.
static class	KeyStore.PasswordProtection ProtectionParameter 패스워드 베이스의 구현입니다.
static class	KeyStore.PrivateKeyEntry 특정의 PrivateKey와 대응하는 증명 연쇄가 포함된 KeyStore 엔트리입니다.
static interface	KeyStore.ProtectionParameter 키스토어 의 보호 파라미터에 대한 마커 인터페이스입니다.
static class	KeyStore.SecretKeyEntry 특정의 SecretKey가 포함된 KeyStore 엔트리입니다.
static class	KeyStore.TrustedCertificateEntry 신뢰할 수 있는 Certificate가 포함된 KeyStore 엔트리입니다.

생성자 개요

protected

KeyStore (KeyStoreSpi keyStoreSpi, Provider provider, String type) 지정된 형태의 KeyStore 객체를 작성해, 그 객체로 지정된 프로바이더의 구현인 SPI 객체를 캡슐화합니다.

메서드 개요

Enumeration <String >	aliases () 이 키스토어 의 모든 별명을 일람표 가리킵니다.
boolean	containsAlias (String alias) 이 키스토어에 지정된 별명이 존재할지 어떨지를 판정합니다.
void	deleteEntry (String alias) 이 키스토어 로부터, 지정된 별명에 의해 식별되는 엔트리를 삭제합니다.
boolean	entryInstanceOf (String alias, Class <? extends KeyStore.Entry > entryClass) 지정된 alias 키스토어 Entry가 지정된 entryClass 인스턴스 또는 서브 클래스일지 어떨지를 판정합니다.
Certificate	getCertificate (String alias) 지정된 별명에 관련된 인증서를 리턴합니다.
String	getCertificateAlias (Certificate cert) 지정된 인증서와 일치하는 인증서가 있는 최초의 키스토어 엔트리의 별명을 리턴합니다.
Certificate []	getCertificateChain (String alias) 지정된 별명에 관련된 증명 연쇄를 리턴합니다.
Date	getCreationDate (String alias) 지정된 별명에 의해 식별되는 엔트리의 작성일을 리턴합니다.
static String	getDefaultType () Java 시큐러티 프로퍼티 파일로 가리키는 디폴트의 키스토어 형을 리턴합니다.
KeyStore.Entry	getEntry (String alias, KeyStore.ProtectionParameter protParam) 지정된 보호 파라미터를 사용해, 지정된 별명에 대한 키스토어 Entry를 취득합니다.
static KeyStore	getInstance (String type) 지정된 형태의 키스토어 오브제크트를 작성합니다.
static KeyStore	getInstance (String type, Provider provider) 지정된 프로바이더로부터, 지정된 키스토어 형의 키스토어 오브제크트를 생성합니다.
static KeyStore	getInstance (String type, String provider) 지정된 프로바이더로부터, 지정된 키스토어 형의 키스토어 오브제크트를 작성합니다.
Key	getKey (String alias, char[] password) 지정된 패스워드를 사용해, 지정된 별명에 관련된 키를 복원해, 그 키를 리턴합니다.
Provider	getProvider () 이 키스토어 의 프로바이더를 리턴합니다.
String	getType () 이 키스토어 의 형태를 리턴합니다.
boolean	isCertificateEntry (String alias) 지정된 별명으로 식별되는 엔트리가setCertificateEntry를 호출해 작성된 엔트리, 혹은 TrustedCertificateEntry를 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, true를 리턴합니다.
boolean	isKeyEntry (String alias) 지정된 별명으로 식별되는 엔트리가setKeyEntry를 호출해 작성된 엔트리, 혹은 PrivateKeyEntry 또는 SecretKeyEntry을 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, true를 리턴합니다.
void	load (InputStream stream, char[] password) 지정된 입력 스트림로부터 이 키스토어를 로드합니다.
void	load (KeyStore.LoadStoreParameter param) 지정된 LoadStoreParameter를 사용해 이 키스토어를 로드합니다.
void	setCertificateEntry (String alias, Certificate cert) 지정된 별명에 지정된 신뢰할 수 있는 인증서를 할당합니다.
void	setEntry (String alias, KeyStore.Entry entry, KeyStore.ProtectionParameter protParam) 키스토어 Entry가 지정된 별명으로 저장합니다.
void	setKeyEntry (String alias, byte[] key, Certificate [] chain) 지정된 별명에 이미 보호되고 있는 지정의 키를 할당합니다.
void	setKeyEntry (String alias, Key key, char[] password, Certificate [] chain) 지정된 별명으로 지정된 키를 할당해 지정된 패스워드로 그 키를 보호합니다.
int	size () 이 키스토어 의 엔트리수를 취득합니다.
void	store (KeyStore.LoadStoreParameter param) 지정된 LoadStoreParameter를 사용해 이 키스토어를 포함합니다.
void	store (OutputStream stream, char[] password) 지정된 출력 스트림에 이 키스토어를 포함해, 지정된 패스워드로 그 정합성을 보호합니다.

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

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

생성자 상세

KeyStore

protected KeyStore(KeyStoreSpi  keyStoreSpi,
                   Provider  provider,
                   String  type)

지정된 형태의 KeyStore 객체를 작성해, 그 객체로 지정된 프로바이더의 구현인 SPI 객체를 캡슐화합니다.

파라미터:

keyStoreSpi - 프로바이더의 구현

provider - 프로바이더

type - 키스토어 형

메서드의 상세

getInstance

public static KeyStore  getInstance(String  type)
                            throws KeyStoreException 

지정된 형태의 키스토어 오브제크트를 작성합니다.

지정된 형태의 키스토어 의 구현을 디폴트의 프로바이더 패키지가 제공하는 경우는 그 구현을 포함한 KeyStore 인스턴스가 리턴됩니다 . 디폴트 패키지에 요구되는 키스토어 형이 없는 경우는 다른 패키지를 검색합니다.

파라미터:

type - 키스토어 형. 표준의 키스토어 형에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A를 참조

반환값:

지정된 형태의 키스토어 오브제크트

예외:

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

getInstance

public static KeyStore  getInstance(String  type,
                                   String  provider)
                            throws KeyStoreException,

                                   NoSuchProviderException 

지정된 프로바이더로부터, 지정된 키스토어 형의 키스토어 오브제크트를 작성합니다.

파라미터:

type - 키스토어 형. 표준의 키스토어 형에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A를 참조

provider - 프로바이더명

반환값:

지정된 프로바이더가 제공하는 지정된 형태의 키스토어 오브제크트

예외:

KeyStoreException - 프로바이더에 요구된 키스토어 형이 없는 경우

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

IllegalArgumentException - 프로바이더의 이름이 null 나 비어있는 경우

관련 항목:

Provider

getInstance

public static KeyStore  getInstance(String  type,
                                   Provider  provider)
                            throws KeyStoreException 

지정된 프로바이더로부터, 지정된 키스토어 형의 키스토어 오브제크트를 생성합니다. 주: provider는 등록되어 있을 필요는 없습니다.

파라미터:

type - 키스토어 형. 표준의 키스토어 형에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A를 참조

provider - 프로바이더

반환값:

지정된 프로바이더가 제공하는 지정된 형태의 키스토어 오브제크트

예외:

KeyStoreException - 프로바이더에 요구된 키스토어 형이 없는 경우

IllegalArgumentException - provider가 null인 경우

도입된 버전 :

1.4

관련 항목:

Provider

getDefaultType

public static final String  getDefaultType()

Java 시큐러티 프로퍼티 파일로 가리키는 디폴트의 키스토어 형을 리턴합니다. 다만, 그러한 프로퍼티가 존재하지 않는 경우는 「jks」(Java keystore 약어)이라고 하는 캐릭터 라인을 리턴합니다. Java 시큐러티 프로퍼티는 <JAVA_HOME>/lib/security/java.security 라고 하는 파일내에 포함되어 있습니다. 여기서, <JAVA_HOME>는 JDK 인스톨처 디렉토리입니다.

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

디폴트의 키스토어 형을 변경하려면, Java 시큐러티 프로퍼티 파일의 keystore.type 시큐러티 프로퍼티의 값을 목적의 키스토어 형으로 설정합니다.

반환값:

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

getProvider

public final Provider  getProvider()

이 키스토어 의 프로바이더를 리턴합니다.

반환값:

이 키스토어 의 프로바이더

getType

public final String  getType()

이 키스토어 의 형태를 리턴합니다.

반환값:

이 키스토어 의 형태

getKey

public final Key  getKey(String  alias,
                        char[] password)
                 throws KeyStoreException,

                        NoSuchAlgorithmException,

                        UnrecoverableKeyException 

지정된 패스워드를 사용해, 지정된 별명에 관련된 키를 복원해, 그 키를 리턴합니다. 이 키는 setKeyEntry를 호출하든가 혹은 PrivateKeyEntry 또는 SecretKeyEntry를 지정해 setEntry를 호출하는 것으로 그 별명에 관련지을 수 있고 있을 필요가 있습니다.

파라미터:

alias - 별명

password - 키를 복원하기 위한 패스워드

반환값:

요구되는 키. 지정된 별명이 존재하지 않는지, 키 관련 엔트리를 식별하지 않는 경우는 null

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

NoSuchAlgorithmException - 키를 복원하기 위한 알고리즘이 발견되지 않는 경우

UnrecoverableKeyException - 지정된 패스워드가 잘못되어 있는 경우 등, 키를 복원할 수 없는 경우

getCertificateChain

public final Certificate [] getCertificateChain(String  alias)
                                        throws KeyStoreException 

지정된 별명에 관련된 증명 연쇄를 리턴합니다. 이 증명 연쇄는 setKeyEntry를 호출하든가 혹은 PrivateKeyEntry를 지정해 setEntry를 호출하는 것으로 별명에 관련지을 수 있고 있을 필요가 있습니다.

파라미터:

alias - 별명

반환값:

증명 연쇄. 차례는 사용자 인증서가 최초로 루트 인증서 발행국이 최후. 지정된 별명이 존재하지 않는지, 증명 연쇄를 포함하지 않은 경우는 null

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

getCertificate

public final Certificate  getCertificate(String  alias)
                                 throws KeyStoreException 

지정된 별명에 관련된 인증서를 리턴합니다.

지정된 별명에 의해 식별되는 엔트리가setCertificateEntry를 호출해 작성된 엔트리, 혹은 TrustedCertificateEntry를 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, 그 엔트리내에 포함되고 있는 신뢰할 수 있는 인증서가 리턴됩니다 .

지정된 별명에 의해 식별되는 엔트리가setKeyEntry를 호출해 작성된 엔트리, 혹은 PrivateKeyEntry를 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, 그 엔트리내의 증명 연쇄의 최초의 요소가 리턴됩니다 .

파라미터:

alias - 별명

반환값:

인증서. 지정된 별명이 존재하지 않는지, 또는 인증서를 포함하지 않는 경우는 null

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

getCreationDate

public final Date  getCreationDate(String  alias)
                           throws KeyStoreException 

지정된 별명에 의해 식별되는 엔트리의 작성일을 리턴합니다.

파라미터:

alias - 별명

반환값:

이 엔트리의 작성일. 지정된 별명이 존재하지 않는 경우는 null

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

setKeyEntry

public final void setKeyEntry(String  alias,
                              Key  key,
                              char[] password,
                              Certificate [] chain)
                       throws KeyStoreException 

지정된 별명으로 지정된 키를 할당해 지정된 패스워드로 그 키를 보호합니다.

지정된 키가 java.security.PrivateKey 형인 경우, 대응하는 공개키를 증명하는 증명 연쇄도 지정할 필요가 있습니다.

지정된 별명이 이미 존재하는 경우는 거기에 관련한 키스토어 정보는 지정된 키와 증명 연쇄에 의해 오버라이드(override) 됩니다.

파라미터:

alias - 별명

key - 별명에 관련짓는 키

password - 키를 보호하기 위한 패스워드

chain - 대응하는 공개키의 증명 연쇄. 지정된 키가 java.security.PrivateKey 형인 경우에만 필요

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우, 지정된 키를 보호할 수 없는 경우, 혹은 이 처리가 다른 원인으로 실패했을 경우

setKeyEntry

public final void setKeyEntry(String  alias,
                              byte[] key,
                              Certificate [] chain)
                       throws KeyStoreException 

지정된 별명에 이미 보호되고 있는 지정의 키를 할당합니다.

보호된 키가 java.security.PrivateKey 형인 경우, 대응하는 공개키를 증명하는 증명 연쇄도 지정할 필요가 있습니다. 기본이 되는 키스토어 의 구현의 형태가 jks인 경우, key는 PKCS #8 표준의 정의에 따라 EncryptedPrivateKeyInfo로 서 encode 되고 있을 필요가 있습니다.

지정된 별명이 이미 존재하는 경우는 거기에 관련한 키스토어 정보는 지정된 키와 증명 연쇄에 의해 오버라이드(override) 됩니다.

파라미터:

alias - 별명

key - 별명에 관련짓는 보호 형식의 키

chain - 보호된 키가 java.security.PrivateKey 형인 경우에만 유효한 대응하는 공개키의 증명 연쇄

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우, 또는 이 처리가 다른 원인으로 실패했을 경우

setCertificateEntry

public final void setCertificateEntry(String  alias,
                                      Certificate  cert)
                               throws KeyStoreException 

지정된 별명에 지정된 신뢰할 수 있는 인증서를 할당합니다.

지정된 별명에 의해 식별되는 엔트리가setCertificateEntry를 호출해 작성된 기존 엔트리, 혹은 TrustedCertificateEntry를 지정해 setEntry를 호출해 작성된 기존 엔트리의 언젠가인 경우, 그 기존 엔트리내에 포함되고 있는 신뢰할 수 있는 인증서가 지정된 인증서 로 덧쓰기됩니다.

파라미터:

alias - 별명

cert - 인증서

예외:

KeyStoreException - 키스토어가 초기화되어 있지 않은 경우, 지정된 별명이 이미 존재하고 있어도 거기에 따라 식별되는 엔트리를 신뢰할 수 있는 인증서를 포함하지 않은 경우, 혹은 이 처리가 다른 원인으로 실패했을 경우

deleteEntry

public final void deleteEntry(String  alias)
                       throws KeyStoreException 

이 키스토어 로부터, 지정된 별명에 의해 식별되는 엔트리를 삭제합니다.

파라미터:

alias - 별명

예외:

KeyStoreException - 키스토어가 초기화되어 있지 않은 경우, 혹은 엔트리를 삭제할 수 없는 경우

aliases

public final Enumeration <String > aliases()
                                  throws KeyStoreException 

이 키스토어 의 모든 별명을 일람표 가리킵니다.

반환값:

별명의 열거

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

containsAlias

public final boolean containsAlias(String  alias)
                            throws KeyStoreException 

이 키스토어에 지정된 별명이 존재할지 어떨지를 판정합니다.

파라미터:

alias - 별명

반환값:

별명이 존재하는 경우는 true, 그렇지 않은 경우는 false

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

size

public final int size()
               throws KeyStoreException 

이 키스토어 의 엔트리수를 취득합니다.

반환값:

이 키스토어 의 엔트리수

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

isKeyEntry

public final boolean isKeyEntry(String  alias)
                         throws KeyStoreException 

지정된 별명으로 식별되는 엔트리가setKeyEntry를 호출해 작성된 엔트리, 혹은 PrivateKeyEntry 또는 SecretKeyEntry을 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, true를 리턴합니다.

파라미터:

alias - 판정 대상이 되는 키스토어 엔트리의 별명

반환값:

지정된 별명으로 식별되는 엔트리가 키 관련 엔트리인 경우는 true, 그렇지 않은 경우는 false

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

isCertificateEntry

public final boolean isCertificateEntry(String  alias)
                                 throws KeyStoreException 

지정된 별명으로 식별되는 엔트리가setCertificateEntry를 호출해 작성된 엔트리, 혹은 TrustedCertificateEntry를 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, true를 리턴합니다.

파라미터:

alias - 판정 대상이 되는 키스토어 엔트리의 별명

반환값:

지정된 별명으로 식별되는 엔트리에 신뢰할 수 있는 인증서 엔트리가 포함되어 있는 경우는 true, 그렇지 않은 경우는 false

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

getCertificateAlias

public final String  getCertificateAlias(Certificate  cert)
                                 throws KeyStoreException 

지정된 인증서와 일치하는 인증서가 있는 최초의 키스토어 엔트리의 별명을 리턴합니다.

이 메서드는 지정된 인증서를 각 키스토어 엔트리와 조합합니다. 처리 대상의 엔트리가setCertificateEntry를 호출해 작성된 엔트리, 혹은 TrustedCertificateEntry를 지정해 setEntry를 호출해 작성된 엔트리인 경우, 지정된 인증서는 그 엔트리의 인증서 라고 비교됩니다.

처리 대상의 엔트리가setKeyEntry를 호출해 작성된 엔트리, 혹은PrivateKeyEntry를 지정해 setEntry를 호출해 작성된 엔트리인 경우, 지정된 인증서는 그 엔트리의 증명 연쇄의 최초의 요소라고 비교됩니다.

파라미터:

cert - 조합하는 인증서

반환값:

일치하는 인증서를 포함한 최초의 엔트리의 별명. 그러한 엔트리가 이 키스토어에 존재하지 않는 경우는 null

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

store

public final void store(OutputStream  stream,
                        char[] password)
                 throws KeyStoreException,

                        IOException,

                        NoSuchAlgorithmException,

                        CertificateException 

지정된 출력 스트림에 이 키스토어를 포함해, 지정된 패스워드로 그 정합성을 보호합니다.

파라미터:

stream - 이 키스토어를 출력하는 출력 스트림

password - 키스토어 의 정합성을 검사하기 위한 패스워드

예외:

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

IOException - 데이터에 입출력의 문제가 있었을 경우

NoSuchAlgorithmException - 적절한 데이터 정합성 알고리즘이 발견되지 않았던 경우

CertificateException - 키스토어 데이타에 포함되는 어느 인증서 도 포함할 수 없었던 경우

store

public final void store(KeyStore.LoadStoreParameter  param)
                 throws KeyStoreException,

                        IOException,

                        NoSuchAlgorithmException,

                        CertificateException 

지정된 LoadStoreParameter를 사용해 이 키스토어를 포함합니다.

파라미터:

param - 키스토어 의 포함 방법을 지정한 LoadStoreParameter. null도 지정 가능

예외:

IllegalArgumentException - 지정된 LoadStoreParameter 입력이 인식되지 않는 경우

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

IOException - 데이터에 입출력의 문제가 있었을 경우

NoSuchAlgorithmException - 적절한 데이터 정합성 알고리즘이 발견되지 않았던 경우

CertificateException - 키스토어 데이타에 포함되는 어느 인증서 도 포함할 수 없었던 경우

도입된 버전 :

1.5

load

public final void load(InputStream  stream,
                       char[] password)
                throws IOException,

                       NoSuchAlgorithmException,

                       CertificateException 

지정된 입력 스트림로부터 이 키스토어를 로드합니다.

패스워드를 지정하면, 키스토어가 하드웨어 토큰 디바이스상에 존재하는 경우 등에 키스토어 의 락 해제나 키스토어 데이타의 완전성 검사를 할 수 있습니다. 완전성 검사용의 패스워드가 지정되지 않았던 경우, 완전성 검사는 실행되지 않습니다.

비어있는 키스토어를 작성하는 경우, 혹은 키스토어를 스트림로부터 초기화할 수 없는 경우는 stream인수로서 null을 건네줍니다.

이 키스토어가 이미 로드 되고 있는 경우, 이 키스토어는 다시 초기화되어 지정된 스트림로부터 다시 로드합니다.

파라미터:

stream - 키스토어 의 로드원의 입력 스트림 또는 null

password - 키스토어 의 완전성 검사용 패스워드, 키스토어 의 락 해제용 패스워드, 또는 null

예외:

IOException - 키스토어 데이타로 입출력 또는 형식에 관한 문제가 발생했을 경우, 패스워드가 필요해요로 지정되지 않았던 경우, 혹은 지정된 패스워드가 잘못되어 있는 경우

NoSuchAlgorithmException - 키스토어 의 정합성을 검사하는 알고리즘이 발견되지 않았던 경우

CertificateException - 키스토어 의 어느 인증서 도 로드할 수 없었던 경우

load

public final void load(KeyStore.LoadStoreParameter  param)
                throws IOException,

                       NoSuchAlgorithmException,

                       CertificateException 

지정된 LoadStoreParameter를 사용해 이 키스토어를 로드합니다.

이 키스토어가 이미 로드 되고 있는 경우, 이 키스토어는 다시 초기화되어 지정된 스트림로부터 다시 로드합니다.

파라미터:

param - 키스토어 의 로드 방법을 지정한 LoadStoreParameter. null도 지정 가능

예외:

IllegalArgumentException - 지정된 LoadStoreParameter 입력이 인식되지 않는 경우

IOException - 키스토어 데이타에 입출력 또는 형식의 문제가 있었을 경우

NoSuchAlgorithmException - 키스토어 의 정합성을 검사하는 알고리즘이 발견되지 않았던 경우

CertificateException - 키스토어 의 어느 인증서 도 로드할 수 없었던 경우

도입된 버전 :

1.5

getEntry

public final KeyStore.Entry  getEntry(String  alias,
                                     KeyStore.ProtectionParameter  protParam)
                              throws NoSuchAlgorithmException,

                                     UnrecoverableEntryException,

                                     KeyStoreException 

지정된 보호 파라미터를 사용해, 지정된 별명에 대한 키스토어 Entry를 취득합니다.

파라미터:

alias - 이 별명에 대한 키스토어 Entry를 취득

protParam - Entry 보호에 사용되는 ProtectionParameter. null도 지정 가능

반환값:

지정된 별명에 대한 키스토어 Entry. 그러한 엔트리가 존재하지 않는 경우는 null

예외:

NullPointerException - alias가 null인 경우

NoSuchAlgorithmException - 엔트리를 복원하기 위한 알고리즘이 발견되지 않는 경우

UnrecoverableEntryException - 지정된 protParam가 불충분 또는 무효인 경우

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

도입된 버전 :

1.5

관련 항목:

setEntry(String, KeyStore.Entry, KeyStore.ProtectionParameter)

setEntry

public final void setEntry(String  alias,
                           KeyStore.Entry  entry,
                           KeyStore.ProtectionParameter  protParam)
                    throws KeyStoreException 

키스토어 Entry가 지정된 별명으로 저장합니다. 보호 파라미터는 Entry를 보호하기 위해서 사용됩니다.

지정된 별명의 엔트리가 이미 존재하는 경우, 그 엔트리는 덧쓰기됩니다.

파라미터:

alias - 이 별명으로 키스토어 Entry를 보존

entry - 보의존된 Entry

protParam - Entry 보호에 사용되는 ProtectionParameter. null도 지정 가능

예외:

NullPointerException - alias 또는 entry가 null인 경우

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우, 혹은 이 처리가 다른 원인으로 실패했을 경우

도입된 버전 :

1.5

관련 항목:

getEntry(String, KeyStore.ProtectionParameter)

entryInstanceOf

public final boolean entryInstanceOf(String  alias,
                                     Class <?  extends KeyStore.Entry > entryClass)
                              throws KeyStoreException 

지정된 alias 키스토어 Entry가 지정된 entryClass 인스턴스 또는 서브 클래스일지 어떨지를 판정합니다.

파라미터:

alias - 별명

entryClass - 엔트리 클래스

반환값:

지정된 alias 키스토어 Entry가 지정된 entryClass 인스턴스 또는 서브 클래스인 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - alias 또는 entryClass가 null인 경우

KeyStoreException - 키스토어가 초기화 (로드)되어 있지 않은 경우

도입된 버전 :

1.5