Identity Management Services

1. Prerequisites

• Supported SSL Capable (HTTPS) Server, either Apache/Tomcat or standalone Tomcat

• VeriSign or Thawte certificate for the server

• Tomcat must support Servlet Filters (version 4 or later)

2. Get and install the application libraries

You may download the application library at
     http://www.aims.ku.edu/argus-client/argusfilter-2.4.2.jar

To install Argus for use by several applications on your server, the argusfilter.jar file in the dist directory must be copied to the shared/lib directory in your Tomcat installation. If you do not already have log4j installed, the log4j-1.2.9.jar must be copied to the common/lib directory of your Tomcat installation.

To install Argus for use by a single application, the two jar files mentioned above must be in the WEB-INF/lib directory for the application.

In either case, you will need to add some text to your WEB-INF/web.xml file.

3. Contact Identity Management Services and discuss your application

You will need to contact Identity Management Services at argus@ku.edu to decide what information you need to authorize users for your application. You may need permission from Human Resources or the University Registrar to receive this data. Identity Management Services will figure out what you need to do to get going.

You will need a local Argus SSL certificate generated to identify your application to the backend login server cgi. Identity Management Services will generate this for you and help you get it installed for your application.

They will also authorize your application to use the Argus login server.

4. Test the Installation

Add something like the following to your WEB-INF/web.xml:

<!-- Register the name "ArgusFilter" for ArgusFilter. -->
<filter>
    <filter-name>ArgusFilter</filter-name>
    <filter-class>edu.ku.middleware.argus.resource.ArgusFilter</filter-class>
</filter>

<!-- Apply ArgusFilter to JSP pages. -->
<filter-mapping>
    <filter-name>ArgusFilter</filter-name>
    <url-pattern>*.jsp</url-pattern>
</filter-mapping>

Download argusfiltertest.jsp, put it in your application directory, and open the page in a web browser. It should redirect to an Argus login page, unless your browser is already logged in. After logging in, it should display your KU Online ID if your application receives it. It should also display all the attributes your application is registered to receive from Argus.

If it does not seem to be working correctly there is probably a problem of some sort with the Argus authorization. Email a description of the problem and any error messages to argus@ku.edu.