Before you start
This tutorial describes the process of developing custom Java™ plug-ins for TFIM 6.2. In particular this tutorial guides you through development of a custom security token service (STS) module. It is designed for advanced TFIM users with strong Java development skills who want to learn how to harness the power of the OSGi extension points introduced in TFIM 6.2.
TFIM 6.2 introduces a new way to allow customers to extend the capabilities of the product. Utilizing the same OSGi runtime model as the Eclipse platform, TFIM exposes several "extension points" which allows users to develop their own custom code to run inside TFIM. One of these extension points (STSModule) allows for the development of custom plug-ins for trust service (aka Security Token Service or STS) modules. This tutorial will take you through the complete design / development / deployment cycle for a basic custom trust service mapping module. By following the steps in this tutorial you will learn how to create a custom trust service plug-in for Tivoli Federated Identity Manager (TFIM) 6.2. The example module described here is also available for download with this tutorial.
In this tutorial you will learn about how to develop and deploy a custom plug-in for TFIM 6.2 which implements the
com.tivoli.am.fim.trustserver.sts.STSModule extension point
that is available in TFIM 6.2. You will learn how to design a custom plug-in for your needs and create the module using an appropriate development environment.
Rational Application Developer 7.0 is used throughout this tutorial, however Eclipse 3.2 or later is also a viable development platform for creating these OSGi-based plug-ins.
The tutorial also explains how to deploy and test the plug-in jar file that you have developed into the TFIM 6.2 runtime environment.
This tutorial is written for people who have an advanced level of understanding of Identity Management concepts. You should have prior experience with Tivoli Federated Identity Manager and a good understanding of associated concepts including the TFIM Security Token Service (STS) and trust service modules. A strong knowledge of the Java programming language is also expected.
To work through the examples in this tutorial, you will need an appropriate development environment for creating the module: Rational® Application Developer 7 or Eclipse 3.2 (or later). You will also need a TFIM 6.2 runtime environment for deployment and testing of your module (and to gather jars to setup the development environment).