Limit Collection Scope
By default, the collector collects MFA factors for all users and application-user assignments for all applications. Use the following settings under[sources.source.okta] in config.toml, or their environment variables using the SOURCES__SOURCE__OKTA prefix, to significantly reduce request volume:
| Parameter Name | Environment Variable | Description |
|---|---|---|
limit_user_mfa_collection | Collect MFA factors only for users with role assignments. | |
limit_app_user_collection | Collect application-user assignments only for the collector’s built-in set of application types. | |
app_user_collection_app_ids | Additional Okta application IDs to collect when limit_app_user_collection is true. |
config.toml
Tune Extraction Concurrency
Increasing workers or concurrent requests can improve throughput when capacity is available, but cannot bypass Okta’s API rate limits. Try overriding the default extract parameters for Okta:config.toml
[sources.source.okta]. Replace {PREFIX} with SOURCES__SOURCE__OKTA in the environment variables below.
| Parameter Name | Environment Variable | Default | Description |
|---|---|---|---|
endpoint_concurrency | 32 | Maximum simultaneous requests per API endpoint. | |
org_concurrency | 32 | Maximum simultaneous requests across all endpoints. | |
rate_limit_max_elapsed_seconds | 900 | Maximum elapsed retry window for an individual HTTP 429 request. | |
rate_limit_remaining_reserve | 1 | Requests held in reserve when pacing against a rate-limit window. |
Tune Page Sizes
These are advanced settings. The default page sizes should work well for most environments.
SOURCES__SOURCE__OKTA prefix:
| Environment Variable | Default | Description |
|---|---|---|
200 | Applications per page, from 1 through 200. | |
500 | Application users per page, from 1 through 500. | |
200 | Groups per page, from 1 through 200. | |
200 | Application-group assignments per page, from 20 through 200. | |
1000 | Group push mappings per page, from 1 through 1,000. | |
200 | Identity-provider users per page, from 1 through 200. |
If the initial expanded group page repeatedly times out on large Okta tenants, the collector retries that first page with successively halved page sizes before failing. With the default
GROUPS_PAGE_SIZE of 200, that fallback sequence is 200, then 100, then 50.