Интерфейс X509KeyManager

public interface X509KeyManager
extends KeyManager

Экземпляры этого интерфейса управляют тем, какие пары ключей на основе сертификатов X509 используются для аутентификации локальной стороны защищенного сокета.

Во время переговоров защищенного сокета реализации вызывают методы этого интерфейса для:

• определения набора псевдонимов, которые доступны для переговоров на основе представленных критериев,
• выбора лучшего псевдонима на основе представленных критериев и
• получения соответствующих ключевых материалов для заданных псевдонимов.

Примечание: следует использовать X509ExtendedKeyManager вместо этого класса.

Методы

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, если совпадений не найдено.

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, если совпадений не найдено.

getCertificateChain

X509Certificate[] getCertificateChain(String alias)

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

Параметры:

alias - имя псевдонима

Возвращает:

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

getPrivateKey

PrivateKey getPrivateKey(String alias)

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

Параметры:

alias - имя псевдонима

Возвращает:

запрашиваемый ключ, или null, если псевдоним не найден.