PingID Administration Guide

Configuring email notifications

Configure PingID to send an email notification to the user each time a new device is paired to ensure users are aware of every attempt to pair a device with their account and to enable them to report suspected fraud.

There is a separate email template for each device type. The email templates are customizable and can include elements such as branding or specific text. To customize the email, contact your Ping Identity representative.

The following image is an example of the default email notification template.

A screen capture of a PingID email, notifying the user of a newly-added authentication device.

How to report fraud

Notification emails contain a link to report fraud in case the user receives a notification email without having paired a new device.

  • Repeated clicks on the Report Fraud link will trigger the Fraud Reported alert, but will not duplicate an entry in the activity log.

  • The Report Fraud link is valid for up to 30 days.

Administrators can access the details of devices paired by users through the PingID activity report. For more information, see Running the PingID activity report. You can filter the report to view only entries that contain Fraud Reported in the Message column.

How PingID receives the user’s email address

When an authentication activity occurs following the pairing of a device, the PingID server receives the user’s most up-to-date email address from your organization’s identity provider (IdP) and uses it to send the notification email to the user.

To define email addresses, configure the script variables or parameters, as shown in the following table.

Email address source Reference Remarks

RADIUS

PingID RADIUS PCV parameters reference guide

In the General Parameters table, see Multiple Attributes Mapping Rules

PingID API

PingID API - AddUser

See AddUser

AD FS

Configuring advanced settings

See Email Attribute in step 5.

Azure AD

Configuring PingID MFA for Microsoft Azure AD Conditional Access

See step 3d.

PingID for PingFederate

Configuring a PingID Adapter instance

See Email Attribute in step 5.

PingOne SSO stand alone

Connecting to an identity repository

Configuring email notifications

About this task

To enable email notifications when a user pairs a new device:

Steps

  1. Sign on to the admin console.

  2. Go to Setup → PingID → Configuration and go to the DEVICES section. A screen capture of the Devices section in the Configuration tab.

  3. In the EMAIL NOTIFICATION FOR NEW DEVICES section, click Enable.

  4. Click Save.

Result

Users will receive a notification email each time a device is paired with their account or app.