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	engineAliases () 이 키스트아의 모든 별명을 일람표 가리킵니다.
abstract boolean	engineContainsAlias (String alias) 이 키스트아에, 지정된 별명이 존재할지 어떨지를 판정합니다.
abstract void	engineDeleteEntry (String alias) 이 키스트아로부터, 지정된 별명에 의해 식별되는 엔트리를 삭제합니다.
abstract Certificate	engineGetCertificate (String alias) 지정된 별명에 관련한 증명서를 돌려줍니다.
abstract String	engineGetCertificateAlias (Certificate cert) 지정된 증명서와 일치하는 증명서가 있는 최초의 키스트아엔트리의 별명을 돌려줍니다.
abstract Certificate []	engineGetCertificateChain (String alias) 지정된 별명에 관련한 증명 연쇄를 돌려줍니다.
abstract Date	engineGetCreationDate (String alias) 지정된 별명에 의해 식별되는 엔트리의 작성일을 돌려줍니다.
abstract Key	engineGetKey (String alias, char[] password) 지정된 패스워드를 사용해, 지정된 별명에 관련한 열쇠를 복원해, 그 열쇠를 돌려줍니다.
abstract boolean	engineIsCertificateEntry (String alias) 지정된 별명으로 식별되는 엔트리가 「신뢰할 수 있는 증명서 엔트리」인 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.
abstract boolean	engineIsKeyEntry (String alias) 지정된 별명으로 식별되는 엔트리가 「열쇠 엔트리」인 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.
abstract void	engineLoad (InputStream stream, char[] password) 지정된 입력 스트림으로부터 키스트아를 로드합니다.
abstract void	engineSetCertificateEntry (String alias, Certificate cert) 지정된 별명에, 지정된 증명서를 할당합니다.
abstract void	engineSetKeyEntry (String alias, byte[] key, Certificate [] chain) 지정된 별명에, 벌써 보호되고 있는 지정의 열쇠를 할당합니다.
abstract void	engineSetKeyEntry (String alias, Key key, char[] password, Certificate [] chain) 지정된 별명으로 지정된 열쇠를 할당해 지정된 패스워드로 그 열쇠를 보호합니다.
abstract int	engineSize () 이 키스트아의 엔트리수를 취득합니다.
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 

지정된 패스워드를 사용해, 지정된 별명에 관련한 열쇠를 복원해, 그 열쇠를 돌려줍니다.

파라미터:

alias - 별명

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

반환값:

요구되는 열쇠. 지정된 별명이 존재하지 않는지 「열쇠 엔트리」를 식별하지 않는 경우는 null

예외:

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

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

engineGetCertificateChain

public abstract Certificate [] engineGetCertificateChain(String  alias)

지정된 별명에 관련한 증명 연쇄를 돌려줍니다.

파라미터:

alias - 별명

반환값:

유저의 증명서가 최초, 루트 증명서 발행국이 마지막에 놓여지는 증명 연쇄. 지정된 별명이 존재하지 않는 경우나, 지정된 별명이 「신뢰할 수 있는 증명서 엔트리」또는 증명 연쇄가 없는 「열쇠 엔트리」를 식별하는 경우 등, 별명이 증명 연쇄를 포함하지 않는 경우는 null

engineGetCertificate

public abstract Certificate  engineGetCertificate(String  alias)

지정된 별명에 관련한 증명서를 돌려줍니다.

지정된 별명이 「신뢰할 수 있는 증명서 엔트리」를 식별하는 경우는 그 엔트리에 관련한 증명서가 돌려주어집니다. 지정된 별명이 「열쇠 엔트리」를 식별하는 경우는 그 엔트리의 증명 연쇄에 있는 최초의 요소가 돌려주어집니다. 다만, 그 엔트리에 증명 연쇄가 없는 경우는 null 가 돌려주어집니다.

파라미터:

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 

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

지정된 별명이 이 키스트아에 벌써 존재해, 「신뢰할 수 있는 증명서 엔트리」를 식별하는 경우는 그 별명에 관련한 증명서는 지정된 증명서에 의해 오버라이드(override) 됩니다.

파라미터:

alias - 별명

cert - 증명서

예외:

KeyStoreException - 지정된 별명이 벌써 존재해, 「신뢰할 수 있는 증명서 엔트리」를 식별하지 않는 경우나, 이 처리가 다른 원인으로 실패했을 경우

engineDeleteEntry

public abstract void engineDeleteEntry(String  alias)
                                throws KeyStoreException 

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

파라미터:

alias - 별명

예외:

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

engineAliases

public abstract Enumeration  engineAliases()

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

반환값:

별명의 열거

engineContainsAlias

public abstract boolean engineContainsAlias(String  alias)

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

파라미터:

alias - 별명

반환값:

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

engineSize

public abstract int engineSize()

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

반환값:

이 키스트아의 엔트리수

engineIsKeyEntry

public abstract boolean engineIsKeyEntry(String  alias)

지정된 별명으로 식별되는 엔트리가 「열쇠 엔트리」인 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.

파라미터:

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

반환값:

지정된 별명으로 식별되는 엔트리가 「열쇠 엔트리」인 경우는 true, 그렇지 않은 경우는 false

engineIsCertificateEntry

public abstract boolean engineIsCertificateEntry(String  alias)

지정된 별명으로 식별되는 엔트리가 「신뢰할 수 있는 증명서 엔트리」인 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.

파라미터:

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

반환값:

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

engineGetCertificateAlias

public abstract String  engineGetCertificateAlias(Certificate  cert)

지정된 증명서와 일치하는 증명서가 있는 최초의 키스트아엔트리의 별명을 돌려줍니다.

이 메소드는 지정된 증명서를 각 키스트아엔트리와 조합합니다. 조합하고 있는 엔트리가 「신뢰할 수 있는 증명서 엔트리」인 경우는 지정된 증명서는 그 엔트리의 증명서라고 비교됩니다. 조합하고 있는 엔트리가 「열쇠 엔트리」로, 그 엔트리에 증명 연쇄가 있는 경우는 지정된 증명서는 증명 연쇄의 최초의 요소라고 비교됩니다.

파라미터:

cert - 조합하는 증명서

반환값:

일치하는 증명서가 있는 최초의 엔트리의 별명. 그러한 엔트리가 이 키스트아에 존재하지 않는 경우는 null

engineStore

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

지정된 출력 스트림에 이 키스트아를 저장해, 지정된 패스워드로 그 완전성을 보호합니다.

파라미터:

stream - 이 키스트아를 기입하는 출력 스트림

password - 키스트아의 완전성을 검사하기 위한 패스워드

예외:

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

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

CertificateException - 키스트아데이타에 포함되는 어느 증명서도 저장할 수 없었던 경우

engineLoad

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

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

패스워드가 지정되었을 경우는 그것을 사용해 키스트아데이타의 완전성이 검사됩니다. 그렇지 않은 경우는 키스트아의 완전성은 검사되지 않습니다.

파라미터:

stream - 키스트아의 로드원의 입력 스트림

password - 키스트아의 완전성을 검사하기 위한 옵션의 패스워드

예외:

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

NoSuchAlgorithmException - 키스트아의 완전성을 검사하는 알고리즘이 발견되지 않았던 경우

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