Versions Compared

Key

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

...

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>
  <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 and contextSource bean.
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).

More on Authentication Handlers

...

Add the contextSource bean, which is used to tell CAS about your LDAP server.
Code Block

<beans>
  ...
  <bean id="contextSource" class="org.jasig.cas.adaptors.ldap.util.AuthenticatedLdapContextSource">
    <property name="urls">
      <list>
        <value>ldaps://yourldapserver.yourinstitution.edu/</value>
      </list>
    </property>
  </bean>
  ...
</beans>

...

Note: This bean configuration should be in the same file (deployerConfigContext.xml) - add and customise the above bean definition after the rest of the beans.

Build and deploy the modifications

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

Code Block
ant clean deploy-ear
Restart uPortal

...

uPortal

...

Other considerations

Since If using LDAPS (as in 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

...