Microsoft Active Directory
Visualize Microsoft Active Directory users, groups, and devices, and monitor changes through queries and alerts.
- Installation guide
- Microsoft Active Directory data model
Installation
To use this integration, you must create a Microsoft Active Directory account capable of executing Active Directory read queries, and open the LDAP port on your server to allow queries to be executed.
Configuration in JupiterOne
To install the Microsoft Active Directory integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Microsoft Active Directory. Click New Instance to begin configuring your integration.
- Create an Active Directory user capable of executing read queries.
- Obtain the following information:
- Client Username - the username created in previous step, such as
user@corp.example.com
. - Client Password - the password for the Client Username.
- LDAP URL - the URL of the LDAP server, such as
ldap://10.10.10.10
. - Base DN - The base Distinguished Name of the subtree to be used in authentication and searches, such as
dc=corp
,dc=example
,dc=com
.
- Client Username - the username created in previous step, such as
The Account Name used to identify the Microsoft Active Directory account in JupiterOne. Ingested entities will have this value stored in
tag.AccountName
when theAccountName
toggle is enabled.Description to assist in identifying the integration instance, if desired.
Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as
DISABLED
and manually execute the integration.Microsoft Active Directry information (username, password, LDAP URL, base DN) obtained in the previous section.
Click Create once all values are provided to finalize the integration.
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Data Model
Entities
The following entities are created:
Resources | Entity _type | Entity _class |
---|---|---|
Account | ad_account | Account |
Device | ad_device | Device |
User | ad_user | User |
UserGroup | ad_group | UserGroup |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
---|---|---|
ad_account | HAS | ad_device |
ad_account | HAS | ad_group |
ad_account | HAS | ad_user |
ad_group | HAS | ad_group |
ad_group | HAS | ad_user |