Directory Agent: Active Directory

Caution: This feature is in beta. While we do not expect these interfaces to change, they might. If you have any issues, please report them to help@nametag.co.

If you have an Active Directory setup that you would like to integrate with Nametag, you can use the nametag cli to run a directory agent via the following command:

nametag dir agent ad

This will create a new custom directory which can then be used to manage your Active Directory. The agent will then perform operations on your directory on behalf of Nametag.

The machine that runs the agent must have the following requirements satisfied:

• A Windows machine that is domain joined to the AD instance.
• The user running the agent must have permission to run powershell commands with sufficient privileges.
• The ActiveDirectory module must be installed for powershell.

You can also invoke an agent with custom logic for a more bespoke behaviour with your directory:

nametag directory agent --command "my-custom-worker"

For more information on how nametag interacts with the worker, refer to this. You can contribute/fork the nametag cli repo.