---
title: Active Directory
description: ''
slug: /help/docs/integrations/automation-integrations/active-directory/
canonical: https://www.sumologic.com/help/docs/integrations/automation-integrations/active-directory/
---
import useBaseUrl from '@docusaurus/useBaseUrl';

<img src=/help/img/platform-services/automation-service/app-central/logos/active-directory.png alt="Active directory icon" width="100"/>

**Version: 1.3  
Updated: Dec 19, 2023**

Utilize user, group, and system information from Active Directory.

## Actions

* **System Attributes** (*Enrichment*) - Gather system attributes.
* **User Attributes** (*Enrichment*) - Gather user attributes.
* **Group Attributes** (*Enrichment*) - Gather group attributes.
* **Users Groups** (*Enrichment*) - Gather user's groups.
* **Create User** (*Containment) - Create a new user.
* **Reset Password** (*Containment*) - Reset a user's password.
* **Set Password** (*Containment*) - Set a new password.
* **Set System Attributes** (*Containment*) - Set a system's attribute.
* **Set User Attributes** (*Containment)*- Set a user's attributes.
* **Change System OU** (*Containment*) - Change a system's organizational unit (OU).
* **Enable User** (*Containment*) - Enable a user account.
* **Disable User** (*Containment*) - Disable a user's account.
* **Remove Users From Groups** (*Containment*) - Remove users from AD group.
* **Get Groups Members** (*Containment*) - retrieve users from AD group.
* **Add Users To Groups** (*Containment*) - Add a user to a group.
* **User Attributes V2** *(Enrichment)* - Gather user attributes v2.

## External Libraries

* [LDAP3](https://github.com/cannatag/ldap3/blob/master/LICENSE.txt)

## Configure Active Directory in Automation Service and Cloud SOAR

import IntegrationsAuth from '../../reuse/integrations-authentication.md';
import IntegrationCertificate from '../../reuse/automation-service/integration-certificate.md';
import IntegrationEngine from '../../reuse/automation-service/integration-engine.md';
import IntegrationLabel from '../../reuse/automation-service/integration-label.md';
import IntegrationProxy from '../../reuse/automation-service/integration-proxy.md';
import IntegrationTimeout from '../../reuse/automation-service/integration-timeout.md';

<IntegrationsAuth/>

* <IntegrationLabel/>
* **Host**. The hostname or IP address of the AD server.

* **Login Port**. The port used for LDAP authentication. The default is `389` for LDAP and `636` for LDAPS.

* **Login DN (Username)**. Enter the distinguished name format (for example, `CN=Administrator,CN=Users,DC=csoar,DC=com`). See the following sections for information about how to get the login DN.

* **Password**. The corresponding password for the provided username.

* **Base DN**. Enter the Base Distinguished Name. 

* **Global Catalog or DN Port**. Select the catalog or port. For global catalog, select port 3268 for LDAP or 3269 for secure LDAP.

<img src=/help/img/platform-services/automation-service/app-central/integrations/active-directory-v2/active-directory-configuration.png style={{border:'1px solid gray'}} alt="Active Directory configuration" width="400"/>

For information about Active Directory, see [Active Directory documentation](https://learn.microsoft.com/en-us/troubleshoot/windows-server/active-directory/active-directory-overview).

## Change Log

| Version | Date | Description |
|:--|:--|:--|
| v1.3 | December 19, 2023 | Updated the **User Attributes V2** action so users can now be filtered based on their distinguishedName (DN). |
| v1.2 | July 7, 2023 | <ul><li>Renamed the integration from Active Directory OIF to Active Directory.</li><li>Updated the integration with environmental variables.</li></ul> |
| | June 07, 2022 | Updated the **User Attributes V2** action to update the output. |
| | October 27, 2021 | Added new actions. |
| | November 9, 2020 | Added new actions. |
| | December 19, 2019 | Initial release of the Active Directory integration. |