Package org.forgerock.opendj.ldap
Interface LdapSession
public interface LdapSession
Server side representation of a connected LDAP client. An LDAP session can be used to query information about the
client's connection such as their network address, as well as managing the state of the connection.
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Disconnects the client without sending a disconnect notification.void
disconnect
(ResultCode resultCode, CharSequence diagnosticMessage) Disconnects the client and sends a disconnect notification, containing the provided result code and diagnostic message.Returns theInetSocketAddress
associated with the local system.Returns the proxy protocol header sent by the client, ornull
if the proxy protocol is disabled.Returns theInetSocketAddress
associated with the remote system.int
Returns the cipher strength, in bits, currently in use by the underlying connection.Returns the SSL session currently in use by the underlying connection, ornull
if SSL/TLS is not enabled.onClose()
Returns aCompletable
which will signalonComplete
when the client disconnects oronError
if the server disconnects the client.sendUnsolicitedNotification
(ExtendedResult notification) Sends an unsolicited notification to the client.
-
Method Details
-
onClose
Completable onClose()Returns aCompletable
which will signalonComplete
when the client disconnects oronError
if the server disconnects the client.- Returns:
- A
Completable
which will complete or fail when this session is terminated.
-
disconnect
void disconnect()Disconnects the client without sending a disconnect notification. Invoking this method causesonClose()
to fail with the errorRxSocket.LOCAL_CLOSE
. -
disconnect
Disconnects the client and sends a disconnect notification, containing the provided result code and diagnostic message. Invoking this method causesonClose()
to fail with the errorRxSocket.LOCAL_CLOSE
.- Parameters:
resultCode
- The result code to include with the disconnect notificationdiagnosticMessage
- The diagnostic message to include with the disconnect notification
-
getLocalAddress
InetSocketAddress getLocalAddress()Returns theInetSocketAddress
associated with the local system.- Returns:
- The
InetSocketAddress
associated with the local system.
-
getRemoteAddress
InetSocketAddress getRemoteAddress()Returns theInetSocketAddress
associated with the remote system.- Returns:
- The
InetSocketAddress
associated with the remote system.
-
getSecurityStrengthFactor
int getSecurityStrengthFactor()Returns the cipher strength, in bits, currently in use by the underlying connection. This value is analogous to thejavax.servlet.request.key_size
property defined in the Servlet specification (section 3.8 "SSL Attributes"). It provides no indication of the relative strength of different cipher algorithms, their known weaknesses, nor the strength of other cryptographic information used during SSL/TLS negotiation.- Returns:
- The cipher strength, in bits, currently in use by the underlying connection.
-
getSslSession
SSLSession getSslSession()Returns the SSL session currently in use by the underlying connection, ornull
if SSL/TLS is not enabled.- Returns:
- The SSL session currently in use by the underlying connection, or
null
if SSL/TLS is not enabled.
-
sendUnsolicitedNotification
Sends an unsolicited notification to the client.- Parameters:
notification
- The notification to send.- Returns:
- A
Completable
which will be completed once the notification has been sent.
-
getProxyProtocolHeader
ProxyProtocolHeader getProxyProtocolHeader()Returns the proxy protocol header sent by the client, ornull
if the proxy protocol is disabled.- Returns:
- The proxy protocol header sent by the client, or
null
if the proxy protocol is disabled.
-