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 - 키스토어데이타로 입출력 또는 형식에 관한 문제가 발생했을 경우, 패스워드가 필요해요로 지정되지 않았던 경우, 또는 지정된 패스워드가 잘못되어 있는 경우. 패스워드가 올바르지 않았기(위해)때문에 에러가 발생했을 경우,IOException 의원인 은 UnrecoverableKeyException

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

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

engineLoad

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

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

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

파라미터:

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

예외:

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

IOException - 키스토어데이타에 입출력 또는 형식의 문제가 있었을 경우. ProtectionParameter 가 올바르지 않았던 (예를 들어 패스워드가 올바르지 않았다) 위해(때문에) 에러가 발생했을 경우,IOException 의원인 은 UnrecoverableKeyException

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 가 불충분 또는 무효인 경우

UnrecoverableKeyException - 엔트리가 PrivateKeyEntry 또는 SecretKeyEntry 로, 지정된 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