----
h1. WebSSO 1.3 Developers Guide

The Web Single Sign-On/Sign-Out Client (WebSSO Client) is distributed both as a standalone project and a component other projects (such as caGrid). The Developers Guide covers the necessary steps to integrate a WebSSO client (Jasig Client, Acegi Client, Liferay Portal Client) into an existing web application. This guide provides guidance to integrate a WebSSO client into a web application server to make it WebSSO enabled. (e.g., integrate WebSSO client into the popular Liferay application server to WebSSO-enable the server).

Each distribution contains *websso-client* directory, herein referred to as WEBSSO_CLIENT_LOCATION. To install and configure the WebSSO Client, please follow the steps below.


h2. Step 1: Install Prerequisite Software
----
In order to install and run the WebSSO, the following pre-requisite software must be installed:
* [Java 1.5 JDK|http://java.sun.com/j2se/1.5.0/system-configurations.html]
* [Ant 1.6.5|http://archive.apache.org/dist/ant/binaries/apache-ant-1.6.5-bin.zip]
* [Globus WS-Core with WS-Enum Support|http://gforge.nci.nih.gov/frs/download.php/1334/ws-core-enum-4.0.3.zip]

The WebSSO Server has been configured and installed. The URL to this server would be used for configuring the WebSSO Client. Make sure *host-identity* of WebSSO Client was added as delegated application in websso-properties.xml for WEBSSO-Server. Details on how to install and configure a WebSSO Server can be found at following location \[WebSSO Administrators Guide\|websso13:Administrators Guide

Also, the target web application is a standard Java Web Application packaged in a war file. Details about a creating and packing a J2EE Web Application can be found on Sun's site at [Packaging Web Components|http://java.sun.com/j2ee/tutorial/1_3-fcs/doc/WebComponents3.html]

h2. Step 2: Building WebSSO Client
----
If you have obtained a source release of the WebSSO Client, you will need to build it. Type the following from a command prompt:
{noformat}%> cd WEBSSO_CLIENT_LOCATION
%> ant clean all
{noformat}
{info}Depending on the the WebSSO Client distribution, it may be required to build the entire project that the WebSSO Client is distributed with prior to building the WebSSO Client. For example, if you have obtained a caGrid source distribution, this is required. If you received a WebSSO Client standalone distribution, this is not required.
{info}
h2. Step 3: Obtain a Host Credential
----
The WebSSO Client provides capability to retrieve user's delegated credentials by connecting to the Credentials Delegation Service ([CDS|cds:home]). To use this feature, a host credential needs to be obtained for the container/server hosting the web application which will integrate with WebSSO Client. A host credential consist of an X.509 certificate and private key [Dorian|dorian:home] provides the ability to issue and manage host credentials. There are many methods of retrieving host credentials, including:
# Requesting a credential from a known/trusted certificate authority ([caGrid Certificate Authority|portal22:Request a Host Certificate]).
# Standing up a [Dorian|dorian13:Administrators Guide] service.
# Standing up a simple certificate authority.

Once a host credentials are obtained and stored on the server, the path to the certificate file and the key file should be noted. This will be used to configure the Delegation Lookup filter.


h2. Step 4: Configure Server to Trust the Certificate Authority
----
To connect to the Credential Delegation Service ([CDS|cds:home]), one must configure the server hosting the Web Application to trust the CA that issued the host credentials obtained in the previous step.

{info}{*}NOTE:* if you opt to start syncGTS programmatically execute the following. For detailed steps refer Step 7 and Step 8.
{info}In order for SyncGTS to 'sync' up the CA certificates on the server hosting the web application, the master GTS Certificate Authority .0 file must be copied from GTS to the server.
Copy the MASTER GTS CA.0 file from the GTS server that is at the $HOME/.globus/certificates to the $HOME/.globus/certificates folder on the server hosting the Web Application.

{info}{*}Note:* if you don't opt to start syncGTS programatically execute the following. For detailed steps refer Step 7 and Step 8.
{info}Place a copy of the certificate for the CA that issued the host credentials in the Globus trusted certificates directory. Unless otherwise specified during installation, this is usually _USER_HOME/.globus/certificates_. Globus requires all CA certificates in its trusted certificates directory to be in PEM format and to have a digit extension (0-9). For example, if a CA certificate is stored in the file _cacert.pem_, it should be copied to the directory _USER_HOME/.globus/certificates_ (create directory if needed) with the file name "_cacert.0_"

h2. Step 5: Create Host Credential Keystore
----
# Download and unzip [gridca|http://bmi.osu.edu/~langella/downloads/websso-1.2M1/gridca-tools.zip].
# Bring up a command prompt and change to the *gridca* directory which you recently unzipped.
# At the command line type *ant createTomcatKeystore*, this will execute a command line program which will guide you through creating the keystore.
# In the *Enter a location and name for your keystore:* prompt enter a file name and location to create your keystore.
# In the *Enter a password for your keystore:* prompt enter a password for your keystore.
# In the *Enter the location of the certificate (PEM format):* prompt enter the location of the host certificate you just created.
# In the *Enter the location of the private key (PEM format)* : prompt enter the location of the private key you just created.
# In the *Enter the current password of the private key:* prompt enter the password for your private key, if you private key does not have a password (most cases) just hit enter.
# At this point the program will create your keystore at the location you specified. Below is a sample output of the program just described:

{noformat}Enter a location and name for your keystore:mykeystore
Enter a password for your keystore:password
Enter the location of the certificate (PEM format):C:/Documents and Settings/user_account/host-cert.pem
Enter the location of the private key (PEM format):C:/Documents and Settings/user_account/host-key.pem
Enter the current password of the private key:
{noformat}
h2. Step 6: Configuring Tomcat
----
Since the WebSSO Client would be running using SSL we need to configure Tomcat to enable SSL. To do so complete the following:
# Edit the file *CATALINA_HOME/conf/server.xml* (example shown below).
# Uncomment connector element for port 8443 (SSL)
# Add a *keystoreFile* parameter containing the location of the keystore you just created.
# Add *keystorePass* parameter containing the the password of the keystore you just created.
# Restart tomcat
{noformat}<!-- Define a SSL HTTP/1.1 Connector on port 8443 -->
<Connector port="8443" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS"
keystoreFile="C:/Documents and Settings/user_account/mykeystore"
keystorePass="password" />
{noformat}

h2. Step 7: Integrating the WebSSO Client
----
Once host credentials have been obtained, you can integrate the WebSSO Client into your Web Application. The WebSSO Client is released as a set of jar and configuration files found in WEBSSO_CLIENT_LOCATION/build folder.

{code}applicationContext-jasig-1.3-dev.xml
cas-client-template-jasig-1.3-dev.properties
web-template-jasig-1.3-dev.xml
{code}The WEBSSO_CLIENT_LOCATION/build contains the following three configuration files:

# The *applicationContext-jasig-1.3-dev.xml* file is a spring configuration files which contains the configuration setting for CAS Filters which are packaged as part of WebSSO Client. Rename this file to *applicationContext.xml* and copy to WEBAPP_LOCATION/WEB-INF folder.
# Then *cas-client-template-jasig-1.3-dev.properties* is the file which contains configuration for connecting to the Central CAS Single Sign On Server. Rename this file to *cas-client.properties*, resolve the tokens *@WEBSSO.SERVER@*, *@WEBSSO.SERVER.HTTPS.PORT@*, *@WEBSSO.CLIENT.SERVER@* and *@WEBSSO.CLIENT.HTTP.PORT@* with respective values and copy to WEBAPP_LOCATION/WEB-INF/classes folder
# The *web-template-jasig-1.3-dev.xml* is a sample file provided to show entries which needs to be made to your web.xml file to enable the WebSSO Client capabilities in your application. Rename the file to *web.xml* and resolve the tokens *@WEBSSO.CLIENT.HOST.CERTIFICATE@* and \*@WEBSSO.CLIENT.HOST.KEY@.

h3. Step 7.1: Configuring the cas-client.properties File

The cas client is configured through a properties file: *WEBSSO_CLIENT_LOCATION/build/cas-client-template-jasig-1.3-dev.properties*. Below is an template of the cas-client-template-jasig-1.3-dev.properties file, followed by a description of each of the properties:

{noformat}cas.server.gateway=false
cas.server.renew=false
cas.server.url=https://@WEBSSO.SERVER@:@WEBSSO.SERVER.HTTPS.PORT@/webssoserver/
cas.client.service=http://@WEBSSO.CLIENT.SERVER@:@WEBSSO.CLIENT.HTTP.PORT@/webssoclientjasigexample-1.3-dev/protected/
{noformat}{*}cas-client.properties*
# *cas.server.gateway* \- This is a property indicating whether the login screen should be displayed to the user or not. This option should be always set to 'false'.
# *cas.server.renew* \- This is a property if set to true would require the user to login again irrespective of whether the Single Sign On session has been established or not. For general use, this should be set to 'false'. *Note* If you want to log into another application within the SSO realm without providing your credentials again, this property should be set to 'true'
# *cas.server.url* \- This is the URL to the WebSSO's CAS Server. *Note* The CAS Server is generally installed in a secured container as a result of which the URL should have 'https'.
# *cas.client.service* \- This is the URL to the WebSSO client server.
An example file is show below

{noformat}cas.server.gateway=false
cas.server.renew=false
cas.server.url=https://localhosta:8443/webssoserver/
cas.client.service=http://localhostb:18080/webssoclientjasigexample-1.3-dev/protected/
{noformat}Here *localhosta* is hosting the CAS Central Single Sign On Server and *localhostb* is hosting client application.
{info}{*}Note* \- Also since both the applications are assumed to be running securely hence the default SSL ports for tomcats are shown.
This file should be placed in the *WEB_LOCATION/WEB-INF/* folder of the client web application. {info}
h3. Step 7.2: Modifying the web.xml File

Once the cas-client.properties file is configured, you need to enable the WebSSO Client filters. To do this, make an entry into the web.xml. A sample web.xml is show below. This file can be found in the WEBSSO_CLIENT_LOCATION/build/ location of the WebSSO Client Release:

{code:xml}<?xml version="1.0" encoding="ISO-8859-1"?>

<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">

<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>

<!--
- Location of the Log4J config file, for initialization and refresh checks.
- Applied by Log4jConfigListener.
-->
<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>/WEB-INF/classes/log4j.properties</param-value>
</context-param>

<context-param>
<param-name>log4jExposeWebAppRoot</param-name>
<param-value>false</param-value>
</context-param>

<filter>
<filter-name>CAS Client Info Logging Filter</filter-name>
<filter-class>org.inspektr.common.web.ClientInfoThreadLocalFilter</filter-class>
</filter>

<filter>
<filter-name>CAS Single Sign Out Filter</filter-name>
<filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class>
</filter>

<filter>
<filter-name>CAS Authentication Filter</filter-name>
<filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
<init-param>
<param-name>targetBeanName</param-name>
<param-value>casAuthenticationFilter</param-value>
</init-param>
</filter>

<filter>
<filter-name>CAS Validation Filter</filter-name>
<filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
<init-param>
<param-name>targetBeanName</param-name>
<param-value>casValidationFilter</param-value>
</init-param>
</filter>

<filter>
<filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
<filter-class>org.jasig.cas.client.util.HttpServletRequestWrapperFilter</filter-class>
</filter>

<filter>
<filter-name>caGRID WebSSO Attribute Loader Filter</filter-name>
<filter-class>org.cagrid.websso.client.filter.CaGridWebSSOAttributeLoaderFilter</filter-class>
</filter>

<filter>
<filter-name>caGRID WebSSO Delegation Lookup Filter</filter-name>
<filter-class>org.cagrid.websso.client.filter.CaGridWebSSODelegationLookupFilter</filter-class>
<init-param>
<param-name>certificate-file-path</param-name>
<param-value>@WEBSSO.CLIENT.HOST.CERTIFICATE@</param-value>
</init-param>
<init-param>
<param-name>key-file-path</param-name>
<param-value>@WEBSSO.CLIENT.HOST.KEY@</param-value>
</init-param>
</filter>

<filter>
<filter-name>caGRID WebSSO Logout Filter</filter-name>
<filter-class>org.cagrid.websso.client.filter.CaGridWebSSOLogoutFilter</filter-class>
<init-param>
<param-name>cas-client-property-file</param-name>
<param-value>cas-client.properties</param-value>
</init-param>
</filter>

<filter-mapping>
<filter-name>CAS Single Sign Out Filter</filter-name>
<url-pattern>/protected/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>CAS Authentication Filter</filter-name>
<url-pattern>/protected/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>CAS Validation Filter</filter-name>
<url-pattern>/protected/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
<url-pattern>/protected/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>caGRID WebSSO Attribute Loader Filter</filter-name>
<url-pattern>/protected/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>caGRID WebSSO Delegation Lookup Filter</filter-name>
<url-pattern>/protected/*</url-pattern>
</filter-mapping>

<filter-mapping>
<filter-name>caGRID WebSSO Logout Filter</filter-name>
<url-pattern>/logout/*</url-pattern>
</filter-mapping>

<listener>
<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
</listener>

<listener>
<listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class>
</listener>

<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<servlet-name>Start Auto Sync GTS</servlet-name>
<servlet-class>org.cagrid.websso.common.StartSyncGTSServlet</servlet-class>
<init-param>
<description></description>
<param-name>start-auto-syncgts</param-name>
<param-value>no</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet>
<servlet-name>jsp</servlet-name>
<servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
<init-param>
<param-name>fork</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>xpoweredBy</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>mappedfile</param-name>
<param-value>true</param-value>
</init-param>
<init-param>
<param-name>compilerTargetVM</param-name>
<param-value>1.5</param-value>
</init-param>
<init-param>
<param-name>compilerSourceVM</param-name>
<param-value>1.4</param-value>
</init-param>
<load-on-startup>2</load-on-startup>
</servlet>

<servlet>
<servlet-name>TestUserInfoServlet</servlet-name>
<servlet-class>test.TestUserInfoServlet</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>TestUserInfoServlet</servlet-name>
<url-pattern>/protected/testuser</url-pattern>
</servlet-mapping>

</web-app>
{code}Following are the entries in the web.xml file which should be added to the Client Web Application's web.xml file:

*Start-up Entries*
# *Start Auto Sync GTS* \- This entry is to load the "org.cagrid.gaards.websso.client.utils.StartSyncGTSServlet" Servlet on start up. This Servlet uses the sync-description.xml file from the classpath and starts the SyncGTS Daemon. If the target application doesnt want to automatically start the SyncGTS Daemon then they should remove this entry from the web.xml or edit the param value to no eg: <param-value>no</param-value>.

{info}{*}NOTE:* Depending on how many start up servlets are configured for your application you would need to give appropriate number (based on start up order) to the *load-on-startup* entry
{info}{*}Other Entries*
# *contextConfigLocation* \- This entry is to define the spring based *applicationContext.xml* file entry which is needed by the CAS Client. This entry should be copied as it is in the client web application's web.xml file
# *listener-class* \- This entry points to the listener class which should be used. *org.jasig.cas.client.session.SingleSignOutHttpSessionListener* listener enables the CAS Single Sign out feature.

*Filter Entries*
# *CAS Authentication Filter* \- This is the entry for the CAS Authentication Filter. This filter checks if the User's Single Sign On Session has been established or not. This entry should be copied as it is in the client web application's web.xml file
# *CAS Validation Filter* \- This is the entry for the CAS Validation Filter. This filter validates the User's Authentication Session and then retrieve User's Attributes from the Central CAS Single Sign On Server. This entry should be copied as it is in the client web application's web.xml file
# *caGRID WebSSO Attribute Loader Filter* \- This is the entry for the caGRID WebSSO Attribute Loader Filter. This filter reads the attributes which are retrieved from the Central CAS Single Sign On Server and loads each of them into the HTTP Session. This entry should be copied as it is in the client web application's web.xml file
# *caGRID WebSSO Delegation Lookup Filter* \- This is the entry for the caGRID WebSSO Delegation Lookup Filter. This filter connects to the Credential Delegation Service ([CDS|cds:home]) using the Client Application's Host Credentials and retrieves the User's Grid Credentials. It then stores the retrieved User's Grid Credentials into the session as a session attribute. This filter need two parameter pointing to the certificate and the key file for the Client Application's Host Credential.
## *certificate-file-path* \- points to the certificate file for the Client Application's Host Credentials.
## *key-file-path* \- points to the key file for the Client Application's Host Credentials.
# *caGRID WebSSO Logout Filter* \- This is the entry for the caGRID WebSSO Logout Filter. This filter connects to the WebSSO Server and issues a logout call. On receiving this logout the CAS Server terminates the SSO Session and issues a call to the Credential Delegation Service ([CDS|cds:home]) to destroy user's delegation policy.

{info}{*}Note* These filters have to be defined in the above mentioned order as each is dependent on previous filter.
{info}Once these filters are defined, a mapping must be provided for them. In the sample shown, it is mapped to *protect* everything within the web context root of the application. If you want to protect anything within a specific context URL, you need to provide that entry.

h2. Step 8: Copying Sync Description File
----
In order to sync with the Grid Trust Fabric, the WebSSO Server needs a sync-description.xml file in its classpath to start SyncGTS programatically if the *Start Auto Sync GTS* Servlet is configured in the web.xml file above. Depending upon the grid you are trying to connect to, you need to obtain the sync-description.xml file from the corresponding Grid Administrator. This file needs to be placed in the classpath within the target application. This can be done by placing the file in the classes folder of the target application web archive (war file).
{info} *NOTE:* if you haven't configure the&nbsp;*Start Auto Sync GTS*&nbsp;start up servlet, then the onus of syncing with the trust fabric relies on the administrator. This can be done manually by starting the syncGTS Daemon on the target web application. For detailed steps refer to&nbsp;[GTS|gts:home] {info}
h2. Step 9: Establish Trust with WebSSO CAS Server
----
In order for the client to trust the WebSSO Server you need to install the WebSSO Server's Public CA Cert into its truststore. This can be done by the following steps
# On the target application server, simply copy the cacerts to cacerts.old (to save it just in case)
# Run the java program given below by giving the following command - run java InstallCert <<CAS_SERVER_ADDRESS>>:<<CAS_SERVER_PORT>> (i.e. provide the argument "<<CAS_SERVER_ADDRESS>>:<<CAS_SERVER_PORT>>" to the executable "InstallCert"). (adapted source code for InstallCert.java from Sun blog by Andreas Sterbenz is shown below)
# Answer 1 to the prompt

{code}/*
* @(#)InstallCert.java 1.1 06/10/09
*
* Copyright 2006 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/


import java.io.*;
import java.net.URL;

import java.security.*;
import java.security.cert.*;

import javax.net.ssl.*;

public class InstallCert {

public static void main(String[] args) throws Exception {
String host;
int port;
char[] passphrase;
if ((args.length == 1) || (args.length == 2)) {
String[] c = args[0].split(":");
host = c[0];
port = (c.length == 1) ? 443 : Integer.parseInt(c[1]);
String p = (args.length == 1) ? "changeit" : args[1];
passphrase = p.toCharArray();
} else {
System.out.println("Usage: java InstallCert <host>[:port] [passphrase]");
return;
}

File file = new File("jssecacerts");
if (file.isFile() == false) {
char SEP = File.separatorChar;
File dir = new File(System.getProperty("java.home") + SEP
+ "lib" + SEP + "security");
file = new File(dir, "jssecacerts");
if (file.isFile() == false) {
file = new File(dir, "cacerts");
}
}
System.out.println("Loading KeyStore " + file + "...");
InputStream in = new FileInputStream(file);
KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());
ks.load(in, passphrase);
in.close();

SSLContext context = SSLContext.getInstance("TLS");
TrustManagerFactory tmf =
TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
tmf.init(ks);
X509TrustManager defaultTrustManager = (X509TrustManager)tmf.getTrustManagers()[0];
SavingTrustManager tm = new SavingTrustManager(defaultTrustManager);
context.init(null, new TrustManager[] {tm}, null);
SSLSocketFactory factory = context.getSocketFactory();

System.out.println("Opening connection to " + host + ":" + port + "...");
SSLSocket socket = (SSLSocket)factory.createSocket(host, port);
socket.setSoTimeout(10000);
try {
System.out.println("Starting SSL handshake...");
socket.startHandshake();
socket.close();
System.out.println();
System.out.println("No errors, certificate is already trusted");
} catch (SSLException e) {
System.out.println();
e.printStackTrace(System.out);
}

X509Certificate[] chain = tm.chain;
if (chain == null) {
System.out.println("Could not obtain server certificate chain");
return;
}

BufferedReader reader =
new BufferedReader(new InputStreamReader(System.in));

System.out.println();
System.out.println("Server sent " + chain.length + " certificate(s):");
System.out.println();
MessageDigest sha1 = MessageDigest.getInstance("SHA1");
MessageDigest md5 = MessageDigest.getInstance("MD5");
for (int i = 0; i < chain.length; i++) {
X509Certificate cert = chain[i];
System.out.println
(" " + (i + 1) + " Subject " + cert.getSubjectDN());
System.out.println(" Issuer " + cert.getIssuerDN());
sha1.update(cert.getEncoded());
System.out.println(" sha1 " + toHexString(sha1.digest()));
md5.update(cert.getEncoded());
System.out.println(" md5 " + toHexString(md5.digest()));
System.out.println();
}

System.out.println("Enter certificate to add to trusted keystore or 'q' to quit: [1]");
String line = reader.readLine().trim();
int k;
try {
k = (line.length() == 0) ? 0 : Integer.parseInt(line) - 1;
} catch (NumberFormatException e) {
System.out.println("KeyStore not changed");
return;
}

X509Certificate cert = chain[k];
String alias = host + "-" + (k + 1);
ks.setCertificateEntry(alias, cert);

OutputStream out = new FileOutputStream(file);
ks.store(out, passphrase);
out.close();

System.out.println();
System.out.println(cert);
System.out.println();
System.out.println
("Added certificate to keystore 'cacerts' using alias '"
+ alias + "'");
}

private static final char[] HEXDIGITS = "0123456789abcdef".toCharArray();

private static String toHexString(byte[] bytes) {
StringBuilder sb = new StringBuilder(bytes.length * 3);
for (int b : bytes) {
b &= 0xff;
sb.append(HEXDIGITS[b >> 4]);
sb.append(HEXDIGITS[b & 15]);
sb.append(' ');
}
return sb.toString();
}

private static class SavingTrustManager implements X509TrustManager {

private final X509TrustManager tm;
private X509Certificate[] chain;

SavingTrustManager(X509TrustManager tm) {
this.tm = tm;
}

public X509Certificate[] getAcceptedIssuers() {
throw new UnsupportedOperationException();
}

public void checkClientTrusted(X509Certificate[] chain, String authType)
throws CertificateException {
throw new UnsupportedOperationException();
}

public void checkServerTrusted(X509Certificate[] chain, String authType)
throws CertificateException {
this.chain = chain;
tm.checkServerTrusted(chain, authType);
}
}

}
{code}
h2. Step 10: Retrieving User Attributes Inside Client Application
----
Once the WebSSO Client has been configured, you need to program your application to retrieve the session attributes which are injected by the WebSSO Client. Following is the list of session attributes which hold values of the corresponding User Attributes:
{table:id=cagridtable}
{table-row}{table-cell:align=center}{table-cell}{table-row}
{table-row}{table-cell}|| Session Attribute Name || Information ||
| CAGRID_SSO_GRID_IDENTITY | User's Grid Identity |
| CAGRID_SSO_FIRST_NAME | User's First Name |
| CAGRID_SSO_LAST_NAME | User's Last Name |
| CAGRID_SSO_EMAIL_ID | User's Email Id |
| CAGRID_SSO_DELEGATION_SERVICE_EPR | Delegation Service's End Point Reference |
| CAGRID_SSO_GRID_CREDENTIAL | User's Grid Credential |
{table-cell}
{table-row}
{table}These attributes can be retrieved from the HTTP Session programmatically by specifying the individual session attribute name. Below is anexample servlet which retrieves all the attribute and prints them on the screen.

{code}package test;
import java.io.*;


import javax.servlet.http.*;
import javax.servlet.*;

public class TestUserInfoServlet extends HttpServlet {
private static final long serialVersionUID = 1L;

public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// Returns a writer to write to the browser
PrintWriter out = response.getWriter();
out.println("<br>");
out.println("<<<<< ATTRIBUTE NAME >>>>> CAGRID_SSO_GRID_IDENTITY <<<<< ATTRIBUTE VALUE >>>>> " +
request.getSession().getAttribute("CAGRID_SSO_GRID_IDENTITY"));

out.println("<br>");

out.println("<<<<< ATTRIBUTE NAME >>>>> CAGRID_SSO_FIRST_NAME <<<<< ATTRIBUTE VALUE >>>>> " +
request.getSession().getAttribute("CAGRID_SSO_FIRST_NAME"));

out.println("<br>");

out.println("<<<<< ATTRIBUTE NAME >>>>> CAGRID_SSO_LAST_NAME <<<<< ATTRIBUTE VALUE >>>>> " +
request.getSession().getAttribute("CAGRID_SSO_LAST_NAME"));

out.println("<br>");

out.println("<<<<< ATTRIBUTE NAME >>>>> CAGRID_SSO_EMAIL_ID <<<<< ATTRIBUTE VALUE >>>>> " +
request.getSession().getAttribute("CAGRID_SSO_EMAIL_ID"));

out.println("<br>");

out.println("<<<<< ATRIBUTE NAME >>>>> CAGRID_SSO_DELEGATION_SERVICE_EPR <<<<< ATTRIBUTE VALUE >>>>> " +

request.getSession().getAttribute("CAGRID_SSO_DELEGATION_SERVICE_EPR"));

out.println("<br>");

out.println("<<<<< ATTRIBUTE NAME >>>>> CAGRID_SSO_GRID_CREDENTIAL <<<<< ATTRIBUTE VALUE >>>>> " +
request.getSession().getAttribute("CAGRID_SSO_GRID_CREDENTIAL"));

out.println("<br>");
}
}
{code}