elastic / elastic/integrations

[docs-patrol] Update Okta README for OIN authentication flow

Open
#19,236 0 comments 0 reactions 0 assignees View on GitHub
Team:Security-Service-Integrations
Dominant language
Handlebars
Stars
333
Forks
647
Avg merge
2d 17h
Merged PRs (30d)
225

Description

Recent code changes in the repository have introduced documentation drift. The following change needs a corresponding documentation update.

## Changes Requiring Documentation Updates

### 1. Okta OIN setup docs reference a removed UI toggle

**Commit(s):** [`d4a878017a`](https://github.com/elastic/integrations/commit/d4a878017a331de5bf6ed3046ae4b8b64eddc5e5)

**What changed:**
- `packages/okta/manifest.yml` removed the `oin_app` boolean variable/toggle and introduced an authentication method selector via `var_groups` (`Authentication Method`) with options including `oin_app`.
- The same commit also made agentless the default deployment mode.

**Evidence:**
- Docs still instruct a removed setting:
- `packages/okta/docs/README.md` line 49: `Set the "Use OIN Authentication" toggle to true`
- `packages/okta/_dev/build/docs/README.md` line 49: same instruction
- Current manifest uses selector-based auth instead of a toggle:
- `packages/okta/manifest.yml` lines 233-263 (`var_groups` with `auth_method` and option `oin_app`)

**Documentation impact:**
Users following current Okta OIN steps are directed to a toggle that no longer exists, which can block or mislead configuration.

## Suggested Actions

- [ ] Update `packages/okta/_dev/build/docs/README.md` OIN setup steps to use **Authentication Method = OIN App (OAuth 2.0)** instead of a "Use OIN Authentication" toggle.
- [ ] Regenerate/publish package docs so `packages/okta/docs/README.md` reflects the updated OIN flow.
- [ ] Confirm the updated instructions align with the current `var_groups` auth UX in `packages/okta/manifest.yml`.

> [!NOTE]
>
> 🔒 Integrity filter blocked 125 items
>
> The following items were blocked because they don't meet the GitHub integrity level.
>
> - [#18552](https://github.com/elastic/integrations/pull/18552) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18528](https://github.com/elastic/integrations/pull/18528) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18525](https://github.com/elastic/integrations/pull/18525) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19217](https://github.com/elastic/integrations/pull/19217) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19186](https://github.com/elastic/integrations/pull/19186) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19182](https://github.com/elastic/integrations/pull/19182) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18972](https://github.com/elastic/integrations/pull/18972) `search_pull_requests`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19231](https://github.com/elastic/integrations/issues/19231) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#17993](https://github.com/elastic/integrations/issues/17993) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19092](https://github.com/elastic/integrations/issues/19092) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#19094](https://github.com/elastic/integrations/issues/19094) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#17992](https://github.com/elastic/integrations/issues/17992) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#12663](https://github.com/elastic/integrations/issues/12663) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#17973](https://github.com/elastic/integrations/issues/17973) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#18421](https://github.com/elastic/integrations/issues/18421) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - [#14186](https://github.com/elastic/integrations/issues/14186) `search_issues`: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
> - ... and 109 more items
>
> To allow these resources, lower `min-integrity` in your GitHub frontmatter:
>
> ```yaml
> tools:
> github:
> min-integrity: approved # merged | approved | unapproved | none
> ```
>
>

---
[What is this?](https://ela.st/github-ai-tools) | [From workflow: Docs Patrol](https://github.com/elastic/integrations/actions/runs/26507375798)

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.
> - [x] expires on Jun 3, 2026, 11:16 AM UTC

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.