Page created: 15 May 2023 |
Page updated: 15 May 2023
You can create a webhook to monitor events in PingOne.
- Go to .
- Click + Add Webhook or expand an existing webhook to edit it.
- Enter a descriptive name for the connection.
Enter the destination information.
These settings configure the connection to the monitoring system.
- Destination: The URI of the application that you want to send data to.
- Format: The format of the activity data. Select
the format that is most easily consumed by your management system:
- Splunk: A Splunk-friendly format.
- New Relic: A New Relic-friendly format.
- Ping Activity Format: Use this format if the destination cannot directly accept the Splunk or New Relic formats. It's a versatile, generic JSON format, which is the same used by the PingOne API for accessing event data using Audit Activities. For more information, see the Subscription Action Types table in Subscriptions (webhooks).
- Certificates: A certificate to ensure that the connection is secure. Browse existing certificates, or upload a new one.
- Allow TLS connection with untrusted certificates: Select this option to allow a certificate that is not from a certificate authority (CA). PingOne certificates, and all certificates signed by the default CAs are trusted. This option is typically used for testing. For more information, see Certificates and key pairs.
Enter the headers information.
- Basic authentication: (Optional). Enter a username and password for the destination system.
- Custom HTTP headers: Specify additional information for the HTTP headers. You can provide information in the form of key-value pairs.
Enter the filters information.
These settings determine which events are monitored. Select a category or a subset of events in that category.
- Event types: Specify the types of events to monitor, such as user created, user deleted, and so on.
- Tags: Specify a tag to
monitor.Admin Identity Event: An action taken by an administrator or API client on another administrator user, such as:
- Creating or deleting an administrator user
- Enabling or disabling an administrator user
- Adding or removing roles from an administrator user
- Changing a password for an administrator user
- Changing username or email address for an administrator user
- Enabling or disabling MFA for an administrator user
- Pairing a new MFA device for an administrator user
- Adding or removing linked accounts for an administrator user
- Applications: Specify the applications in your PingOne environment that you want to monitor. You can include up to 10 applications.
- Populations: Specify the populations in your
environment that you want to monitor. You can include up to 10
For each filter, such as events, applications, or populations, the expression evaluates to
trueif any of the criteria are met (Boolean OR).
For multiple filters, the expression evaluates to
trueif all of the criteria are met (Boolean AND).
Enter the optional data.
Specify whether to include the IP address and User Agent strings in the report. Because IP addresses and User Agent strings can be considered sensitive data, you must manually select these options to include them in the report.
- Include IP address: Include the end user’s IP address in the report. IP addresses are the client’s IP address as it appears to the PingOne services. In some cases, this value is a proxy address rather than the actual client device address.
- Include User Agent: Include the User Agent String in the report. User Agent Strings are included if PingOne interacts with the user client when the client provides the string. The recorded value is exactly what was presented to PingOne by the client.
- Click Save.