javax.net.ssl
인터페이스 X509KeyManager

모든 슈퍼 인터페이스:

KeyManager

알려진 구현 클래스 목록:

X509ExtendedKeyManager

public interface X509KeyManager
extends KeyManager 

이 인터페이스의 인스턴스는 로컬측의 시큐어 소켓을 인증할 경우에 사용하는 X509 인증서 베이스의 키 페어를 관리합니다.

구현은 시큐어 소켓의 네고시에이션중에 다음의 목적으로 이 인터페이스의 메서드를 호출합니다.

• 지정된 조건에 기반해 네고시에이션에 사용할 수 있는 별명세트를 특정한다
• 지정된 조건에 기반해 최적인 별명을 선택한다
• 지정된 별명에 대응하는 키 데이터를 취득한다

주: 이 클래스에서는 X509ExtendedKeyManager 사용을 우선하는 것을 추천합니다.

도입된 버전 :

1.4

메서드 개요

String	chooseClientAlias (String [] keyType, Principal [] issuers, Socket socket) 공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 클라이언트측의 시큐어 소켓을 인증할 때의 별명을 선택합니다.
String	chooseServerAlias (String keyType, Principal [] issuers, Socket socket) 공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 서버측의 시큐어 소켓을 인증할 때의 별명을 선택합니다.
X509Certificate []	getCertificateChain (String alias) 지정된 별명에 관련된 인증서 체인을 리턴합니다.
String []	getClientAliases (String keyType, Principal [] issuers) 공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 클라이언트측의 시큐어 소켓을 인증할 때의 별명을 취득합니다.
PrivateKey	getPrivateKey (String alias) 지정된 별명에 관련된 키를 리턴합니다.
String []	getServerAliases (String keyType, Principal [] issuers) 공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 서버측의 시큐어 소켓을 인증할 때의 별명을 취득합니다.

메서드의 상세

getClientAliases

String [] getClientAliases(String  keyType,
                          Principal [] issuers)

공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 클라이언트측의 시큐어 소켓을 인증할 때의 별명을 취득합니다.

파라미터:

keyType - 키 알고리즘의 타입명

issuers - 받아들일 수 있는 CA 발행자의 피인증자명. 임의의 발행자를 받아들일 수 있는인 경우는 null

반환값:

조건에 일치하는 별명의 배열. 일치하는 별명이 없는 경우는 null

chooseClientAlias

String  chooseClientAlias(String [] keyType,
                         Principal [] issuers,
                         Socket  socket)

공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 클라이언트측의 시큐어 소켓을 인증할 때의 별명을 선택합니다.

파라미터:

keyType - 키 알고리즘의 타입명. 우선 순위의 높은 키 타입으로부터 순서로 지정하는

issuers - 받아들일 수 있는 CA 발행자의 피인증자명. 임의의 발행자를 받아들일 수 있는인 경우는 null

socket - 이 접속에 사용하는 소켓. 이 파라미터는 null도 가능. null인 경우는 이 인터페이스의 구현이, 임의의 소켓에 적용 가능한 별명을 자유롭게 선택할 수 있는 것을 나타낸다

반환값:

지정된 키의 별명. 대응하는 별명이 없는 경우는 null

getServerAliases

String [] getServerAliases(String  keyType,
                          Principal [] issuers)

공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 서버측의 시큐어 소켓을 인증할 때의 별명을 취득합니다.

파라미터:

keyType - 키 알고리즘의 타입명

issuers - 받아들일 수 있는 CA 발행자의 피인증자명. 임의의 발행자를 받아들일 수 있는인 경우는 null

반환값:

조건에 일치하는 별명의 배열. 일치하는 별명이 없는 경우는 null

chooseServerAlias

String  chooseServerAlias(String  keyType,
                         Principal [] issuers,
                         Socket  socket)

공개키의 타입 및 피어에 의해 인식되는 인증서 발행국의 리스트에 기반해 서버측의 시큐어 소켓을 인증할 때의 별명을 선택합니다.

파라미터:

keyType - 키 알고리즘의 타입명

issuers - 받아들일 수 있는 CA 발행자의 피인증자명. 임의의 발행자를 받아들일 수 있는인 경우는 null

socket - 이 접속에 사용하는 소켓. 이 파라미터는 null도 가능. null인 경우는 이 인터페이스의 구현이, 임의의 소켓에 적용 가능한 별명을 자유롭게 선택할 수 있는 것을 나타낸다

반환값:

지정된 키의 별명. 대응하는 별명이 없는 경우는 null

getCertificateChain

X509Certificate [] getCertificateChain(String  alias)

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

파라미터:

alias - 별명

반환값:

인증서 체인. 사용자 의 인증서가 최초로 배치되어 루트 인증서 발행국이 마지막에 배치되고 있다. 별명이 발견되지 않는 경우는 null

getPrivateKey

PrivateKey  getPrivateKey(String  alias)

지정된 별명에 관련된 키를 리턴합니다.

파라미터:

alias - 별명

반환값:

요구된 키. 별명이 발견되지 않는 경우는 null