elastic / elastic/integrations
[docs-patrol] Update Okta README for OIN authentication flow
- 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
Assessment
This issue has not been assessed yet.