# Okta

### Supported Platforms

Bindplane Collector: `v1.59.0`+

| Platform | Metrics | Logs | Traces |
| -------- | ------- | ---- | ------ |
| Linux    |         | ✓    |        |
| Windows  |         | ✓    |        |
| macOS    |         | ✓    |        |

### Configuration Table

<table><thead><tr><th width="135.328125">Parameter</th><th width="101.58984375">Type</th><th width="80.37890625">Default</th><th>Description</th></tr></thead><tbody><tr><td>okta_domain*</td><td><code>string</code></td><td></td><td>The Okta domain to collect logs from (Excluding "https://").<br><a href="https://developer.okta.com/docs/guides/find-your-domain/main/">Find your Okta Domain</a></td></tr><tr><td>api_token*</td><td><code>string</code></td><td></td><td>An Okta API Token generated from the above Okta domain.<br><a href="https://support.okta.com/help/s/article/How-to-create-an-API-token?language=en_US">How to Create an Okta API Token</a></td></tr><tr><td>poll_interval</td><td><code>string</code></td><td>1m</td><td>The rate at which this receiver will poll Okta for logs. This value must be in the range [1 second - 24 hours] and must be a string readable by Golang's <a href="https://pkg.go.dev/time#ParseDuration">time.ParseDuration</a>.<br>Okta recommends between 60s - 300s.</td></tr></tbody></table>

<mark style="color:red;">\*</mark>*<mark style="color:red;">required field</mark>*

{% hint style="danger" %}
**WARNING**

Depending on your Okta plan, setting the poll\_interval below 10 seconds risks your API Token getting rate limited. You can increase the rate limit allocated to your API Token to minimize the chances of getting rate limited while using a short poll\_interval. [Okta - Set Token Rate Limits](https://help.okta.com/en-us/content/topics/security/api.htm#Set)
{% endhint %}

#### Example Configuration

**Web Interface**

<figure><img src="/files/1qYVFulcD7XayhyGDAnf" alt="Bindplane docs - Okta - image 1"><figcaption></figcaption></figure>

**Standalone Source**

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  id: okta
  name: okta
spec:
  type: okta
  parameters:
    - name: okta_domain
      value: example.okta.com
    - name: api_token
      value: (sensitive)
      sensitive: true
    - name: poll_interval
      value: 60s
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/integrations/sources/okta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
