Customizable email notifications
PingFederate delivers messages to administrators and end-users based on customizable notification publisher settings.
Each component that is capable of triggering or handling events can use a different notification publisher instance to deliver its messages. For example, you can select an SMTP Notification Publisher instance to deliver messages to your end users in an HTML Form Adapter instance and another SMTP Notification Publisher instance to deliver licensing messages to your fellow administrators.
When a component is configured to deliver its messages based on an SMTP Notification Publisher instance configuration, PingFederate creates notification messages based on template files located in the <pf_install>/pingfederate/server/default/conf/template/mail-notifications
directory. Each template file is a combination of variables and HTML codes. You can modify these template files in a text editor to suit the particular branding requirements, as needed.
Each template contains specific variables that can be used for rendering the associated web page. You can see the variables and usage examples in the comments of each template.
The following table describes variables that are available across all templates.
Variable | Description and Usage | ||
---|---|---|---|
utils- utility class |
The utility method to display JSON String arrays. |
||
$escape |
A utility class that can be used to escape String variables inserted into the template, such as Use
|
||
$HttpServletRequest |
A Java object instance of |
||
$HttpServletResponse |
A Java object instance of |
||
$locale |
A Java object instance of |
||
$CurrentPingFedBaseURL |
The host name found in the request, provided that it matches either the PingFederate’s base URL or one of the configured virtual host names. |
||
$PingFedBaseURL |
The PingFederate base URL. For most deployments, use the $CurrentPingFedBaseURLvariable instead of the $PingFedBaseURL variable. |
||
$templateMessages |
Used to localize messages in the template, based on user’s Locale, an instance of |
||
$TrackingId |
The user’s session tracking ID. |
The following describes variables that are available on some templates.
Variable | Description |
---|---|
$entityId |
The entity ID (connection ID) of the SP connection used in this SSO transaction. |
$connectionName |
The name of the SP Connection used in this SSO transaction. |
$client_id |
The ID of the OAuth client used in this transaction. |
$spAdapterId |
The SP Adapter ID used in this transaction. |
$baseUrl |
The base URL of PingFederate instance. |
$adapterId |
The IdP Adapter ID used in this transaction. |
$oidcUiLocales |
The value of the OpenID Connect |
$extendedProperties |
The extended properties defined on either the connection or OAuth client. |
$userAttributes |
The user-specific data, such as the user’s display name or email address, retrieved from the password credential validator (PCV) used in this transaction. |
$grantAttributes |
The attributes of the grant used in this transaction. |
If you have a clustered PingFederate environment, copy the customized templates to each node. |
You can also configure a component to use an Amazon SNS Notification Publisher instance to deliver notification messages. If so, refer to Configuring an Amazon SNS Notification Publisher instance and Event types and variables for more information about this messaging model and the handling of notification messages. |