Active Directory (AD) is a centralized directory service used to manage user identities, computer accounts, and network resource access within a Windows domain network, allowing administrators to manage permissions and security policies, group memberships and user details in a single, accessible location. For more information, refer to the Microsoft page.
Integration Method: Data Collector Dynamic Ingest
Tables: Group Management (3006)
This integration supports following events:
Event | Description |
|---|---|
ADGroupHierarchy | Get full group hierarchy of a given group to find all the nested and sub nested groups under that group. |
This integration was tested against the following versions
PowerShell version | 7 or later |
Prerequisites
Enable ADDS on the AD server.
Databee console access.
Install Databee data collector.
PowerShell version 7 or later
Windows Server WS 2022 LTSC (Standard Edition) x86_64 (64 bit)
Configuration Overview
Enable ADDS on the AD server.
Install Data collector.
Add the Microsoft AD Groups data feed integration in the DataBee console
AD Server Configuration
To enable ADDS on windows machine if not already, follow the steps mentioned below.
Go to Server Manager and click on Add Roles and Features under the Manage section.

Click Next on both pages.


Select Active Directory Domain Services and DNS Server.

Click Next.

Click Next on other pages and on last page, select checkbox for server restart and allow it and then click on Install.

Once installed, click on the notifications button at the top right corner and select Promote this server to a domain controller.

Select Add a new forest and give name to domain and click Next.

Enter the password for the same and click Next.

Ignore the warning shown and click Next.

Click Next on all pages and at last click on Install.

DataBee Configuration
Install DataBee Data Collector
To install a data collector, refer to the following documentation for more information.
This section describes the steps needed for getting parameters for the data collector installation.
Login to the DataBee UI, click on the settings icon at the top right corner of the UI, and select System from the dropdown.

From the left sidebar, select Data Collectors. The page will display all the data collectors configured until now.

To create a new data collector, scroll to the bottom of the page and click on the Add Data Collector.

Fill in the required fields to add data collector:
Collector Name: Enter the name of your Data Collector.
OS: Select Windows option.
Click Next to proceed to the next step.

Copy the following details using Copy to Clipboard for later use, then click on Close.
Install Script
Tenant ID
Receiver URL
Collector ID
API Key (Click Show API Key to view it)

Open Windows machine where AD is configured and install data collector. (PowerShell 7 or greater is required).
Paste the install script in PowerShell to install the collector and then when prompted, enter tenant id, receiver url, collector id and api key.


Once installed you’ll see a message “Installation completed successfully”.
Configure Data Feed
Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.

Search for Microsoft Active Directory Groups feed and click on that option.

Click on the Data Collector option.

Click on the Dynamic Ingest option.

Enter feed contact information and select the connector that you created from drop down and scroll below.

In configuration section, confirm the following things:
Event Types: ADGroupHierarchy
Limit: Update limit value to change page size (Default: 500 records)
Authorization Method: Keep Windows Authentication (only supported)
Root Groups: Enter the name of root groups for which you want to pull out hierarchy. In case of multiple enter them, comma separated.
Click Submit.

Troubleshooting Tips
Ensure that Windows AD and data collector are configured on the same machine.
If you encounter any issues regarding log forwarding, refer to the DataBee troubleshooting document for detailed guidance.