Overview
Connect Okta to integrate your Okta system event logs into Datadog Log Management.
These logs give you greater visibility into access and lifecycle events from all of your applications, users, and more. The Datadog Okta integration enables you to detect threats to your applications, track user activity, debug authentication and authorization issues, and create an audit trail for regulatory compliance.
See the Okta Event Types API for all the Okta events that Datadog can track.
SSO with SAML
For single sign-on, see Configuring Okta as a SAML IdP.
Setup
Configuration
There are two methods to enable the Datadog Okta integration: through OAuth using credentials from the Datadog app on the Okta Integration Network or through an API key.
Both methods require the following fields:
| Parameter | Description |
|---|
| Account name | Identifies your Okta account in Datadog. The account name can only contain alphanumeric characters and underscores. |
| Domain | The unique account domain used to request logs from your Okta account. The URL must be valid and start with https://<your_domain>.okta.com. |
| Authorization method | Specifies a method to receive authorization from Okta. The two methods are: account API key or credentials from the Datadog app on the Okta Integration Network. |
To enable the integration using OAuth:
In Okta, navigate to Applications > API Services Integration > Add Integration > Datadog.
Upon installation, you will be provided a set of client ID and client secret credentials. Copy these credentials.
In Datadog, open the Okta integration tile.
Under the Configure tab, click Add Account and enter the following information:
| Parameter | Description |
|---|
| Client ID | The client ID provided by Okta. |
| Client Secret | The client secret provided by Okta. |
Click Save.
To enable the integration using an API key:
In Okta, navigate to Security > API > Tokens and add a new API token.
In Datadog, open the Okta integration tile.
Under the Configure tab, click Add Account and enter the following information:
| Parameter | Description |
|---|
| API key | The API token from your Okta account. The minimum required permission is read-only administrator. |
Click Save.
Data Collected
Metrics
The Okta integration does not include any metrics.
Events
The Okta integration does not include any events.
Service Checks
The Okta integration does not include any service checks.
Troubleshooting
Need help? Contact Datadog support.
