Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

The Quick Start distribution Distributions of uPortal includes 3.X.X include a CAS Server, and authenticates using that server which is used by default for portal authentication.

One of the first things you might wish to do is to modify that server to use an existing LDAP server as your authentication data source. Here are the steps required to do that.

Add

...

the CAS-LDAP dependency

...

to

...

uportal-portlets-overlay/cas/pom.xml
Code Block

<dependencies>
...
<dependency>
<groupId>org.jasig.cas</groupId>
<artifactId>cas-server-support-ldap</artifactId>
<version>$
{cas-server.version}</version>
  </version><scope>compile</scope>
  <exclusions>
     <exclusion>
        <groupId>org.inspektr</groupId>
        <artifactId>inspektr-core</artifactId>
     </exclusion>
  </exclusions>
</dependency>
...
Modify

...

uportal-portlets-overlay/cas/src/main/webapp/WEB-INF/deployerConfigContext.xml to include an authentication handler for your LDAP server
Code Block
<property name="authenticationHandlers">
<list>
// ---- add the section below -----
<bean class="org.jasig.cas.adaptors.ldap.FastBindLdapAuthenticationHandler" >
<property name="filter" value="uid=%u,ou=people,dc=yourinstitution,dc=edu" />
<property name="contextSource" ref="contextSource" />
</bean>

In this example, we have chosen to perform a "Fast Bind" against the LDAP server. This requires that you know where users exist in your LDAP Directory Information Tree (DIT).

Update the contextSource, which is used to tell CAS about your LDAP server.
Code Block
<bean id="contextSource" class="org.jasig.cas.adaptors.ldap.util.AuthenticatedLdapContextSource">
<property name="urls">
<list>
<value>ldaps://yourldapserver.yourinstitution.edu/</value>
</list>
</property>
</bean>

...

Build and deploy the modifications

From "the root of your Quick Start uPortal distribution"/uPortal-3.X.X, execute the following command:

Code Block
ant clean deploy-ear
Restart uPortal

From the root of the Quick Startyour uPortal distribution:

Code Block
ant start
Other considerations

Since the example above uses LDAPS, you may need to import the certificate from "yourldapserver" into the JVM on your test portal server. To do that, run the following command to get the certificate

...