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.