This component specifies the JNDI environment properties used to create a JNDI InitialDirContext. You must configure this component to point to your LDAP directory server. Typically, you set the following properties (other than the class definition):

Property

Description

$class

class name

Default:
atg.adapter.ldap.LDAPJNDIEnvironment

providerURL

URL of the LDAP server

Default: ldap://localhost:389

securityAuthentication

Authentication mechanism for the provider to use. Some valid values are:

Simple (default)
Use weak authentication (cleartext password)

none
Use no authentication (anonymous).

CRAM-MD5
Use the CRAM-MD5 (RFC-2195) SASL mechanism.

See securityAuthentication Property below for more information.

securityPrincipal

The identity of the principal to be authenticated, in the form of a distinguished name.

Default: cn=ldapadmin

securityCredentials

The credentials of the principal to be authenticated

Default: ldapadmin

otherProperties

Any additional environment properties you might need to set. The value of the otherProperties property is one or more comma-separated property/value pairs. For example, you can set:

otherProperties=
com.sun.jndi.ldap.someProperty=someValue

Default: null

securityAuthentication Property

The securityAuthentication property must be set to match an appropriate type of security authentication for your LDAP server. For example, you can use the CRAM-MDS setting only if you have configured your LDAP directory server appropriately. Note also that if you set this property to none, the LDAP server treats the LDAP repository as an anonymous client. Depending on how your LDAP server is configured, you may therefore be unable to create, modify, or delete LDAP directory entries through the LDAP repository.

Other Environment Properties

Also, the InitialContextEnvironment component has the following properties, which correspond to environment properties of a JNDI context (as documented in the javax.naming.Context interface):

initialContextFactory
objectFactories
controlFactories
stateFactories
URLPkgPrefixes
DNSURL
authoritative
batchSize
referral
securityProtocol
language

See the Javadoc for javax.naming.Context for more information about these properties.

Furthermore, the InitialContextEnvironment component has the following properties that apply to LDAP service providers in general or are specific to Oracle’s (formerly Sun’s) JNDI LDAP service provider:

LDAPVersion
binaryAttributes
connectControls
deleteRDN
derefAliases
typesOnly
refSeparator
socketFactory
referralLimit
BERTrace
schemaBugs

See the JNDI Implementor Guidelines for LDAP Service Providers, section 3, Environment Properties, at http://java.sun.com/products/jndi/jndi-ldap-gl.html#PROP for more information.