docs Directory Agent: Okta
Launch Nametag Get help

Directory Agent: Okta

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

Although you can integrate with an Okta directory via the Nametag console, you might want to host your own directory agent to let Nametag integrate with your directory. For example, you may wish to shield your Okta credentials from Nametag.

Use the Nametag CLI with the following command:

NAMETAG_AGENT_TOKEN=*NAMETAG_AGENT_TOKEN* \
OKTA_TOKEN=*OKTA_TOKEN* \
OKTA_URL=*OKTA_URL* \
nametag directory agent okta

This creates a new custom directory that can be used to manage your Okta directory. The agent then performs operations on your directory on behalf of Nametag.

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

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

For more information on how Nametag interacts with the worker, refer to the directory agent reference. You can contribute to or fork the Nametag CLI repository.