Active Directory integration known issues

The following are the known issues with Active Directory (AD) integrations:

  • If you're using a custom URL:

    • Agents – Use the actual domain ( and not the custom domain (
    • IWA SSO – Modify the web.config file to include the custom url.


      <oktaSSOConfig orgOktaAuthenticationURL=""



    • Agentless DSSO – Make sure that all sign-in flows and browser bookmarks use the correct URL.
  • When you add a new attribute to an AD domain, restart every Okta AD Agent connected to the domain. If the Okta AD Agents are not restarted, an Active Directory restriction causes the AD agents to base-64 encode the new attribute's values.
  • When renaming an AD domain, uninstall the Okta AD Agent before you start the renaming process. When you complete the renaming process, reinstall the Okta AD Agent with the new domain name. A renamed domain appears as a new AD app instance in Okta.

Related topics

Configure a custom URL domain