java.security
클래스 KeyStoreSpi

java.lang.Object 
  java.security.KeyStoreSpi

public abstract class KeyStoreSpi
extends Object 

이 클래스는 KeyStore 클래스의 Service Provider Interface (SPI)를 정의합니다. 특정의 키스토어 형의 키스토어 의 구현을 제공하는 각 암호 서비스 프로바이더는 이 클래스의 모든 추상 메서드를 구현할 필요가 있습니다.

도입된 버전 :

1.2

관련 항목:

KeyStore

생성자 개요

KeyStoreSpi ()

메서드 개요

abstract Enumeration <String >	engineAliases () 이 키스토어 의 모든 별명을 일람표 가리킵니다.
abstract boolean	engineContainsAlias (String alias) 이 키스토어에 지정된 별명이 존재할지 어떨지를 판정합니다.
abstract void	engineDeleteEntry (String alias) 이 키스토어 로부터, 지정된 별명에 의해 식별되는 엔트리를 삭제합니다.
boolean	engineEntryInstanceOf (String alias, Class <? extends KeyStore.Entry > entryClass) 지정된 alias 키스토어 Entry가 지정된 entryClass 인스턴스 또는 서브 클래스일지 어떨지를 판정합니다.
abstract Certificate	engineGetCertificate (String alias) 지정된 별명에 관련된 인증서를 리턴합니다.
abstract String	engineGetCertificateAlias (Certificate cert) 지정된 인증서와 일치하는 인증서가 있는 최초의 키스토어 엔트리의 별명을 리턴합니다.
abstract Certificate []	engineGetCertificateChain (String alias) 지정된 별명에 관련된 증명 연쇄를 리턴합니다.
abstract Date	engineGetCreationDate (String alias) 지정된 별명에 의해 식별되는 엔트리의 작성일을 리턴합니다.
KeyStore.Entry	engineGetEntry (String alias, KeyStore.ProtectionParameter protParam) 지정된 보호 파라미터를 사용해, 지정된 별명에 대한 KeyStore.Entry를 취득합니다.
abstract Key	engineGetKey (String alias, char[] password) 지정된 패스워드를 사용해, 지정된 별명에 관련된 키를 복원해, 그 키를 리턴합니다.
abstract boolean	engineIsCertificateEntry (String alias) 지정된 별명으로 식별되는 엔트리가setCertificateEntry를 호출해 작성된 엔트리, 혹은 TrustedCertificateEntry를 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, true를 리턴합니다.
abstract boolean	engineIsKeyEntry (String alias) 지정된 별명으로 식별되는 엔트리가setKeyEntry를 호출해 작성된 엔트리, 혹은 PrivateKeyEntry 또는 SecretKeyEntry을 지정해 setEntry를 호출해 작성된 엔트리의 언젠가인 경우, true를 리턴합니다.
abstract void	engineLoad (InputStream stream, char[] password) 지정된 입력 스트림로부터 키스토어를 로드합니다.
void	engineLoad (KeyStore.LoadStoreParameter param) 지정된 KeyStore.LoadStoreParameter를 사용해 키스토어를 로드합니다.
abstract void	engineSetCertificateEntry (String alias, Certificate cert) 지정된 별명에 지정된 인증서를 할당합니다.
void	engineSetEntry (String alias, KeyStore.Entry entry, KeyStore.ProtectionParameter protParam) KeyStore.Entry가 지정된 별명으로 저장합니다.
abstract void	engineSetKeyEntry (String alias, byte[] key, Certificate [] chain) 지정된 별명에 이미 보호되고 있는 지정의 키를 할당합니다.
abstract void	engineSetKeyEntry (String alias, Key key, char[] password, Certificate [] chain) 지정된 별명으로 지정된 키를 할당해 지정된 패스워드로 그 키를 보호합니다.
abstract int	engineSize () 이 키스토어 의 엔트리수를 취득합니다.
void	engineStore (KeyStore.LoadStoreParameter param) 지정된 KeyStore.LoadStoreParmeter를 사용해 키스토어를 포함합니다.
abstract void	engineStore (OutputStream stream, char[] password) 지정된 출력 스트림에 이 키스토어를 포함해, 지정된 패스워드로 그 정합성을 보호합니다.

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

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

생성자 상세

KeyStoreSpi

public KeyStoreSpi()

메서드의 상세

engineGetKey

public abstract Key  engineGetKey(String  alias,
                                 char[] password)
                          throws NoSuchAlgorithmException,

                                 UnrecoverableKeyException 

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

파라미터:

alias - 별명

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

반환값:

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

예외:

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

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

engineGetCertificateChain

public abstract Certificate [] engineGetCertificateChain(String  alias)

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

파라미터:

alias - 별명

반환값:

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

engineGetCertificate

public abstract Certificate  engineGetCertificate(String  alias)

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

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

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

파라미터:

alias - 별명

반환값:

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

engineGetCreationDate

public abstract Date  engineGetCreationDate(String  alias)

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

파라미터:

alias - 별명

반환값:

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

engineSetKeyEntry

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

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

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

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

파라미터:

alias - 별명

key - 별명에 관련짓는 키

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

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

예외:

KeyStoreException - 지정된 키를 보호할 수 없는 경우나, 이 처리가 다른 원인으로 실패했을 경우

engineSetKeyEntry

public abstract void engineSetKeyEntry(String  alias,
                                       byte[] key,
                                       Certificate [] chain)
                                throws KeyStoreException 

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

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

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

파라미터:

alias - 별명

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

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

예외:

KeyStoreException - 이 처리가 실패했을 경우

engineSetCertificateEntry

public abstract void engineSetCertificateEntry(String  alias,
                                               Certificate  cert)
                                        throws KeyStoreException 

지정된 별명에 지정된 인증서를 할당합니다.

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

파라미터:

alias - 별명

cert - 인증서

예외:

KeyStoreException - 지정된 별명이 이미 존재하고 있어, 그 엔트리에 신뢰할 수 있는 인증서가 포함되지 않은 경우, 혹은 이 처리가 다른 원인으로 실패했을 경우

engineDeleteEntry

public abstract void engineDeleteEntry(String  alias)
                                throws KeyStoreException 

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

파라미터:

alias - 별명

예외:

KeyStoreException - 엔트리를 삭제할 수 없는 경우

engineAliases

public abstract Enumeration <String > engineAliases()

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

반환값:

별명의 열거

engineContainsAlias

public abstract boolean engineContainsAlias(String  alias)

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

파라미터:

alias - 별명

반환값:

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

engineSize

public abstract int engineSize()

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

반환값:

이 키스토어 의 엔트리수

engineIsKeyEntry

public abstract boolean engineIsKeyEntry(String  alias)

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

파라미터:

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

반환값:

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

engineIsCertificateEntry

public abstract boolean engineIsCertificateEntry(String  alias)

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

파라미터:

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

반환값:

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

engineGetCertificateAlias

public abstract String  engineGetCertificateAlias(Certificate  cert)

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

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

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

파라미터:

cert - 조합하는 인증서

반환값:

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

engineStore

public abstract void engineStore(OutputStream  stream,
                                 char[] password)
                          throws IOException,

                                 NoSuchAlgorithmException,

                                 CertificateException 

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

파라미터:

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

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

예외:

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

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

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

engineStore

public void engineStore(KeyStore.LoadStoreParameter  param)
                 throws IOException,

                        NoSuchAlgorithmException,

                        CertificateException 

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

파라미터:

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

예외:

IllegalArgumentException - 지정된 KeyStore.LoadStoreParmeter 입력이 인식되지 않는 경우

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

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

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

도입된 버전 :

1.5

engineLoad

public abstract void engineLoad(InputStream  stream,
                                char[] password)
                         throws IOException,

                                NoSuchAlgorithmException,

                                CertificateException 

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

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

파라미터:

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

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

예외:

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

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

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

engineLoad

public void engineLoad(KeyStore.LoadStoreParameter  param)
                throws IOException,

                       NoSuchAlgorithmException,

                       CertificateException 

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

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

파라미터:

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

예외:

IllegalArgumentException - 지정된 KeyStore.LoadStoreParmeter 입력이 인식되지 않는 경우

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

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

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

도입된 버전 :

1.5

engineGetEntry

public KeyStore.Entry  engineGetEntry(String  alias,
                                     KeyStore.ProtectionParameter  protParam)
                              throws KeyStoreException,

                                     NoSuchAlgorithmException,

                                     UnrecoverableEntryException 

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

파라미터:

alias - 이 별명에 대한 KeyStore.Entry를 얻는

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

반환값:

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

예외:

KeyStoreException - 처리가 실패했을 경우

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

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

도입된 버전 :

1.5

engineSetEntry

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

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

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

파라미터:

alias - 이 별명으로 KeyStore.Entry를 보존

entry - 보의존된 Entry

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

예외:

KeyStoreException - 이 처리가 실패했을 경우

도입된 버전 :

1.5

engineEntryInstanceOf

public boolean engineEntryInstanceOf(String  alias,
                                     Class <?  extends KeyStore.Entry > entryClass)

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

파라미터:

alias - 별명

entryClass - 엔트리 클래스

반환값:

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

도입된 버전 :

1.5