Skip to main content

Responses are generated using AI and may contain mistakes.

CollectorsCloud Collectors Administration Guide

Prerequisites to Configure the PingOne Cloud Collector

Before you configure the PingOne Cloud Collector, complete the following prerequisites:

  • Create a new PingOne administrator user for the cloud collector configuration.

  • Create an API Client.

  • Obtain the account ID for your PingOne Enterprise account and subscription IDs for the required endpoints.

Create an Administrator

Use the following steps to create an administrator.

  1. Log in to the PingOne administrator portal as an administrator.

  2. Navigate to ACCOUNT > Administrators.

  3. Click Add Administrator.

  4. Enter the required information such as name and email address, then select Audit & Report Administrator in the Role list.

  5. Click Save. PingOne sends an email with a link to set a password to the user. After the user sets a password as prompted, and logs in for the first time via SSO, the user is added to the list of administrators.

Create an API Client

Use the following steps to create an API client.

  1. Log in to the PingOne administrator portal as an administrator.

  2. Navigate to DASHBOARD > Reporting > API CLIENTS.

  3. Click Add API Client.

  4. Enter the client name and description and click Next.

    PingOne displays the client ID and client secret. Record the values for the client ID and client secret to use them while configuring the cloud collector.

  5. Click Done.

    PingOne_Collector_Api_client_2.png

Obtain Account ID and Subscription IDs

To manage subscriptions for the audit events, you must create poll subscriptions for the administrator. For poll subscriptions, the audit events of a specific type are accumulated and provided to a client pulling those events. For more information see Get the audit events for a Poll subscription in the PingOne documentation.

To get the audit events for a Poll subscription and obtain subscription ID:

  1. Log in to the PingOne administrator portal as an administrator.

  2. On the PingOne dashboard, navigate to Reporting > SUBSCRIPTIONS.

  3. Click Add Subscription.

  4. Specify a name for the subscription.

  5. Select the type of event that you want to poll for this subscription. The TYPE list displays the data sources from where the collector collects data.

  6. In Subscription Type area, select Poll, then select a batch size to indicate maximum number of audit events for the polling subscription to retrieve.

  7. Click Done. The Subscriptions page displays the new Poll subscription created.

  8. On the Subscriptions page, select the Poll subscription that you created, then click the expand icon to view details.

  9. Copy the Poll URL. This URL contains account ID and the poll subscription ID. The poll URL has the following syntax: https://admin-api.pingone.com/v3/reports/<account-Id>/poll-subscriptions/<subscriptionID>/events

    Note the account ID and the subscription ID represented by a string of letters and numbers. For example, in the URL https://admin-api.pingone.com/v3/reports/5733a0b1-ff99-4e59-95e6-58c14831xxxx/poll-subscriptions/8ae7c229-5198-40ae-bb68-b67bb46exxxx/events, the account ID is 5733a0b1-ff99-4e59-95e6-58c14831xxxx and the subscription ID is 8ae7c229-5198-40ae-bb68-b67bb46exxxx.   Use the account ID and the subscription ID to configure the Ping Identity cloud collector.