Skip to content

[OKTA-1174908]: Milestone#1: OIN refactoring for "Build an SSO integration"#6155

Open
divyabhushan-okta wants to merge 35 commits into
masterfrom
oin-okta-1174908-build-an-sso-integration
Open

[OKTA-1174908]: Milestone#1: OIN refactoring for "Build an SSO integration"#6155
divyabhushan-okta wants to merge 35 commits into
masterfrom
oin-okta-1174908-build-an-sso-integration

Conversation

@divyabhushan-okta
Copy link
Copy Markdown
Contributor

@divyabhushan-okta divyabhushan-okta commented May 17, 2026

Description:

  • What's changed? This is a base branch to base off the work to refactor the Single Sign On section under the Okta Integration Network guides section.
  • Is this PR related to a Monolith release? No

Resolves:

Netlify Preview Link:

https://oin-okta-1174908-build-an-sso-integration--dev-docs-preview.netlify.app

The refactored docs work merged into this base PR#

Note: The following refactored pages from under the OIN section have been structurally updated, these pages are deleted from under the OIN section and the content have been moved around to the respective pages. Clearly following the OIN refactoring proposal plan from DCS.

Page Jira Ticket PR# Merged Writer
Overview of Single Sign-On in the OIN OKTA-1175626 - Thomas
Build an SSO integration (OIDC) OKTA-1176445 - Janu
Build an SSO integration (SAML) OKTA-1176447 PR#6184 Brent
Add a private SSO integration (OIDC) OKTA-1176450 PR#6174 Sophia
Add a private SSO integration (SAML) OKTA-1176456 PR#6182 Sophia

The goal is to separate the generic "build" guides (moving them to logical homes like Guides > Sign users in or Guides > User Management) from the OIN-specific "publish" guides, refactoring the monolithic OIN documentation into a modular architecture to create a clean foundation for the upcoming ISV journey documentation work.

@divyabhushan-okta divyabhushan-okta force-pushed the oin-okta-1174908-build-an-sso-integration branch from e23bde6 to 2404bfc Compare May 18, 2026 11:14
@okta-prod-github-app
Copy link
Copy Markdown

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article Total score
Required:80
Word and phrases
(Brand, terms)
Preferred: 80
Correctness
(Spelling, grammar)
Preferred: 80
Clarity
(Readability)
Preferred: 80
Inclusive language
(+ accesibility)
Preferred: 80
packages/@okta/vuepress-site/docs/concepts/how-okta-works/index.md 81 100 86 36
packages/@okta/vuepress-site/docs/concepts/redirect-vs-embedded/index.md 94 100 88 96
packages/@okta/vuepress-site/docs/concepts/saml/index.md 94 100 89 100
packages/@okta/vuepress-site/docs/guides/add-private-app/main/index.md 92 100 90 95
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/protocol-config.md 89 100 67 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/see-also.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/custom-url-domain/main/index.md 87 92 87 90
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78
packages/@okta/vuepress-site/docs/guides/oin-sso-overview/index.md 86 91 95 93
packages/@okta/vuepress-site/docs/guides/saml-tracer/main/index.md 86 100 100 85
packages/@okta/vuepress-site/docs/guides/scim-provisioning-integration-overview/main/index.md 86 100 78 70
packages/@okta/vuepress-site/docs/guides/sign-in-overview/main/index.md 92 90 90 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/openidconnect/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/saml2/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/scim/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/updating-saml-cert/main/index.md 89 100 69 89
packages/@okta/vuepress-site/docs/reference/org-defaults/index.md 85 100 87 100

Successfully checked 17 of 17 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

@brentschaus-okta brentschaus-okta force-pushed the oin-okta-1174908-build-an-sso-integration branch from 56d4402 to 97ccf30 Compare May 29, 2026 17:26
@okta-prod-github-app
Copy link
Copy Markdown

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article Total score
Required:80
Word and phrases
(Brand, terms)
Preferred: 80
Correctness
(Spelling, grammar)
Preferred: 80
Clarity
(Readability)
Preferred: 80
Inclusive language
(+ accesibility)
Preferred: 80
packages/@okta/vuepress-site/docs/concepts/how-okta-works/index.md 81 100 86 36
packages/@okta/vuepress-site/docs/concepts/redirect-vs-embedded/index.md 94 100 88 96
packages/@okta/vuepress-site/docs/concepts/saml/index.md 94 100 89 100
packages/@okta/vuepress-site/docs/guides/add-private-app/main/index.md 92 100 90 95
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/protocol-config.md 89 100 67 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/see-also.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/custom-url-domain/main/index.md 87 92 87 90
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78
packages/@okta/vuepress-site/docs/guides/oin-sso-overview/index.md 86 91 95 93
packages/@okta/vuepress-site/docs/guides/saml-tracer/main/index.md 86 100 100 85
packages/@okta/vuepress-site/docs/guides/scim-provisioning-integration-overview/main/index.md 86 100 78 70
packages/@okta/vuepress-site/docs/guides/sign-in-overview/main/index.md 92 90 90 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/openidconnect/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/saml2/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/scim/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/updating-saml-cert/main/index.md 89 100 69 89
packages/@okta/vuepress-site/docs/reference/org-defaults/index.md 85 100 87 100

Successfully checked 17 of 17 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

@okta-prod-github-app
Copy link
Copy Markdown

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article Total score
Required:80
Word and phrases
(Brand, terms)
Preferred: 80
Correctness
(Spelling, grammar)
Preferred: 80
Clarity
(Readability)
Preferred: 80
Inclusive language
(+ accesibility)
Preferred: 80
packages/@okta/vuepress-site/docs/concepts/how-okta-works/index.md 81 100 86 36
packages/@okta/vuepress-site/docs/concepts/redirect-vs-embedded/index.md 94 100 88 96
packages/@okta/vuepress-site/docs/concepts/saml/index.md 94 100 89 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/index.md 89 94 90 74
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/openidconnect/protocol-config.md 93 100 100 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/protocol-config.md 89 100 67 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/see-also.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/scim/protocol-config.md 89 100 34 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/swa/protocol-config.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/custom-url-domain/main/index.md 87 92 87 90
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78
packages/@okta/vuepress-site/docs/guides/oin-sso-overview/index.md 86 91 95 93
packages/@okta/vuepress-site/docs/guides/saml-tracer/main/index.md 86 100 100 85
packages/@okta/vuepress-site/docs/guides/scim-provisioning-integration-overview/main/index.md 86 100 78 70
packages/@okta/vuepress-site/docs/guides/sign-in-overview/main/index.md 92 90 90 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/openidconnect/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/saml2/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/scim/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/updating-saml-cert/main/index.md 89 100 69 89
packages/@okta/vuepress-site/docs/reference/org-defaults/index.md 85 100 87 100

Successfully checked 20 of 20 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

@okta-prod-github-app
Copy link
Copy Markdown

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article Total score
Required:80
Word and phrases
(Brand, terms)
Preferred: 80
Correctness
(Spelling, grammar)
Preferred: 80
Clarity
(Readability)
Preferred: 80
Inclusive language
(+ accesibility)
Preferred: 80
packages/@okta/vuepress-site/docs/concepts/how-okta-works/index.md 81 100 86 36
packages/@okta/vuepress-site/docs/concepts/redirect-vs-embedded/index.md 94 100 88 96
packages/@okta/vuepress-site/docs/concepts/saml/index.md 94 100 89 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/index.md 87 90 85 75
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/openidconnect/protocol-config.md 93 100 100 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/protocol-config.md 81 100 81 49
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/saml2/see-also.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/scim/protocol-config.md 89 100 34 100
packages/@okta/vuepress-site/docs/guides/create-an-app-integration/main/swa/protocol-config.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/custom-url-domain/main/index.md 87 92 87 90
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78
packages/@okta/vuepress-site/docs/guides/oin-sso-overview/index.md 86 91 95 93
packages/@okta/vuepress-site/docs/guides/saml-tracer/main/index.md 86 100 100 85
packages/@okta/vuepress-site/docs/guides/scim-provisioning-integration-overview/main/index.md 86 100 78 70
packages/@okta/vuepress-site/docs/guides/sign-in-overview/main/index.md 92 90 90 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/openidconnect/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/saml2/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/submit-oin-app/main/scim/what-need.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/updating-saml-cert/main/index.md 89 100 69 89
packages/@okta/vuepress-site/docs/reference/org-defaults/index.md 85 100 87 100

Successfully checked 20 of 20 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

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.

3 participants