Интерфейс 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(java.lang.String,java.security.Principal[])

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

Получение соответствующих псевдонимов для аутентификации клиентской стороны защищенного сокета, учитывая тип открытого ключа и список авторитетов выпуска сертификатов, распознанных удаленным узлом (если таковые имеются).

Параметры:: keyType - имя типа алгоритма ключа; issuers - список приемлемых имен субъектов-выпускающих ЦС, или null, если не важно, какие ЦС используются.
Возвращает:: массив соответствующих имен псевдонимов, или null, если соответствий не найдено.

chooseClientAlias(java.lang.String[],java.security.Principal[],java.net.Socket)

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

Выбор псевдонима для аутентификации клиентской стороны защищенного сокета, учитывая тип открытого ключа и список авторитетов выпуска сертификатов, распознанных удаленным узлом (если таковые имеются).

Параметры:: keyType - имя(на) типа алгоритма ключа(ей), упорядоченные по убыванию предпочтительности.; issuers - список приемлемых имен субъектов-выпускающих ЦС или null, если не важно, какие ЦС используются.; socket - сокет, используемый для этого соединения. Этот параметр может быть null, что означает, что реализации могут свободно выбрать псевдоним, применимый к любому сокету.
Возвращает:: имя псевдонима для нужного ключа, или null, если соответствий нет.

getServerAliases(java.lang.String,java.security.Principal[])

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

Получение соответствующих псевдонимов для аутентификации серверной стороны защищенного сокета, учитывая тип открытого ключа и список авторитетов выпуска сертификатов, распознанных удаленным узлом (если таковые имеются).

Параметры:: keyType - имя типа алгоритма ключа; issuers - список приемлемых имен субъектов-выпускающих ЦС или null, если не важно, какие ЦС используются.
Возвращает:: массив соответствующих имен псевдонимов, или null, если соответствий не найдено.

chooseServerAlias(java.lang.String,java.security.Principal[],java.net.Socket)

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

Выбор псевдонима для аутентификации серверной стороны защищенного сокета, учитывая тип открытого ключа и список авторитетов выпуска сертификатов, распознанных удаленным узлом (если таковые имеются).

Параметры:: keyType - имя типа алгоритма ключа.; issuers - список приемлемых имен субъектов-выпускающих ЦС или null, если не важно, какие ЦС используются.; socket - сокет, используемый для этого соединения. Этот параметр может быть null, что означает, что реализации могут свободно выбрать псевдоним, применимый к любому сокету.
Возвращает:: имя псевдонима для нужного ключа, или null, если соответствий нет.

getCertificateChain(java.lang.String)

X509Certificate[] getCertificateChain(String alias)

Возвращает цепочку сертификатов, связанную с заданным псевдонимом.

Параметры:: alias - имя псевдонима
Возвращает:: цепочку сертификатов (упорядоченную с сертификатом пользователя первым и корневым сертификатом авторитета последним), или null, если псевдоним не найден.

getPrivateKey(java.lang.String)

PrivateKey getPrivateKey(String alias)

Возвращает ключ, связанный с заданным псевдонимом.

Параметры:: alias - имя псевдонима
Возвращает:: запрашиваемый ключ, или null, если псевдоним не найден.