Roller 4.0 with LDAP and CAS

This page is designed to show how to integrate Roller 4.0 with LDAP and JA-SIG Central Authentication Service. To begin, you will need to download the following:

• Apache Directory Server 1.5.1
• Apache Directory Studio 1.0.1
• Apache Roller 4.0
• Apache Tomcat 6.0.14
• CAS 3.1

Install Roller and Test

The first step is to install Roller and ensure it works on your application server.

1. Install Tomcat 6 and install the MySQL JDBC Driver in its "lib" directory. Also install JavaMail's activation.jar and mail.jar.
2. Create a CATALINA_HOME environment variable that points to the location where you installed Tomcat.
3. Create a roller-custom.properties file and put it in your server's classpath ($CATALINA_HOME/lib for Tomcat 6).

   installation.type=auto 
   database.configurationType=jdbc 
   database.jdbc.driverClass=com.mysql.jdbc.Driver 
   database.jdbc.connectionURL=jdbc:mysql://localhost:3306/rollerdb?createDatabaseIfNotExist=true 
   database.jdbc.username=root 
   database.jdbc.password= 
   mail.configurationType=properties 
   mail.hostName=localhost
   

4. Copy apache-roller-4.0/webapps/roller to $CATALINA_HOME/webapps/roller and start Tomcat.
5. Go to http://localhost:8080/roller and complete the steps to add a new user and create a blog. When creating a new user, use admin for the username and admin for the password.
6. Test that Roller works by creating a blog entry using the web interface, or using a client like MarsEdit (Moveable Type, RPC URL: http://localhost:8080/roller/roller-services/xmlrpc, Blog ID: admin).

Install LDAP and Test

Now that you have Roller installed and working, configure it to authenticate against LDAP instead of the "rollerdb" database.

1. Stop Tomcat.
2. Install Apache Directory Server and start it as root by running "sudo /usr/local/apacheds" (on OS X).
3. Install Apache Directory Studio and launch the application.
4. Create a new LDAP Connection with the following settings:
   • Connection Name: Local ApacheDS
   • Hostname: localhost
   • Port: 10389
   • Encryption: No Encryption
   • (Click Next)
   • Bind DN or user: uid=admin,ou=system
   • Bind password: secret
   • (Click Finish)
5. Download roller.ldif to your Desktop. This file contains an admin/admin account as well as Groups and People organizational units.
6. In Apache Directory Studio, right click on dc=example,dc=com and select Import > LDIF Import....

Install CAS and Test

Install Apache Directory Server using the installer for your OS. If you're on OS X, the server will be installed in /usr/local/apacheds by default.