Module java.naming

Defines the Java Naming and Directory Interface (JNDI) API.

Common standard JNDI environment properties that may be supported by JNDI providers are defined and documented in Context. Specific JNDI provider implementations may also support other environment properties, which are specific to their implementation.

Implementation Note:
The following implementation specific properties are supported by the default LDAP Naming Service Provider implementation in the JDK:
  • java.naming.ldap.factory.socket:
    The value of this environment property specifies the fully qualified class name of the socket factory used by the LDAP provider. This class must implement the SocketFactory abstract class and provide an implementation of the static "getDefault()" method that returns an instance of the socket factory. By default the environment property is not set.
  • com.sun.jndi.ldap.connect.timeout:
    The value of this environment property is the string representation of an integer specifying the connection timeout in milliseconds. If the LDAP provider cannot establish a connection within that period, it aborts the connection attempt. The integer should be greater than zero. An integer less than or equal to zero means to use the network protocol's (i.e., TCP's) timeout value.
    If this property is not specified, the default is to wait for the connection to be established or until the underlying network times out.
    If a custom socket factory is provided via environment property java.naming.ldap.factory.socket and unconnected sockets are not supported, the specified timeout is ignored and the provider behaves as if no connection timeout was set.
  • com.sun.jndi.ldap.read.timeout:
    The value of this property is the string representation of an integer specifying the read timeout in milliseconds for LDAP operations. If the LDAP provider cannot get a LDAP response within that period, it aborts the read attempt. The integer should be greater than zero. An integer less than or equal to zero means no read timeout is specified which is equivalent to waiting for the response infinitely until it is received.
    If this property is not specified, the default is to wait for the response until it is received.
  • com.sun.jndi.ldap.tls.cbtype:
    The value of this property is the string representing the TLS Channel Binding type required for an LDAP connection over SSL/TLS. Possible value is :
    • "tls-server-end-point" - Channel Binding data is created on the basis of the TLS server certificate.

    "tls-unique" TLS Channel Binding type is specified in RFC-5929 but not supported.
    If this property is not specified, the client does not send channel binding information to the server.
Since:
9