/atg/adapter/ldap/InitialContextEnvironment

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

Default Value

$class

class name

atg.adapter.ldap.
LDAPJNDIEnvironment

providerURL

URL of the LDAP server

ldap://localhost:389

securityAuthentication

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

simple
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.

simple

securityPrincipal

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

cn=ldapadmin

securityCredentials

The credentials of the principal to be authenticated

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

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. See Sun’s LDAP tutorial on the subject of SASL at http://java.sun.com/products/jndi/tutorial/ldap/security/sasl.html for more information on the valid SASL mechanisms. 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 Sun’s JNDI LDAP service provider:

LDAPVersion
binaryAttributes
connectControls
deleteRDN
derefAliases
typesOnly
refSeparator
socketFactory
referralLimit
BERTrace
schemaBugs

See Sun’s 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.

 
loading table of contents...