Federation Security Services Guide › Authenticate SAML 1.x Users at a Consumer › Customize Assertion Processing with the Message Consumer Plug-in › Integrate the Message Consumer Plug-in for SAML 1.x Authentication

Integrate the Message Consumer Plug-in for SAML 1.x Authentication

After writing a message consumer plug-in, integrate the plug-in with the SAML 1.x authentication scheme.

The instructions for compiling the message consumer plug-in Java file are in the MessageConsumerPluginSample.java file located in sdk/samples/messageconsumerplugin as well as the provided build scripts.

To integrate the message consumer plug-in with the authentication scheme

1. Compile the message consumer plug-in Java file.

   The Java file requires the following .jar file installed with the Policy Server:

   policy_server_home/bin/java/SmJavaApi.jar

2. In the JVMOptions.txt file, modify the -Djava.class.path value so it is set to the classpath for the plug-in. This enables the plug-in to be loaded.

   Note: Do not modify the classpath for SMJavaApi.jar.

3. In the FSS Administrative UI, specify the plug-in that SiteMinder should use. Click Additional Configuration in the SAML Auth Scheme Properties dialog and complete the following fields:
   • Full Java Class Name

     Specify the Java class name for the plug-in, For example, a sample class included with the SiteMinder SDK is:

     com.ca.messageconsumerplugin.MessageConsumerPluginSample

   • Parameter

     Specify a string of parameters to be passed to the plug-in specified in the Full Java Class Name field.

4. Restart the Policy Server.

   Restarting the Policy Server ensures that the latest version of the assertion plug-in is picked up after being recompiled.

Additional information about the message consumer plug-in can be found as follows:

• Reference information (method signatures, parameters, return values, data types) are in the Java Developer's Reference. Refer to the MessageConsumerPlugin interface.
• Overview and conceptual information about authentication and authorization APIs, see the SiteMinder Programming Guide for Java.