Skip to content

[OKTA-1264089] Register an app with CIMD - #6423

Merged
sophiajose-okta merged 4 commits into
release-2026-09-1from
tc-cimd-app-registration-guide
Sep 16, 2026
Merged

sophiajose-okta merged 4 commits into
release-2026-09-1from
tc-cimd-app-registration-guide

Conversation

@thomascavanagh-okta

@thomascavanagh-okta thomascavanagh-okta commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Description:

  • What's changed? Guide that explains how to register an app with CIMD
  • Is this PR related to a Monolith release? Yes, 2026.09.1

Resolves:

Vercel Preview Link:

https://tc-cimd-app-registration-guide--developer-docs.vercel.app/docs/guides/app-cimd-registration/main/

@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/guides/app-cimd-registration/index.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/app-cimd-registration/main/index.md 89 100 83 87
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78

Successfully checked 3 of 3 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/guides/app-cimd-registration/index.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/app-cimd-registration/main/index.md 90 100 83 91
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78

Successfully checked 3 of 3 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.

@thomascavanagh-okta thomascavanagh-okta added the docs release Tagged to be released during scheduled docs release label Sep 11, 2026
Comment thread packages/@okta/vuepress-site/docs/guides/app-cimd-registration/main/index.md Outdated
Comment thread packages/@okta/vuepress-site/docs/guides/app-cimd-registration/main/index.md Outdated
Comment thread packages/@okta/vuepress-site/docs/guides/app-cimd-registration/main/index.md Outdated
You complete the first three steps in your Okta org. The app owner completes the last two in their own code.

1. [Add a CIMD client to an app integration](#add-a-cimd-client-to-an-app-integration), either by [registering a new app integration](#register-a-new-app-integration) or by [converting an existing one](#convert-an-existing-app-integration). For either method, the CIMD URL becomes the client identifier for that app integration's OAuth 2.0 client.
1. [Assign users to the app integration](#assign-users-to-the-app-integration) so that they can authorize the app.

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.

authorize the app to?? Make authorization requests on their behalf?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Good find! I think it should say "Assign users to the app integration so that they can access the app."
Maybe "sign in to the app" instead?

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.

use sign in to be more specific.

Co-authored-by: Susan <susan.harper@okta.com>
@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/guides/app-cimd-registration/index.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/app-cimd-registration/main/index.md 90 100 83 91
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78

Successfully checked 3 of 3 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/guides/app-cimd-registration/index.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/app-cimd-registration/main/index.md 90 100 83 91
packages/@okta/vuepress-site/docs/guides/index.md 87 67 80 78

Successfully checked 3 of 3 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.

@sophiajose-okta
sophiajose-okta changed the base branch from master to release-2026-09-1 September 16, 2026 05:19
@sophiajose-okta
sophiajose-okta merged commit d0245cb into release-2026-09-1 Sep 16, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs release Tagged to be released during scheduled docs release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants