You can configure PingFederate 7.2 (or a more recent version) to display the tracking ID in the user-facing error Velocity templates. When an error occurs, you can use the tracking ID to look for the related log messages. The Velocity variable is $TrackingId and is available in the following templates:

  • general.error.page.template.html
  • generic.error.msg.page.template.html
  • idp.slo.error.page.template.html
  • idp.sso.error.page.template.html
  • sourceid-wsfed-idp-exception-template.html
  • sp.slo.error.page.template.html
  • sp.sso.error.page.template.html
  • state.not.found.error.page.template.html
Note:

You can find these Velocity template files in the <pf_install>/pingfederate/server/default/conf/template directory.

  1. Open the applicable Velocity template file.
  2. Search for the $TrackingId variable.
  3. Follow the inline instructions to activate the variable.
    Template customization does not require a restart of PingFederate. For a clustered PingFederate environment, repeat these steps on each engine node.

The following screenshot demonstrates the user experience after the $TrackingId variable is activated (and an error has occurred). In this example, V3IwuUsy8PQp-9ZbE9UfUjOEo9c is the tracking ID.

Sample error message with Tracking ID