--- title: "PingDirectory" slug: "ping-directory" updated: 2026-02-13T17:46:21Z published: 2026-02-13T17:46:21Z canonical: "docs.databee.buzz/ping-directory" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # PingDirectory PingDirectory provides a secure repository for sensitive user information, including profiles, credentials, and preferences. It serves as a central "single source of truth" for identity data, supporting millions of entries and operations per second. For more detailed information refer to [PingDirectory’s official page](https://www.pingidentity.com/en/product/pingdirectory.html). **Integration Method**: Data Collector (API Ingest) **Tables**: User Inventory Info (5003) This integration supports the following events. | **Event** | **Description** | | --- | --- | | Users | List directory Entries | This integration supports the following versions. | PingDirectory | PingDirectory 11 | | --- | --- | | API Version | v1 | ## Prerequisites - The user should have access to the device where the PingDirectory is installed. - The user should have access to the PingDirectory console with administrator privileges (cn=Directory Manager). - The user should have the **domain** and **ou** under which the user needs to be created. - The user should have a [compatible version](https://docs.databee.buzz/docs/data-collector#system-requirements) of the system in which we can configure the data collector. - The user should have access to the DataBee console. ## Configuration Overview 1. [Data Collector Configuration and Installation](/user-manual/docs/ping-directory#data-collector-configuration-and-installation). 2. [Create a User](/user-manual/docs/ping-directory#create-user) in the PingDirectory. 3. Create [PingDirectory Data Feed](/user-manual/docs/ping-directory#databee-configuration) in the DataBee console. | **DataBee Parameter** | **PingDirectory Parameter** | | --- | --- | | Base URL | https:// (IP/Instance of the PingDirectory) | | Username | Username (E.g. uid=databee-api-readonly,ou=People,dc=comcast,dc=local) | | Password | Password of the user | ## Data Collector Configuration and Installation To receive events from PingDirectory, a Data Collector must be installed and configured. The data collector is used to call PingDirectory APIs in an on-prem environment and send data to DataBee securely. Follow the steps provided in DataBee's official [documentation](https://docs.databee.buzz/docs/data-collector#configure-data-collector-in-databee) to complete the configuration. Additionally, refer to [this](https://docs.databee.buzz/docs/data-collector#installing-the-data-collector) guide for detailed instructions on installing the Data Collector on your machine. ## PingDirectory Configuration ### Create User > [!NOTE] > **Note:** > > The following steps are documented for Windows installation. The same configuration steps apply to other operating systems as well. Please refer to the [official documentation](https://docs.pingidentity.com/pingdirectory/10.2/pingdirectory_server_administration_guide/pd_ds_config_admin_accounts.html#setup_single_admin) for any OS-specific differences or issues. 1. **Create the LDIF File** First, generate the data file that defines the new user attributes. 1. Navigate to the directory: \PingDirectory-x.x.x.x\PingDirectory\ldif 2. Create a new file named **databee-api-readonly-user.ldif**. 3. Paste the following content into the file after replacing the below values and save: ```plaintext dn: changetype: add objectClass: top objectClass: inetOrgPerson uid: cn: sn: userPassword: ``` ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-smgpir1y.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) - **LDAP DISTINGUISHED NAME**: LDAP Distinguished Name (E.g. uid=databee-api-readonly,ou=People,dc=comcast,dc=local) for the user you want to create. - **UID:** uid (E.g. databee-api-readonly) of the user. - **COMMON NAME:** Common name (E.g. Databee API ReadOnly) of the user. - **SURNAME:** Surname (E.g. ReadOnly) of the user. - **PASSWORD:** Password for the user. 2. **Modify Existing Entries** 1. Navigate to the directory containing the executable tools: cd \PingDirectory-x.x.x.x\PingDirectory\bat ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-88h0y0en.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 2. To apply the changes defined in your LDIF file to the server, execute the following command after replacing the below values. ```plaintext ldapmodify.bat -h -p -D "cn=Directory Manager" -w -f "" ``` ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-77n573mk.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) - **HOSTNAME:** Hostname/IP of the PingDirectory. - **PORT:** Port of the PingDirectory. - **PASSWORD:** Password of the Directory manager. - **USER LDIF FILE:** Full path to the created LDIF file (E.g. C:\Users\Comcast\Desktop\PingDirectory-x.x.x.x\PingDirectory\ldif\databee-api-readonly-aci.ldif). 3. **Configure Access Control (ACI)** After creating the user, you must grant them specific permissions to read the directory data. This step applies to an Access Control Instruction (ACI) to the base of DN. 1. Navigate to the directory: \PingDirectory-x.x.x.x\PingDirectory\ldif 2. Create a file named: **databee-api-readonly-aci.ldif** with the following content after replacing the below values: ```plaintext dn: changetype: modify add: aci aci: (target="ldap:/// ")( targetscope="subtree ")(version 3.0;  acl "Databee API REST Read"; allow ( read,search,compare)  userdn="ldap:///uid=, ou= People,";) ``` - **DOMAIN**: Domain (E.g. dc=comcast,dc=local) under which the user was created. - **UID**: uid (E.g. databee-api-readonly) of the user we created. 4. Apply Access Control Permissions 1. Navigate to Batch Directory: cd \PingDirectory-x.x.x.x\PingDirectory\bat ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-h7avbdj2.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 2. Execute the following to apply the new permissions after replacing the below values: ```plaintext ldapmodify.bat -h -p -D "cn=Directory Manager" -w -f "" ``` ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-ht28aso9.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) - **HOSTNAME:** Hostname/IP of the PingDirectory. - **PORT:** Port of the PingDirectory. - **PASSWORD:** Password of the Directory manager. - **ACI FILE PATH:** Full path to the created LDIF file created in step 4. 5. Run the command below from the \PingDirectory-x.x.x.x\PingDirectory\bat directory to verify the created user after replacing the following values. ```plaintext ldapsearch.bat -h -p -D "cn=Directory Manager" -w -b " "(uid=)" ``` ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-ol3k4uxp.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) - **HOSTNAME:** Hostname/IP of the PingDirectory. - **PORT:** Port of the PingDirectory. - **PASSWORD:** Password of the Directory manager. - **UID:** uid (E.g. databee-api-readonly) of the user we created. - **DOMAIN**: Domain (E.g. dc=comcast,dc=local) under which the user was created. ## DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-w98udx38.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 2. Search for **PingDirectory** and click on it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-k6qxyqxh.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 3. Click on the **Data Collector** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-4lvidmr0.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 4. Click on the **API Ingest** option as the polling mechanism. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-8nodcqy7.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 5. Enter the feed contact information, select the collector that you have created from the drop down, and then scroll down. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-t64b451j.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 6. In the configuration page, confirm the following, then scroll down. - **Base URL**: Paste the Base URL which would be the IP address/instance of the Ping Directory. - **Request Count**: Set to **800** - **Interval**: Set to **60 seconds** - **Event Types:** Preselected for all the event types that integration pulls. **Note**: Limit is set to 800 requests/60s for a spec (4GB RAM) setup. Use 400 requests/60s for lower-spec setups. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-flqqgwki.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) 7. In the configure authentication page, confirm the following, then click on **Submit**. - **Authorization Method:** Basic - **Username**: Paste the username - **Password:** Paste the password - **Enable TLS**: Check the Enable TLS option - **Skip Server-side Certificate Verification:** Check it to disable the server-side certificate verification. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-7n4i6oj4.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) ## Troubleshooting Tips - Ensure that the server is reachable by opening the terminal on the receiver machine and running **ping ** command.![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ping-directory-july2025-image-n9by3487.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A00%3A33Z&se=2026-10-30T13%3A00%3A33Z&sr=c&sp=r&sig=S3YwFmuxM%2FBdXZr%2BjDwa8TbaudgMm9077BP6wlmIQFg%3D) - If you encounter any issues regarding log forwarding, refer to the [DataBee troubleshooting document](https://docs.databee.buzz/docs/troubleshooting) for detailed guidance.