|Applies To||Federated Identity Management Module 3.1|
|Cause||When an exception is thrown by an RSA FIM server it may display this as a Java stack trace on the browser of the user. This exception can be handled and passed to any other service to either display well formatted or to perform some other custom processing.|
This solution does not resolve or remove any exception which may occur on your FIM server; rather this is a mechanism to be able to manage exceptions when they occur and to avoid error messages being displayed to end-users. The solution has an expanded usage where it is possible to enhance the use of FIM to be able to cater for specific functionality. As an example it is possible that an IdP may send a SAMLResponse with a logon failure as the message; the supplied RSA FIM product will generate an exception for this condition and display it to the end user, for example:
In this instance a handler might be written to monitor specifically for this type of exception but then deal with the following events without errors (for example just redirecting the user to their public web page or a web page saying "since you cancelled the logon process you are not admitted)
There are three different locations where an Error URL can be set:
In all situations the URL cannot contain any custom CGI parameters and must only be a basic HTTP reference.
As an example you might set the following in fim.properties:
Then as a further example a deployed page displayerror.jsp might have the following, simple content:
Note: The use of both fim.global.error.url and the ability to set the Error URL at an association level have both been enhancements to FIM 3.1 and may require you to upgrade you system to FIM .3.1.2 to be able to take advantage of newer features.
More information is available the appropriate documentation which is also available in SecurCare Online:
RSA Federated Identity Manager 3.1 Installation & Configuration Guide
RSA Federated Identity Manager 3.1 Planning Guide
RSA Federated Identity Manager 3.1 Developer's Documentation
RSA Federated Identity Manager 3.1.2 Installation and Configuration Guide
|Legacy Article ID||a38542|