> For the complete documentation index, see [llms.txt](https://docs.euno.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.euno.ai/sources/identity-and-organization/okta-integration/okta-integration-discovered-resources.md).

# Okta Integration Discovered Resources

## Ingested Resources & Properties

### Users (`user`)

| Property        | Description                                                |
| --------------- | ---------------------------------------------------------- |
| `name`          | Email address of the user (used as the primary identifier) |
| `email_address` | Email address of the user                                  |
| `label`         | Display name of the user (from Okta profile)               |

### User Groups (`user_group`)

| Property     | Description                                                                                                                       |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `name`       | Display name of the group (from Okta profile)                                                                                     |
| `subtype`    | Always `"okta"` for groups observed from Okta                                                                                     |
| `native_id`  | Okta group ID                                                                                                                     |
| `created_at` | Timestamp when the group was created in Okta                                                                                      |
| `members`    | List of user members that belong to this group. Each member entry is a dictionary with a `uri` key pointing to the user resource. |

## Relationships

### Membership Relationships

The Okta integration creates membership relationships between groups and their members (users or nested groups).

#### Group → Members

Groups have a `members` property that contains a list of member dictionaries. Each dictionary has:

* `uri`: The URI of the member (user or group)

**EQL Examples**:

```
# Find all groups that have a specific user as a member
has member(uri="user_account.user@example.com")

# Find all members of a specific group
type = "user" and is member of(uri='user_group.048093095703')
```

#### User → Groups

Users can be queried to find which groups they belong to using the membership relationship in reverse.

**EQL Examples**:

```
# Find all groups that contain a specific user
has member(uri="user_account.user@example.com")
```

## Resource URIs

### User URI Format

Users are identified using the following URI format:

```
user_account.<EMAIL_ADDRESS>
```

**Examples**:

* `user_account.john.doe@example.com`
* `user_account.admin@company.com`

### User Group URI Format

Groups are identified using the following URI format:

```
user_group.<OKTA_GROUP_ID>
```

**Examples**:

* `user_group.00gz751533qdcfa7h697`
* `user_group.00gz751534gldauee697`

**Example EQL Query**:

```
# Find users in a specific group
type = "user" and is member of(name='some group')
```

You can then access the raw object properties through the Euno API or in custom properties to extract specific Okta fields.

## Group Members

The `members` property on groups contains a list of user members. Each member entry is a dictionary with a `uri` key pointing to the user resource.

**Note**: Currently, the Okta integration observes direct user memberships only. Nested groups (groups that are members of other groups) are not currently supported, but all groups in your Okta organization are observed as separate `user_group` resources.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.euno.ai/sources/identity-and-organization/okta-integration/okta-integration-discovered-resources.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.