PingIDM 7.5.0

End User UI notifications

Whenever there are changes related to individual users, IDM sends notifications to those users. When they log in to the End User UI, they can find their notifications by clicking the notification button.

Notifications are configured in notification-event.json files, as described in Custom Notifications.

IDM includes a notifications endpoint that can help you identify all notifications:

curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Accept-API-Version: resource=1.0" \
--request GET \
"http://localhost:8080/openidm/internal/notification?_queryFilter=true"

To list notifications by user ID, include the _notifications field in a query on that ID:

curl \
--header "X-OpenIDM-Username: openidm-admin" \
--header "X-OpenIDM-Password: openidm-admin" \
--header "Accept-API-Version: resource=1.0" \
--request GET \
"http://localhost:8080/openidm/managed/user/e3a9385b-733f-4a1c-891b-c89292b30d70?_fields=_notifications/*"

You can filter notifications with any of the properties shown in the following table:

End User Notification Properties
Property Description

createDate

Creation date

notificationType

Message type: limited to info, warning, or error

message

Message seen by the end user

You can get additional information from the activity audit log, in the audit/activity.audit.json file, including the following:

  • The userId who made the change.

  • The runAs name of the user who made the change.

  • If configured in Fields to Watch, any watched fields that have changed.

  • If the password was changed, as indicated by the passwordChanged property.