Rename an Active Directory domain

Renaming an Active Directory (AD) domain without uninstalling the Okta AD agent breaks the connection between the Okta AD agent and Okta. Okta recommends that you avoid changing the AD domain name.

1. Uninstall any Okta AD agent that is on the domain controller that you are renaming. Refer to Update the Okta Active Directory agent.
2. Rename the AD domain. See your Microsoft documentation.
3. Reinstall the Okta AD agent with the new domain name. Refer to Update the Okta Active Directory agent.

The renamed domain appears as a new AD application instance on the Okta Admin Console.