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 |
| Schedule time (cron format) | Determine the frequency of imports in CRON format | Learn more about CRON format: https://en.wikipedia.org/wiki/Cron |
Table: Active Directory configuration parameters
The following image is an example of an Active Directory configuration:
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 & 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:
Figure: Overview of a Versio.io Active Directory instance and topology of related instances (right)
Figure: Topology of related instances