Okta System Audit Logs
Ingests Okta system events for audit trail analysis and platform activity monitoring.
Sync Type: Incremental
Authentication
This input supports API Key and OAuth 2.0 (service app) authentication. See Okta Authentication for setup instructions and required credentials for each method.
Details
Monad stores Okta's pagination position for the System Log after each page of events it reads, and the next sync continues from that position. The first sync starts from the Backfill Start Time if one is set, or from 90 days ago otherwise. Once syncing has started, later changes to Backfill Start Time have no effect. Because Monad follows Okta's own pagination position rather than a timestamp, events that arrive late in Okta's System Log are not skipped. See the Okta System Log API for details.
Configuration
The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.
Settings
| Setting | Type | Required | Default | Description |
|---|---|---|---|---|
org_url | string | Yes | - | Okta Organization URL. |
use_synthetic_data | bool | No | false | Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs. |
rate_limit | object | No | - | Maximum outbound source-API request rate. A blank or zero value falls back to the connector's default rate-limiting behavior. Maximum 10 requests per second. See API Rate Limiting for the field format. |
backfill_start_time | date | No | - | Date to start fetching data from. If not specified, a full sync (90 days) of data is fetched on the first sync. All syncs thereafter will be incremental. |
Secrets
| Secret | Type | Required | Description |
|---|---|---|---|
api_key | secret | No | Okta API Key. |
rsa_private_key | secret | No | RSA Private Key for OAuth 2.0 authentication with Okta. |
client_id | secret | No | OAuth 2.0 Client ID for Okta application. |
key_id | secret | No | Key ID (kid) for the RSA key pair used in OAuth 2.0 authentication. |
Secrets vary by authentication method. See Okta Authentication for details. If using the Oauth flow, the token should be granted the okta.logs.read scope.
Related Articles
- https://help.okta.com/en-us/content/topics/security/api.htm
- https://developer.okta.com/docs/reference/api/system-log/
Sample Record
Code
Sync frequency
This input has no cron setting of its own. By default this input polls approximately every 10 seconds, with each sync beginning after the previous one completes. A cron schedule configured on the pipeline overrides this cadence. See Input Sync Frequency for details.
Community transforms
The Monad Transforms Repository has ready-made transforms for this input. Import one into your organization, then add it to a pipeline after this input.
| Format | Transform |
|---|---|
| OCSF v1.9.0 | Okta System Log to OCSF v1.9.0 |
| ECS v9.5.0 | Okta System Log to ECS v9.5.0 |
| CEF | Okta System Log to CEF |
Older OCSF versions (v1.1.0) are also in the repository.
CEF transforms emit an intermediate record; add the CEF Serializer transform after one to produce the CEF:0 string.