LDAP + Alfresco user authentication

AlfrescoLogo-150x150
Recently, I configurated Alfresco to chain LDAP+ Alfresco user authentication.

To configure this, you have to edit two files: chaining-authentication-context.xml and ldap-authentication-context.xml (the files are in $ALFRESCO_HOME/tomcat/shared/classes/alfresco/extension directory).

The configuration consists of two parts:

  • Authentication Service Bean
  • Authentication Component Bean

The authentication by default is LDAP. This two configuration files worked:

chaining-authentication-context.xml


<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>

<beans>

<!– Chaining –>
<bean id=»authenticationService»>
<property name=»authenticationServices»>
<list>
<ref bean=»authenticationServiceImplLDAP»/>
</list>
</property>
<property name=»mutableAuthenticationService»>
<ref bean=»authenticationServiceImplAlfresco»/>
</property>
</bean>

<bean id=»authenticationComponent»>
<property name=»authenticationComponents»>
<list>
<ref bean=»authenticationComponentImplLDAP»/>
</list>
</property>
<property name=»mutableAuthenticationComponent»>
<ref bean=»authenticationComponentImplAlfresco»/>
</property>
</bean>

<!– Alfresco Auth –>
<bean id=»authenticationServiceImplAlfresco»>
<property name=»authenticationDao»>
<ref bean=»authenticationDaoAlfresco»/>
</property>
<property name=»ticketComponent»>
<ref bean=»ticketComponent»/>
</property>
<property name=»authenticationComponent»>
<ref bean=»authenticationComponentImplAlfresco»/>
</property>
</bean>

<bean id=»authenticationDaoAlfresco»>
<property name=»nodeService»>
<ref bean=»nodeService»/>
</property>
<property name=»dictionaryService»>
<ref bean=»dictionaryService»/>
</property>
<property name=»namespaceService»>
<ref bean=»namespaceService»/>
</property>
<property name=»searchService»>
<ref bean=»admSearchService»/>
</property>
<property name=»userNamesAreCaseSensitive»>
<value>${user.name.caseSensitive}</value>
</property>
<property name=»passwordEncoder»>
<ref bean=»passwordEncoder»/>
</property>
</bean>

<bean id=»authenticationComponentImplAlfresco» >
<property name=»authenticationDao»>
<ref bean=»authenticationDaoAlfresco»/>
</property>
<property name=»authenticationManager»>
<ref bean=»authenticationManager»/>
</property>
<property name=»allowGuestLogin»>
<value>false</value>
</property>
<property name=»nodeService»>
<ref bean=»nodeService» />
</property>
<property name=»personService»>
<ref bean=»personService» />
</property>
<property name=»transactionService»>
<ref bean=»transactionService» />
</property>
</bean>

<!– LDAP Auth –>
<bean id=»authenticationServiceImplLDAP»>
<property name=»authenticationDao»>
<ref bean=»authenticationDaoLDAP» />
</property>
<property name=»ticketComponent»>
<ref bean=»ticketComponent» />
</property>
<property name=»authenticationComponent»>
<ref bean=»authenticationComponentImplLDAP» />
</property>
</bean>

</beans>

ldap-authentication-context.xml

<?xml version=’1.0′ encoding=’UTF-8′?>
<!DOCTYPE beans PUBLIC ‘-//SPRING//DTD BEAN//EN’ ‘http://www.springframework.org/dtd/spring-beans.dtd’>

<beans>

<!– The main configuration has moved into a properties file –>

<bean name=»ldapAuthenticationPlaceholderConfigurer»>
<property name=»ignoreUnresolvablePlaceholders»>
<value>true</value>
</property>
<property name=»locations»>
<value>classpath:alfresco/extension/ldap-authentication.properties</value>
</property>
</bean>

<!– DAO that rejects changes – LDAP is read only at the moment. It does allow users to be deleted with out warnings from the UI. –>

<bean name=»authenticationDaoLDAP» >
<property name=»allowDeleteUser»>
<value>true</value>
</property>
</bean>

<!– LDAP authentication configuration –>

<!–

You can also use JAAS authentication for Kerberos against Active Directory or NTLM if you also require single sign on from the
web browser. You do not have to use LDAP authentication to synchronise groups and users from an LDAP store if it supports other
authentication routes, like Active Directory.

–>

<bean id=»authenticationComponentImplLDAP»>
<property name=»LDAPInitialDirContextFactory»>
<ref bean=»ldapInitialDirContextFactory»/>
</property>
<property name=»userNameFormat»>
<!–

This maps between what the user types in and what is passed through to the underlying LDAP authentication.

«%s» – the user id is passed through without modification.
Used for LDAP authentication such as DIGEST-MD5, anything that is not «simple».

«cn=%s,ou=London,dc=company,dc=com» – If the user types in «Joe Bloggs» the authenticate as «cn=Joe Bloggs,ou=London,dc=company,dc=com»
Usually for simple authentication. Simple authentication always uses the DN for the user.

–>
<value>${ldap.authentication.userNameFormat}</value>
</property>
<property name=»nodeService»>
<ref bean=»nodeService» />
</property>
<property name=»personService»>
<ref bean=»personService» />
</property>
<property name=»transactionService»>
<ref bean=»transactionService» />
</property>
<property name=»escapeCommasInBind»>
<value>${ldap.authentication.escapeCommasInBind}</value>
</property>
<property name=»escapeCommasInUid»>
<value>${ldap.authentication.escapeCommasInUid}</value>
</property>
</bean>

<!–

This bean is used to support general LDAP authentication. It is also used to provide read only access to users and groups
to pull them out of the LDAP reopsitory

–>

<bean id=»ldapInitialDirContextFactory»>
<property name=»initialDirContextEnvironment»>
<map>
<!– The LDAP provider –>
<entry key=»java.naming.factory.initial»>
<value>${ldap.authentication.java.naming.factory.initial}</value>
</entry>

<!– The url to the LDAP server –>
<!– Note you can use space separated urls – they will be tried in turn until one works –>
<!– This could be used to authenticate against one or more ldap servers (you will not know which one ….) –>

<entry key=»java.naming.provider.url»>
<value>${ldap.authentication.java.naming.provider.url}</value>
</entry>

<!– The authentication mechanism to use –>
<!– Some sasl authentication mechanisms may require a realm to be set –>
<!– java.naming.security.sasl.realm –>
<!– The available options will depend on your LDAP provider –>

<entry key=»java.naming.security.authentication»>
<value>${ldap.authentication.java.naming.security.authentication}</value>
</entry>

<!– The id of a user who can read group and user information –>
<!– This does not go through the pattern substitution defined above and is used «as is» –>

<entry key=»java.naming.security.principal»>
<value>${ldap.authentication.java.naming.security.principal}</value>
</entry>

<!– The password for the user defined above –>
<entry key=»java.naming.security.credentials»>
<value>${ldap.authentication.java.naming.security.credentials}</value>
</entry>
</map>
</property>
</bean>

</beans>

I tried this configuration in Alfresco 2.1.6