PingFederate Server

Configuring runtime notifications

Use the PingFederate administrative console to configure and manage runtime notifications. These notifications provide alerts about license status, ensuring uninterrupted server functionality.

About this task

Runtime notifications also provide information about critical certificate events, such as expiration or changes, enabling admins to maintain secure communication. Notifications for SAML metadata updates help admins adapt their configurations and ensure smooth authentication and authorization processes. These runtime notifications ensure compliance, security, and uninterrupted services for users.

Steps

  1. Go to System → Monitoring & Notifications → [.wintitle] Runtime Notifications**.

  2. Optional: Configure licensing events notifications:

    1. Select the Notification for Servers Licensing Events check box.

      This check box appears only if your PingFederate license has an expiration date.

    2. Enter the email address of the intended recipient.

    3. Select a notification publisher instance from the list.

    If you haven’t configured the desired notification publisher instance, click Manage Notification Publishers.

  3. Optional: Configure certificate event notifications:

    1. Select the Notification for Certificate Events check box.

    2. Configure warning event timing:

      • Initial Warning Event (Days): The number of days before a certificate event that PingFederate generates the first notification.

      • Final Warning Event (Days): The number of days before a certificate event that PingFederate generates the final notification.

    3. Select a notification publisher instance from the list.

    Choose from:

    • To send certificate events by email, select Default and enter the email address of the intended recipient in the Email Address field.

    • To record runtime certificate advance warnings in the server.log file, select Logging Only.

      If you select this option, you are not required to set a notification publisher.

  4. Configure certificate expiry administrator console warnings:

    1. In the Days Before Certificate Expiry for Administrator Console Warning field, enter the number of days before a certificate expires that PingFederate issues a notification.

    2. In the Days After Certificate Expiry for Administrator Console Warning field, enter the number of days after a certificate expires for the expired certificate notification continue diplaying.

      You can disable certificate expiry notifications by setting the value of both warning fields to 0.

  5. Optional: Configure SAML metadata update events:

    1. Select the Notification for SAML Metadata Update Events check box.

    2. Enter the email address of the intended recipient.

    3. Select a notification publisher instance from the list.

    If you have not configured the desired notification publisher instance, click Manage Notification Publishers.

  6. Optional: Configure thread pool exhaustion events:

    1. Select the Notification for Thread Pool Exhaustion Events check box.

    2. To enable PingFederate to dump threads after a thread queue threshold has been reached, select the Thread Dump check box.

    3. Select a notification publisher instance from the list.

    Choose from:

    • To send thread pool exhaustion events by email, select Default and enter the email address of the intended recipient in the Email Address field.

    • To record thread pool exhaustion events in the server.log file, select Logging Only.

      If you select this option, you are not required to set a notification publisher.

      For more information, see Configuring thread pool monitoring.

  7. Optional: Configure bulkhead alert events.

    1. Select the Notification For Bulkhead Alert Events check box.

    2. To enable PingFederate to dump threads after a bulkhead threshold has been reached, select the Thread Dump check box.

    3. Select a notification publisher instance from the list.

    Choose from:

    • To send bulkhead alert events by email, select Default and enter the email address of the intended recipient in the Email Address field.

    • To record bulkhead alert events in the server.log file, select Logging Only.

      If you select this option, you are not required to set a notification publisher.

      For more information, see Configuring runtime thread bulkheads.

  8. Click Save.