APL RSSO Transformation Plugin
This plugin allows BMC’s RSOO tool to do custom transformations. The plugin currently supports both Remedy and File as sources. I wrote it to help out my DOD friends. Typically, when you are authenticating via a CAC, the CAC doesn’t contain information that you necessarily want to have as the login id of your Remedy user, so the question arose, how do I transform the CAC information into a human understandable thing. You can typically use the CN, DN, UID, or maybe even the email address, but more than likely you don’t want to use that information for your Remedy Login ID. That’s where this plugin comes in. What this plugin does is after authentication with your source, it will take the ID that’s passed to it, and allow you to transform that ID into something else.
If using file based transformation, it’s as simple as providing a list of from/to values that the plugin will use. If using Remedy as your source the plugin supports two very flexible transformation routines. You can provide it with the Remedy connection credentials, tell it what form contains the transformation information, the input field and the output field, providing it with either Query or Service as the type of lookup. If doing Query it will simply search for the value you provided, if doing Service it’ll make a Service call to the specified form. With this simple information, the transformation can turn any value stored in a Remedy table into another value of your choice. This greatly enhances your ability to transform system codes into user variables. If this plugin has any issues with ANY part of the process, it simply returns the inputFieldID as the output, so if you find that there are issues with the transformation not happening, check the config and check your source form for properties transformation data
Installation of the plugin is simple as dictated on the BMC docs page
https://docs.bmc.com/docs/rsso1908/creating-user-id-custom-transformation-types-914865693.html
Step 1: Copy the APLRSSOTransformation.jar file to the following directory: /tomcat/webapps/rsso/WEB-INF/lib
Step 2: Copy the APLRSSOTransformation.properties file into the Tomcat conf folder
Step 3: Edit the APLRSSOTransformation.properties to properly do the transformations you need
Step 4: Restart your RSSO Server
Step 5: Configure the realm to use the newly installed Transformation
Version History
3.0 – March 4, 2020
- Added a Remedy transformation method that allows you to change from ‘Query’ to ‘Service’ thus allowing you to build Filters on your chosen form to do any additional transformation you deem necessary
2.0 – February 22, 2020
- Added ‘File’ transformation source as an option, and updated the docs
- Changed the location of the properties file from matching the .jar to into the conf folder
1.3 – December 6, 2019
- Added additional transformation options to the properties file of RemoveDomain, RemoveEmailDomain, ToLower, and ToUpper. All of these transformations happen to the value returned from RSSO before the lookup is done in Remedy
1.2 – February 11, 2019
- Added RPC Port capabilities
1.1 – July 3, 2018
- Updated release providing additional examples and configurable logging
1.0 – May 18th 2017
- Initial release