Email customizations - general
Several PingID services send out emails to users.
The email sources are shown in the following table.
Email address source | Reference |
---|---|
RADIUS |
See Multiple Attribute Mapping Rules in the General Parameters table of PingID RADIUS PCV parameters reference guide |
PingID API |
See the Add User section of PingID API - AddUser |
AD FS |
See Email Attribute in step 4 of Configuring advanced settings |
Azure AD |
|
PingID for PingFed |
See Email Attribute in step 5 of Configuring a PingID Adapter instance |
PingOne SSO stand alone |
https://docs.pingidentity.com/bundle/pingone/page/fml1564020492091-2.htmlConnecting to an identity repository] |
Four email customizations are available:
-
Customize the email "From" address to change the default address of
noreply@pingidentity.com
tonoreply@yourdomain.com
. -
Customize the email "Replyto" address to change the default address of
noreply@pingidentity.com
tonoreply@yourdomain.com
. -
Customize the email "Subject" line.
To change items 1 to 3 above, sign on to the Ping Identity Support Portal and open a case.
-
Customize the email message body. PingID supplies templates to customize the body of notification mails. To download the templates, see PingID email templates. Download the
.zip
file and extract it. The includedreadme.txt
file contains a directory list of templates.
Email templates
The downloaded .zip
file contains HTML templates for all PingID notification emails. You can view the files as-is in a web browser.
The HTML templates all use variables (replacement macros), some of which are mandatory and some are optional. The Templates variables and usage table lists each variable. NOTE: If you include images in any of the templates, they must be URL references to publicly available assets. Ping does not host the images used in templates.
After you finish editing your template, contact PingID Customer Support to upload the template.
About the table:
-
Variables are marked as follows:
-
M - mandatory
-
O - optional
-
Blank - irrelevant.
-
-
Variables all take the form
$[.parmname]
{variable_name}````. Mandatory variables must appear in your edited template. -
The table shows the variables visible in the templates. All of the templates have undisplayed variables. The footnotes following the table list the undisplayed values.
-
The variable
${service-provider}
is optional for all files exceptDownload and Pair PinglD.html
. ForNew Email Authentication Request.html
, it is also currently visible.
Template File | Variables | Template usage | ||||||
---|---|---|---|---|---|---|---|---|
${org-name} |
${one-time-passcode} |
${service-provider} |
${activation-code} |
${current-year} |
User Paired New Device of Specific Type |
Pairing |
Remarks |
|
|
M |
O |
O |
Web: Android biometric |
||||
|
M |
O |
O |
Web: iPhone FaceID |
||||
|
M |
O |
O |
Web: Mac Touch ID |
||||
|
M |
O |
O |
Web: Windows Hello |
||||
|
M |
O |
O |
Web: Other biometric |
||||
|
M |
O |
O |
Web: Security key |
||||
|
M |
O |
O |
Android device app |
||||
|
M |
O |
O |
Authenticator app |
||||
|
M |
O |
O |
Desktop app |
||||
|
M |
O |
O |
Authentication by email response |
||||
|
M |
O |
O |
iPhone device app |
||||
|
M |
O |
O |
Authentication by OATH hardware token |
||||
|
M |
O |
O |
Authentication by SMS response |
||||
|
M |
O |
O |
Authentication by voice response |
||||
|
M |
O |
O |
Authentication using a YubiKey |
||||
|
M |
When user clicks Get Download Link during registration |
QR image required |
|||||
|
M |
O |
O |
Pairing code delivery is used when user clicks the Receive passcodes via email button during registration |
One-time passcode sent by email |
|||
|
M |
O (Visible) |
O |
One-time passcode delivery during authentication |
One-time passcode sent by the service provider |
Notes to the table:
-
These files have the following additional optional undisplayed variables
-
${cloudfront-url}
: Image -
${fraud-link}
: Report fraud button
-
-
These files have the following additional optional undisplayed variables
-
${cloudfront-url}
: Image -
${device-name}
-
${device-details}
-
${fraud-link}
: Report fraud button
-
-
These files have the following additional optional undisplayed variables
-
${cloudfront-url}
: Image -
${device-details}
-
${fraud-link}
: Report fraud button
-
-
The
Download and Pair PinglD.html
file has the following additional optional undisplayed variables:-
${download-link-for-iphone-ipad}
: iOS download link -
${download-link-for-android}
: Android download link -
${no-scan-pairing-link}
: Link to Finish Pairing PingID button image -
${qrcode-image}
: Link to QR code image
-
-
These files have the following additional optional undisplayed variable:
-
${download-link-for-android}
: Android download link
-