Excerpt |
---|
This tutorial demonstrates how to set up CAS quickly on Windows using the Apache Directory Server for LDAP authentication. |
Note | ||
---|---|---|
| ||
The instructions in this guide are for a quick LDAP setup only and should not be used for creating a production deployment of CAS. Use the Maven War Overlay method described in Maintaining local customizations using Maven 2 for any deployment that requires configuration management. |
...
- Download Apache directory server from http://directory.apache.org/
- Run the setup with all the defaults and test that the server is working on localhost using telnet:
- Start->Run->telnet
- In the telnet console, type the following:
open localhost 10389
- If you get a screen that lets you type, Apache Directory Server is configured properly
- Download the CAS installation and find the war file e.g. \cas-server-$VERSION\modules\cas-server-webapp-$VERSION.war
- Start the Tomcat server, e.g.
$TOMCAT_HOME/bin/startup.bat
. - Add the CAS war file, cas-server-webapp-3.2.1.war, to the webapps folder,
$TOMCAT_HOME\webapps
. - Confirm the following directory exists, which indicates a successful deploy, {{$TOMCAT_HOME\webapps\cas-server-webapp-$VERSION},
- You may also examine the Tomcat stardard output log file for errors,
$TOMCAT_HOME/logs/catalina.out
. - Stop the tomcat server, e.g.
$TOMCAT_HOME/bin/shutdown.bat
. Add the following to the pom.xml file in the META-INF folder,
$TOMCAT_HOME\webapps\cas-server-webapp-$VERSION\META-INF\maven\org.jasig.cas\cas-server-webapp
:Code Block xml xml <dependency> <groupId>${project.groupId}</groupId> <artifactId>cas-server-support-ldap</artifactId> <version>${project.version}</version> </dependency>
- Edit
$TOMCAT_HOME\webapps\cas-server-webapp-$VERSION\WEB-INF\deployerConfigContext.xml
as follows:Add the following bean LDAP authentication:
Code Block xml xml<bean id="contextSource" class="org.jasigspringframework.casldap.adaptorscore.ldapsupport.util.AuthenticatedLdapContextSourceLdapContextSource"> <property name="pooled" value="true"/> <property name="urls"> <list> <value>ldap://localhost:10389</value> </list> </property> <property name="userDn" value="uid=admin,ou=system"/> <property name="password" value="secret"/> <property name="baseEnvironmentProperties"> <map> <entry key="java.naming.security.authentication" value="simple" /> </map> </property> </bean>
- Remove the demo authentication handler,
org.jasig.cas.authentication.handler.support.SimpleTestUsernamePasswordAuthenticationHandler
, from theauthenticationHandlers
property of theorg.jasig.cas.authentication.AuthenticationManagerImpl
bean. Add the LDAP fast bind authentication handler to the
authenticationHandlers
property of theauthenticationHandler
bean:Code Block xml xml <bean class="org.jasig.cas.adaptors.ldap.FastBindLdapAuthenticationHandler" > <property name="filter" value="uid=%u,ou=system" /> <property name="contextSource" ref="contextSource" /> </bean>
- Add the
cas-server-support-ldap-$VERSION.jar
from the CAS installation to$TOMCAT_HOME\webapps\cas-server-webapp-$VERSION\WEB-INF\lib
. - Add the
spring-ldap-X.Y.Z.RELEASE-all.jar
to$TOMCAT_HOME\webapps\cas-server-webapp-$VERSION\WEB-INF\lib
. It can be downloaded from http://www.springsource.org/ldap.X.Y.Z
should correspond to latest version. - Start tomcat and confirm there are no errors in the
$TOMCAT_HOME\logs\catalina.out
log. - Open a browser to the URL http://localhost:8080/cas-server-webapp-$VERSION/ and authenticate with the following credentials,
admin/secret
.