Okta Active Directory agent variable definitions
This table lists the properties in the Active Directory (AD) agent configuration file:
C:\Program Files (x86)\Okta\Okta AD Agent\OktaAgentService.exe.config
Don't modify these settings unless you fully understand the repercussions of your changes.
Variable |
Description |
---|---|
BaseOktaURI | URL for the org. |
AgentToken | Encrypted value for the API token that the agent uses for calling Okta. This variable only applies to Okta Active Directory agent version 3.17.0 or earlier. |
AgentKey | Encrypted value for the key that the agent uses for calling Okta. This variable only applies to Okta Active Directory agent version 3.18.0 or later. |
AgentId | Unique identifier for the agent, generated during installation. |
AppId |
Unique identifier for the directory to which this agent belongs. The AppId forms part of the URL when you are on the directory integrations page for this instance. For example:
https://acme-admin.okta.com/admin/app/active_directory/instance/0oa5c6b3zzMBmPCoH0h7. |
AgentName | Human readable ID for the agent. By default, this is the hostname of the server on which the agent is installed. Changes to the value are reflected in the Okta AD Agent Manager but not in Okta. |
ClientId | Unique identifier that the agent uses for calling Okta. This variable only applies to Okta Active Directory agent version 3.18.0 or later. |
ProxyURI | The url:port for the proxy used by this agent, if any. If no value is given for this setting, then a proxy isn't being used. Likewise, if there's a value that can't be resolved as a valid URL, no value is given for this setting. |
ProxyUsername | If the proxy requires authentication, the username is used. By default, no value is given for this setting (none required). |
ProxyPassword | If the proxy requires authentication, the encrypted value for the password is used. By default, no value is given for this setting (none required). |
PollingThreads | The number of concurrent polling requests (from 1 through 10) running between the agent and Okta. A number outside this range sets the number of threads at the minimum or maximum (whichever boundary is exceeded). The default value is 2. |
VerboseLogging | The value is either True or False. True ensures that the log contains more information (mostly in the user provisioning flow). The default value is False. |
ConnectionLimit | The value for system.net.servicepointmanager.defaultconnectionlimit. The default .NET limit of two concurrent connections is maintained if Okta fails to parse the value of this setting. |
MaxRetryLimitSleep | Related to circumstances when an agent is unable to reach Okta. The intervals during which disconnected agents aren't polling Okta become progressively longer. When the agent is reconnected, polling resumes at the normal frequency. This setting specifies the duration of non-polling ("sleep") intervals. By default, this setting is set to the maximum setting of 1 hour in milliseconds (3600000). |
DelAuthPostTimeout |
The time in milliseconds to post a single delegated authentication result from an Okta AD agent to a server. If the post times out or is unsuccessful due to a RETRYABLE error, and the maximum retry count isn't reached, the post is attempted again after a short delay. Subsequent attempts have the same interval in addition to the delay or sleep interval. The lowest value is 5000 or 5 seconds. |
SendScanDataMaxRetries |
Defines the maximum allowable retries for posting scan data. |
SslPinningEnabled | When SSL pinning is enabled, the Okta AD agent confirms that the SSL certificate presented by the Okta org matches one of the keys hard-coded in the agent. The default value for an Early Access (EA) version of the agent is True. The default value for a Generally Available (GA) version of the agent is False. |