Rename an Active Directory domain

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

  1. Uninstall all Okta AD agents on the domain controller that you are renaming. See 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. See Update the Okta Active Directory agent.

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