Skip to content

docs: document okta_saml configuration and auth flow - #260

Merged
YoungJinJung merged 2 commits into
feature/issue-85-okta-saml-exchangefrom
feature/issue-88-okta-saml-docs
Aug 14, 2026
Merged

docs: document okta_saml configuration and auth flow#260
YoungJinJung merged 2 commits into
feature/issue-85-okta-saml-exchangefrom
feature/issue-88-okta-saml-docs

Conversation

@YoungJinJung

Copy link
Copy Markdown
Contributor

Summary

Implements #88, the final slice of the Okta SAML track (#26). Stacked on the #87 MFA PR (base branch: feature/issue-87-okta-mfa-challenge); merge the earlier Okta slices first.

  • README: okta_saml context in the config example, a dedicated Okta SAML Contexts usage section (interactive + UNIC_OKTA_USERNAME/UNIC_OKTA_PASSWORD automation), how to derive okta_app_id from the app embed link, and explicit v1 limitations (factor set, deterministic role selection, credentials-only caching).
  • docs/architecture.en.md / docs/architecture.ko.md: okta_saml added to the auth model with the runtime flow and cache behavior; auth mode counts corrected.
  • docs/project-overview.en.md / docs/project-overview.ko.md: auth coverage updated.

With this, all five delivery slices of #26 are complete (#84 schema, #85 exchange, #86 cache, #87 MFA, #88 docs) — #26 can be closed once the stack merges.

Closes #88

Part of #26

Document the okta_saml context format, runtime flow, and v1
limitations across README (config example, usage section, env-var
automation), architecture docs (EN/KO auth model), and project
overview docs. v1 limitations are stated explicitly: TOTP and Okta
Verify push factors only, deterministic role selection via role_arn,
and credentials-only caching with no persisted secrets.

Closes #88

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BFhLrnpVxivu62cC3k9NZB
@coderabbitai

coderabbitai Bot commented Aug 13, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (1)
  • main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 93253109-1353-4f96-802d-35d8682a8c71

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@amazon-q-developer amazon-q-developer Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This documentation PR comprehensively documents the Okta SAML authentication feature across all relevant documentation files. The changes correctly update authentication mode counts, add detailed usage examples, describe the runtime flow, explain configuration options, and document v1 limitations including MFA factor support and security practices.

The documentation is consistent across English and Korean versions, follows existing patterns, and provides clear guidance for both interactive and non-interactive (CI/automation) usage scenarios. All sections properly integrate the new okta_saml authentication type alongside existing credential, assume-role, SSO, and console_login options.

No blocking issues identified. The documentation is ready to merge.


You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.

@youngjinjung-linq youngjinjung-linq left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

냉정 리뷰 완료. stacked #257–#259의 실제 필드명과 인증/MFA/cache 동작을 문서와 대조했으며 이 docs-only diff의 새 오류는 찾지 못했습니다.

Base automatically changed from feature/issue-87-okta-mfa-challenge to feature/issue-85-okta-saml-exchange August 14, 2026 00:31
@YoungJinJung
YoungJinJung merged commit 1d204db into feature/issue-85-okta-saml-exchange Aug 14, 2026
1 check passed
@YoungJinJung
YoungJinJung deleted the feature/issue-88-okta-saml-docs branch August 14, 2026 00:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants