Skip to content

OKTA-954373 - Update the registration inline hook guide#6201

Merged
brianduffield-okta merged 9 commits into
masterfrom
bd-okta-954373-update-registration-inline-hook
Jun 8, 2026
Merged

OKTA-954373 - Update the registration inline hook guide#6201
brianduffield-okta merged 9 commits into
masterfrom
bd-okta-954373-update-registration-inline-hook

Conversation

@brianduffield-okta
Copy link
Copy Markdown
Contributor

@brianduffield-okta brianduffield-okta commented Jun 3, 2026

Description:

  • What's changed? Reviewed and revised the Registration Hook Guide to remove Glitch references and to use ngrok
  • Is this PR related to a Monolith release? n/a

Resolves:

Netlify Preview Link:

Preview

@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/registration-inline-hook/main/index.md 81 38 91 86
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/add-your-server-code.md 89 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/install-ngrok.md 74 50 50 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/introbullets.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/run-ngrok.md 92 100 57 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/sample-app.md 90 100 100 100

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

npm install express express-basic-auth express-validator dotenv
```

1. In your `sample-app` folder, add a `.env` file to store the username and password used by the Okta hook call for Basic authentication. Add the following variables and values:
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.

Suggested change
1. In your `sample-app` folder, add a `.env` file to store the username and password used by the Okta hook call for Basic authentication. Add the following variables and values:
1. In your `sample-app` folder, add a `.env` file to store the username and password used by the Okta hook call for basic authentication. Add the following variables and values:

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.

We'll need to review this as a dev doc/info dev standards issue. I've generally used capital Basic because it's referencing a specific type of authentication scheme. However, a quick check of our repo sees all sorts of capitalization/non capitalization. For this doc, I'm going to stick with capital "B" because it forces the user, imo, to understand that it's HTTP Basic Authentication and that you need to reference "Basic" as part of the authorization header.

});
```

Add the following code to use Basic Authentication to validate the incoming call from Okta against the values in the `.env` file. See [HTTP header: Basic Authentication](/docs/guides/secure-hooks/nodejs/main/#http-header-basic-authentication).
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.

Suggested change
Add the following code to use Basic Authentication to validate the incoming call from Okta against the values in the `.env` file. See [HTTP header: Basic Authentication](/docs/guides/secure-hooks/nodejs/main/#http-header-basic-authentication).
Add the following code to use basic authentication to validate the incoming call from Okta against the values in the `.env` file. See [HTTP header: Basic Authentication](/docs/guides/secure-hooks/nodejs/main/#http-header-basic-authentication).

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.

See above

Comment thread packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/index.md Outdated
Comment thread packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/index.md Outdated
Comment thread packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/index.md Outdated
Comment thread packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/index.md Outdated
Comment thread packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/index.md Outdated
Comment thread packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/index.md Outdated
@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/registration-inline-hook/main/index.md 81 38 91 86
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/add-your-server-code.md 89 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/install-ngrok.md 74 50 50 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/introbullets.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/run-ngrok.md 92 100 57 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/sample-app.md 90 100 100 100

Successfully checked 6 of 6 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/registration-inline-hook/main/index.md 81 38 91 86
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/add-your-server-code.md 89 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/install-ngrok.md 74 50 50 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/introbullets.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/run-ngrok.md 92 100 57 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/sample-app.md 90 100 100 100

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

barbaravo-okta
barbaravo-okta previously approved these changes Jun 5, 2026
@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/registration-inline-hook/main/index.md 81 38 91 86
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/add-your-server-code.md 89 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/install-ngrok.md 85 48 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/introbullets.md 100 100 100 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/run-ngrok.md 92 100 57 100
packages/@okta/vuepress-site/docs/guides/registration-inline-hook/main/nodejs/sample-app.md 90 100 100 100

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

@brianduffield-okta brianduffield-okta merged commit d15d7a5 into master Jun 8, 2026
5 checks passed
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