02 PubCookie

The following are the steps to integrate PubCookie into uPortal 2.4.x:

1. Download the lastest version http://www.pubcookie.org/ and install in Apache or IIS as documented in PubCookie.
2. In Apache httpd.conf, add the following lines, making the obvious name changes:

   <Location /uPortal/Login>
   AuthType ISUNetID
   AuthName myIowaState
   PubCookieAppID myIowaState
   require valid-user
   </Location>
   
   <LocationMatch /uPortal/Logout.jsp>
   AllowOverride Options
   AuthName myIowaState
   PubCookieAppID myIowaState
   AuthType ISUNetID
   require valid-user
   PubcookieEndSession clearLogin
   </LocationMatch>
   

3. In uPortal/WEB-INF/classes/properties, change the PersonManagerFactory line in portal.properties:

   org.jasig.portal.security.PersonManagerFactory.implementation=org.jasig.portal.security.provider.RemoteUserPersonManager
   

4. In security.properties, change the root lines to:

   root=org.jasig.portal.security.provider.UnionSecurityContextFactory
   root.a=org.jasig.portal.security.provider.RemoteUserSecurityContextFactory
   root.a=org.jasig.portal.security.provider.SimpleSecurityContextFactory
   

5. Edit webpages/stylesheets/org/jasig/portal/channels/CLogin/html.xsl, replacing the textfield and password fields to a link like

   <form action="Login" method="post">
       Welcome to iState.<br/>
       If you have a NetID, please <a href="Login">login</a>.
   </form>
   

6. Deploy the CLogin/html.xsl
7. Restart the portal

When the user clicks on the Login link and has not authenticated, Pubcookie should redirect to the Pubcookie server to
authentication. When authenticated, the user will be redirected back to the Login where the REMOTE_USER variable will
be used to identify the user and the login process will be complete.