![](<https://www.versio.io/img/supported-technology/microsoft-active-directory.svg>)

# Active Directory

Versio.io can import, historize and process monitoring data from Active Directory.

## Configuration

You can find the configuration option in Versio.io at `Environment settings > OneImporter > Configurations > Active Directory`.

Here you can edit all existing configurations, create new configurations or delete existing configurations. To add a new configuration, enter a `Name` for your importer and an `Entity suffix` (default: `-active-directory`) to clearly identify your Active Directory entities.  
Note that the `Entity suffix` is fixed and cannot be changed afterwards.

Click `Add` to proceed to the configuration.

To edit an existing configuration, click the arrow on the left of your importer name to expand the configuration options.

The following configuration options are available:

| Field | Description | Advice |
| --- | --- | --- |
| **Name** | Meaningful name | Add the word "Active Directory" to identify the importer when viewing the logs |
| **Active** | Option to activate and deactivate the configuration. Data is only imported if the configuration is activated. |  |
| **URL** | Active Directory server to connect to |  |
| **Port** | Active Directory server port to connect to | Default: `389` |
| **Base DN** | The root DN from which all searches will be performed | e.g. `dc=example,dc=com` |
| **Username** | An account name capable of performing the desired operations |  |
| **Password** | Password for the given user |  |
| **Import empty containers** | Whether containers without children should be imported | Default: `false` |
| **Entities** | Select all required entities |  |
| **Instance modification** | Before saving an instance, it can be modified to adjust attribute names and values (mask, hash, delete, regex, rename). |  |
| **Executing OneImporter** | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires an installed OneImporter: [Installation instructions](<https://docs.versio.io/setup-one-importer/index.md>) |
| **Schedule time (cron format)** | Determine the frequency of imports in CRON format | Learn more about CRON format: [https://en.wikipedia.org/wiki/Cron](<https://en.wikipedia.org/wiki/Cron>) |

*Table: Active Directory configuration parameters*

The following image is an example of an Active Directory configuration:

![Versio.io Active Directory importer configuration](<https://docs.versio.io/img/importer/active-directory/conf.png>) *Figure: Example of a Versio.io Active Directory configuration*

## Example

The Versio.io OneImporter imports Active Directory data based on a specific configuration into entities with a suffix defined by you (default: `active-directory`). To view the imported instances in Versio.io, select 'Asset &amp; Configuration Repository → Instance Viewer'. There you can select your specific instance and click it for a detailed view in the instance history viewer.

The following image is an example of imported Active Directory data:

![Versio.io Active Directory instance overview](<https://docs.versio.io/img/importer/active-directory/instance.png>)  
*Figure: Overview of a Versio.io Active Directory instance and topology of related instances (right)*

![Versio.io Active Directory instance overview](<https://docs.versio.io/img/importer/active-directory/topology.png>)  
*Figure: Topology of related instances*

## Reference

- [Active Directory documentation](<https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/active-directory-domain-services>)
