|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object | +--java.security.KeyStore
이 클래스는 열쇠와 증명서의 메모리내 콜렉션을 나타내, 다음의 2 종류의 엔트리를 관리합니다.
이 키스트아엔트리는 매우 기밀성의 높은 암호화열쇠 정보를 보관 유지합니다. 이 정보는 허가되지 않는 액세스를 막기 위해서(때문에) 보호 형식에서 저장됩니다.
통상, 이 엔트리에 저장되는 열쇠는 비밀열쇠, 즉 대응하는 공개열쇠의 증명 연쇄가 있는 비공개열쇠입니다.
비공개열쇠와 증명 연쇄는 지정된 엔티티에 의해 자신의 인증을 위해서(때문에) 사용됩니다. 이 인증이 이용되는 것은 소프트웨어 배포 조직이 소프트웨어의 릴리스나 라이센스 공여의 일관으로서 JAR 파일에 서명하는 경우 등입니다.
이 종류의 엔트리는 다른 조직에 속하는 단일의 공개열쇠가 포함되어 「신뢰할 수 있는 증명서」라고 불립니다. 이것은 키스트아의 소유자에게 있어, 증명서내의 공개열쇠가 실제로 증명서의 「피인증자」(소유자)에 의해 식별된 아이덴티티를 가지고 있는 것이 신뢰할 수 있는 것이기 (위해)때문에입니다.
이 종류의 엔트리는 다른 조직의 인증에 사용할 수 있습니다.
키스트아내의 각 엔트리는 「별명」캐릭터 라인에 의해 식별됩니다. 비공개열쇠와 거기에 관련한 증명 연쇄의 경우는 이러한 캐릭터 라인은 엔티티 자체가 인증하는 방법도 몇개인가 있습니다. 예를 들어, 엔티티가 다른 증명서 발행국을 사용하거나 다른 공개열쇠 알고리즘을 사용하거나 해, 엔티티 자체를 인증하는 일도 가능합니다.
키스트아가 지속성이 있을지 어떨지 및 지속성이 있는 경우에 사용되는 기구는 여기에서는 지정되지 않습니다. 이것에 의해, 중요한 (비밀 또는 비공개) 열쇠를 보호하기 위한 다양한 기술을 사용할 수 있습니다. 스마트 카드 또는 그 외의 통합 암호화 엔진 (SafeKeyper)을 사용하는 일도 1 개의 방법입니다. 또, 파일등의 보다 단순한 기구를 다양한 형식에서 사용할 수도 있습니다.
KeyStore 오브젝트를 요구하려면 , 2 개의 방법이 있습니다. 1 kr은 키스트아형만을 지정하는 방법으로, 이제(벌써) 1 kr은 키스트아형과 패키지 프로바이더의 양쪽 모두를 지정하는 방법입니다.
KeyStore ks = KeyStore.getInstance("JKS");
시스템은 요구되는 키스트아형의 구현이 환경에 있을지 어떨지 또 복수의 구현이 있는 경우에는 적절한 구현이 있을지 어떨지를 조사합니다.
KeyStore ks = KeyStore.getInstance("JKS", "SUN");
시스템은 요구되는 패키지에 키스트아형의 구현이 있을지 어떨지를 조사하지 않은 경우는 예외를 슬로우 합니다.
키스트아에 액세스 할 수 있게 하려면 , 그 키스트아를 로드 하지 않으면 안됩니다. 또, 하늘의 키스트아를 작성하려면 ,load 메소드에 InputStream 인수로서 null 를 건네줍니다.
PrivateKey ,
Certificate | 생성자의 개요 | |
protected |
KeyStore (KeyStoreSpi keyStoreSpi,
Provider provider,
String type)
지정된 형태의 KeyStore 오브젝트를 작성해, 그 오브젝트로, 지정된 프로바이더의 구현인 SPI 오브젝트를 캡슐화합니다. |
| 메소드의 개요 | |
Enumeration |
aliases ()
이 키스트아의 모든 별명을 일람표 가리킵니다. |
boolean |
containsAlias (String alias)
이 키스트아에, 지정된 별명이 존재할지 어떨지를 판정합니다. |
void |
deleteEntry (String alias)
이 키스트아로부터, 지정된 별명에 의해 식별되는 엔트리를 삭제합니다. |
Certificate |
getCertificate (String alias)
지정된 별명에 관련한 증명서를 돌려줍니다. |
String |
getCertificateAlias (Certificate cert)
지정된 증명서와 일치하는 증명서가 있는 최초의 키스트아엔트리의 별명을 돌려줍니다. |
Certificate [] |
getCertificateChain (String alias)
지정된 별명에 관련한 증명 연쇄를 돌려줍니다. |
Date |
getCreationDate (String alias)
지정된 별명에 의해 식별되는 엔트리의 작성일을 돌려줍니다. |
static String |
getDefaultType ()
Java 시큐러티 프로퍼티 파일로 지정되고 있는 디폴트의 키스트아형, 즉 「jks」(Java keystore 의 약어)이라고 하는 캐릭터 라인을 돌려줍니다. |
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)
지정된 별명으로 식별되는 엔트리가 「신뢰할 수 있는 증명서 엔트리」인 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다. |
boolean |
isKeyEntry (String alias)
지정된 별명으로 식별되는 엔트리가 「열쇠 엔트리」인 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다. |
void |
load (InputStream stream,
char[] password)
지정된 입력 스트림으로부터 이 키스트아를 로드합니다. |
void |
setCertificateEntry (String alias,
Certificate cert)
지정된 별명에, 지정된 증명서를 할당합니다. |
void |
setKeyEntry (String alias,
byte[] key,
Certificate [] chain)
지정된 별명에, 벌써 보호되고 있는 지정된 열쇠를 할당합니다. |
void |
setKeyEntry (String alias,
Key key,
char[] password,
Certificate [] chain)
지정된 별명으로 지정된 열쇠를 할당해 지정된 패스워드로 그 열쇠를 보호합니다. |
int |
size ()
이 키스트아의 엔트리수를 취득합니다. |
void |
store (OutputStream stream,
char[] password)
지정된 출력 스트림에 이 키스트아를 저장해, 지정된 패스워드로 그 완전성을 보호합니다. |
| 클래스 java.lang. Object 에서 상속받은 메소드 |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
| 생성자의 상세 |
protected KeyStore(KeyStoreSpi keyStoreSpi,
Provider provider,
String type)
keyStoreSpi - 프로바이더의 구현provider - 프로바이더type - 키스트아형| 메소드의 상세 |
public static KeyStore getInstance(String type)
throws KeyStoreException
지정된 형태의 키스트아의 구현을 디폴트의 프로바이더 패키지가 제공하는 경우는 그 구현을 포함한 KeyStore 의 인스턴스가 돌려주어집니다. 디폴트 패키지에 요구되는 키스트아형이 없는 경우는 다른 패키지를 검색합니다.
type - 키스트아형. 표준의 키스트아형에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조
KeyStoreException - 요구되는 키스트아형이, 디폴트의 프로바이더 패키지에도, 검색한 것 외의 프로바이더 패키지에도 없는 경우
public static KeyStore getInstance(String type,
String provider)
throws KeyStoreException ,
NoSuchProviderException
type - 키스트아형. 표준의 키스트아형에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조provider - 프로바이더명
KeyStoreException - 프로바이더에, 요구된 키스트아형이 없는 경우
NoSuchProviderException - 프로바이더가 설정되어 있지 않은 경우
IllegalArgumentException - 프로바이더의 이름이 null 나 비었을 경우Provider
public static KeyStore getInstance(String type,
Provider provider)
throws KeyStoreException
provider 는 등록되어 있을 필요는 없습니다.
type - 키스트아형. 표준의 키스트아형에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조provider - 프로바이더
KeyStoreException - 프로바이더에, 요구된 키스트아형이 없는 경우
IllegalArgumentException - provider 가 null 의 경우Provider public final Provider getProvider()
public final String getType()
public final Key getKey(String alias,
char[] password)
throws KeyStoreException ,
NoSuchAlgorithmException ,
UnrecoverableKeyException
alias - 별명password - 열쇠를 복원하기 위한 패스워드
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
NoSuchAlgorithmException - 열쇠를 복원하기 위한 알고리즘이 발견되지 않는 경우
UnrecoverableKeyException - 지정된 패스워드가 잘못되어 있는 경우 등, 열쇠를 복원할 수 없는 경우
public final Certificate [] getCertificateChain(String alias)
throws KeyStoreException
alias - 별명
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final Certificate getCertificate(String alias)
throws KeyStoreException
지정된 별명이 「신뢰할 수 있는 증명서 엔트리」를 식별하는 경우는 그 엔트리에 관련한 증명서가 돌려주어집니다. 지정된 별명이 「열쇠 엔트리」를 식별하는 경우는 그 엔트리의 증명 연쇄에 있는 최초의 요소가 돌려주어집니다. 다만, 그 엔트리에 증명 연쇄가 없는 경우는 null 가 돌려주어집니다.
alias - 별명
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final Date getCreationDate(String alias)
throws KeyStoreException
alias - 별명
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
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 - 키스트아가 초기화 (로드)되어 있지 않은 경우, 지정된 열쇠를 보호할 수 없는 경우, 혹은 이 처리가 다른 원인으로 실패했을 경우
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 - 키스트아가 초기화 (로드)되어 있지 않은 경우, 또는 이 처리가 다른 원인으로 실패했을 경우
public final void setCertificateEntry(String alias,
Certificate cert)
throws KeyStoreException
지정된 별명이 이 키스트아에 벌써 존재해, 「신뢰할 수 있는 증명서 엔트리」를 식별하는 경우는 그 별명에 관련한 증명서는 지정된 증명서에 의해 오버라이드(override) 됩니다.
alias - 별명cert - 증명서
KeyStoreException - 키스트아가 초기화되어 있지 않은 경우, 지정된 별명이 벌써 존재해, 「신뢰할 수 있는 증명서 엔트리」를 식별하지 않는 경우, 혹은 이 처리가 다른 원인으로 실패했을 경우
public final void deleteEntry(String alias)
throws KeyStoreException
alias - 별명
KeyStoreException - 키스트아가 초기화되어 있지 않은 경우, 혹은 엔트리를 삭제할 수 없는 경우
public final Enumeration aliases()
throws KeyStoreException
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final boolean containsAlias(String alias)
throws KeyStoreException
alias - 별명
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final int size()
throws KeyStoreException
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final boolean isKeyEntry(String alias)
throws KeyStoreException
alias - 판정 대상이 되는 키스트아엔트리의 별명
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final boolean isCertificateEntry(String alias)
throws KeyStoreException
alias - 판정 대상이 되는 키스트아엔트리의 별명
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final String getCertificateAlias(Certificate cert)
throws KeyStoreException
이 메소드는 지정된 증명서를 각 키스트아엔트리와 조합합니다. 조합하고 있는 엔트리가 「신뢰할 수 있는 증명서 엔트리」인 경우는 지정된 증명서는 그 엔트리의 증명서라고 비교됩니다. 조합하고 있는 엔트리가 「열쇠 엔트리」로, 그 엔트리에 증명 연쇄가 있는 경우는 지정된 증명서는 증명 연쇄의 최초의 요소라고 비교됩니다.
cert - 조합하는 증명서
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
public final void store(OutputStream stream,
char[] password)
throws KeyStoreException ,
IOException ,
NoSuchAlgorithmException ,
CertificateException
stream - 이 키스트아를 기입하는 출력 스트림password - 키스트아의 완전성을 검사하기 위한 패스워드
KeyStoreException - 키스트아가 초기화 (로드)되어 있지 않은 경우
IOException - 데이터에 입출력의 문제가 있었을 경우
NoSuchAlgorithmException - 적절한 데이터 완전성 알고리즘이 발견되지 않았던 경우
CertificateException - 키스트아데이타에 포함되는 어느 증명서도 저장할 수 없었던 경우
public final void load(InputStream stream,
char[] password)
throws IOException ,
NoSuchAlgorithmException ,
CertificateException
패스워드가 지정되었을 경우는 그것을 사용해 키스트아데이타의 완전성이 검사됩니다. 그렇지 않은 경우는 키스트아의 완전성은 검사되지 않습니다.
하늘의 키스트아를 작성하는 경우, 혹은 키스트아가 하드웨어 토큰 디바이스에 저장되고 있는 등의 이유로써 스트림으로부터 는 초기화할 수 없는 경우는 stream 인수로서 null 를 건네줍니다.
KeyStore 가 벌써 로드 되고 있는 경우, KeyStore 는 다시 초기화되고 지정된 스트림으로부터 다시 로드합니다.
stream - 키스트아의 로드원의 입력 스트림. 하늘의 키스트아를 작성하는 경우는 nullpassword - 키스트아의 완전성을 검사하기 위한 옵션의 패스워드
IOException - 키스트아데이타에 입출력 또는 형식의 문제가 있었을 경우
NoSuchAlgorithmException - 키스트아의 완전성을 검사하는 알고리즘이 발견되지 않았던 경우
CertificateException - 키스트아의 어느 증명서도 로드할 수 없었던 경우public static final String getDefaultType()
디폴트의 키스트아형을 사용하는 것은 어플리케이션으로 getInstance 메소드를 호출할 때, 하드 코드 된 키스트아형을 사용하지 않는 경우, 및 유저가 독자적인 키스트아형을 지정하지 않을 때에, 디폴트의 키스트아형을 제공하는 경우입니다.
디폴트의 키스트아형을 변경하려면 , Java 시큐러티 프로퍼티 파일의 keystore.type 시큐러티 프로퍼티의 값을 목적의 키스트아형으로 설정합니다.
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.