LDAP agent configuration changes

To change your LDAP configuration, choose the method appropriate for your platform.


Uninstall and then reinstall the agentA software agent is a lightweight program that runs as a service outside of Okta. It is typically installed behind a firewall and allows Okta to tunnel communication between an on-premises service and Okta's cloud service. Okta employs several agent types: Active Directory, LDAP, RADIUS, RSA, Active Directory Password Sync, and IWA. For example, users can install multiple Active Directory agents to ensure that the integration is robust and highly available across geographic locations., and then specify new configuration settings during setup.


  1. Run an update script by issuing the following command from the command line:


  1. Issue any of the following commands:
Command Definition Example
[-b] ldap.dn.base NewBaseDN
[-a] ldap.adminAn abbreviation of administrator. This is the individual(s) who have access to the Okta Administrator Dashboard. They control the provisioning and deprovisioning of end users, the assigning of apps, the resetting of passwords, and the overall end user experience. Only administrators have the Administration button on the upper right side of the My Applications page..dn NewLDAPAdminDN
[-w] ldap.admin.password NewLDAPPassword
[-h] ldap.host NewLDAPHost
[-p] ldap.port NewLDAPPort

You can combine parameters. For example:

/opt/Okta/OktaLDAPAgent/scripts/update.sh -h -p 389

Related Topics

Install and Configure the Okta Java LDAP Agent

LDAP configuration parameters