Класс StartTlsRequest

Этот класс реализует расширенный запрос LDAPv3 для StartTLS, как определено в Протоколе доступа к лёгким каталогам (v3): Расширение для транспортного уровня безопасности. Идентификатор объекта для StartTLS — 1.3.6.1.4.1.1466.20037, и значение расширенного запроса не определено.

StartTlsRequest/StartTlsResponse используются для установления TLS-соединения по существующему LDAP-соединению, связанному с контекстом JNDI, в котором вызывается extendedOperation(). Как правило, программа JNDI использует эти классы следующим образом.

import javax.naming.ldap.*;

// Open an LDAP association
LdapContext ctx = new InitialLdapContext();

// Perform a StartTLS extended operation
StartTlsResponse tls =
    (StartTlsResponse) ctx.extendedOperation(new StartTlsRequest());

// Open a TLS connection (over the existing LDAP association) and get details
// of the negotiated TLS session: cipher suite, peer certificate, etc.
SSLSession session = tls.negotiate();

// ... use ctx to perform protected LDAP operations

// Close the TLS connection (revert back to the underlying LDAP association)
tls.close();

// ... use ctx to perform unprotected LDAP operations

// Close the LDAP association
ctx.close;

Поля

OID

public static final String OID

Назначенный идентификатор объекта расширенного запроса StartTLS — 1.3.6.1.4.1.1466.20037.

См. также:

Значения постоянных полей

Конструкторы

StartTlsRequest

public StartTlsRequest()

Создаёт расширенный запрос StartTLS.

Методы

getID

public String getID()

Возвращает строку идентификатора объекта запроса StartTLS.

Определено в:

getID в интерфейсе ExtendedRequest

Возвращает:

Строку идентификатора объекта, "1.3.6.1.4.1.1466.20037".

getEncodedValue

public byte[] getEncodedValue()

Возвращает закодированное значение запроса StartTLS в ASN.1 BER. Поскольку запрос не имеет определённого значения, всегда возвращается null.

Определено в:

getEncodedValue в интерфейсе ExtendedRequest

Возвращает:

Значение null.

createExtendedResponse

public ExtendedResponse createExtendedResponse(String id,
                                               byte[] berValue,
                                               int offset,
                                               int length)
                                        throws NamingException

META-INF/services/javax.naming.ldap.StartTlsResponse

Определено в:

createExtendedResponse в интерфейсе ExtendedRequest

Параметры:

id - Идентификатор объекта расширенного ответа. Его значение должно быть "1.3.6.1.4.1.1466.20037" или null. Оба значения эквивалентны.

berValue - Возможно, null, закодированное в ASN.1 BER значение расширенного ответа. Это сырые байты BER, включая тег и длину значения ответа. Он не включает идентификатор объекта ответа. Его значение игнорируется, потому что ожидается, что ответ Start TLS не будет содержать никакого значения ответа.

offset - Начальная позиция в berValue используемых байтов. Его значение игнорируется, так как ожидается, что ответ Start TLS не будет содержать никакого значения ответа.

length - Количество байтов в berValue для использования. Его значение игнорируется, потому что ожидается, что ответ Start TLS не будет содержать никакого значения ответа.

Возвращает:

Объект расширенного ответа StartTLS.

Исключения:

NamingException - Если во время создания объекта расширенного ответа StartTLS возникло исключение.

См. также:

ExtendedResponse