Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Warning
titleSee uPortal Manual for documentation for the impatient

As of uPortal ~2.5.2, uPortal ships with all the libraries you need and working commented out example configuration for simple CAS integration. This is documented in the uPortal manual wiki. This no-frills guide approach can work but involves more heroics than is minimally required.

No frills guide to making uPortal use CAS for login authentication

Right now, you don't want to know how it works, what your options are, about proxy tickets, or about why it is the way it is: you just want it to work.

Getting it

Download cas-security-provider 3.0.0x
Use a recent JRE 1.4. I don't think CAS Java Client 2.1.0 will run under JRE 1.3 or earlier, but I haven't tried.

...

Unzip the cas-security-provider distribution.
Unzip the Java CAS Client distribution.
Stop your web container (Tomcat, e.g.)
Copy the cas-security-provider.jar and the casclient.jar files into the lib directory of your uPortal instance as deployed into your web container.

...

Code Block
xml
xml
<filter>
  <filter-name>CAS Validate Filter</filter-name>
  <filter-class>edu.yale.its.tp.cas.client.filter.CASValidateFilter</filter-class>
  <init-param>
    <param-name>edu.yale.its.tp.cas.client.filter.validateUrl</param-name>
    <param-value>https://secure.its.yale.edu/cas/serviceValidate</param-value>
  </init-param>
  <init-param>
    <param-name>edu.yale.its.tp.cas.client.filter.serverName</param-name>
    <param-value>hkg2.cis.yale.edu:8080</param-value>
  </init-param>
  <init-param>
    <param-name>edu.yale.its.tp.cas.client.filter.proxyCallbackUrl</param-name>
    <param-value>https://hkg2.cis.yale.edu/uPortal/CasProxyServlet</param-value>
  </init-param>
</filter>

<filter>
  <filter-name>CAS Receipt Cacher</filter-name>
  <filter-class>edu.yale.its.tp.cas.client.filter.StaticCasReceiptCacherFilter</filter-class>
</filter>

<filter-mapping>
  <filter-name>CAS Validate Filter</filter-name>
  <url-pattern>/Login</url-pattern>
</filter-mapping>

<filter-mapping>
  <filter-name>CAS Receipt Cacher</filter-name>
  <url-pattern>/Login</url-pattern>
</filter-mapping>

...