Skip to content

Docs: Update SSO with Auth0 guide DRAFT #26488

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 5 commits into
base: main
Choose a base branch
from
Draft

Docs: Update SSO with Auth0 guide DRAFT #26488

wants to merge 5 commits into from

Conversation

aimeeu
Copy link
Contributor

@aimeeu aimeeu commented Aug 8, 2025

Description

The Jira tickets asks to clarify the use of callback URL localhost:4649 in the guide. When I tested the guide, I noticed that the Auth0 steps are outdated.

  • Rewrote Auth0 section to remove step-by-step guide. We don't duplicate how to perform an action in an external product, so I refactored to tell the user what is needed and link to Auth0 docs. Exception: Create a post-login trigger. Auth0 doesn't have docs on how to do that. (I also found Auth0 and Nomad docs content that no longer matches the Auth0 dashboard UI).
  • Style guide updates

Note
The process in the original tutorial works, but I couldn't find any Auth0 documentation to support the custom action content, so I updated using the process Auth0 has documented.

This page was moved verbatim from tutorials in Nomad IA phase 1 so backport only to stable-website and 1.10.x.

Testing & Reproduction steps

  1. Deploy or have access to Nomad cluster. I spun one up on AWS.
  2. Create Auth0 account.
  3. Follow guide instructions.

Links

Jira: CE-1001

Deploy preview https://nomad-git-ce1001oidc-hashicorp.vercel.app/nomad/docs/secure/authentication/sso-auth0

Contributor Checklist

  • Changelog Entry If this PR changes user-facing behavior, please generate and add a
    changelog entry using the make cl command.
  • Testing Please add tests to cover any new functionality or to demonstrate bug fixes and
    ensure regressions will be caught.
  • Documentation If the change impacts user-facing functionality such as the CLI, API, UI,
    and job configuration, please update the Nomad website documentation to reflect this. Refer to
    the website README for docs guidelines. Please also consider whether the
    change requires notes within the upgrade guide.

Reviewer Checklist

  • Backport Labels Please add the correct backport labels as described by the internal
    backporting document.
  • Commit Type Ensure the correct merge method is selected which should be "squash and merge"
    in the majority of situations. The main exceptions are long-lived feature branches or merges where
    history should be preserved.
  • Enterprise PRs If this is an enterprise only PR, please add any required changelog entry
    within the public repository.

@aimeeu aimeeu added the theme/docs Documentation issues and enhancements label Aug 8, 2025
@aimeeu aimeeu requested a review from a team as a code owner August 8, 2025 20:50
@aimeeu aimeeu added the backport/website This will backport PR changes to `stable-website` && the latest release-branch label Aug 8, 2025
@aimeeu aimeeu requested review from a team as code owners August 8, 2025 20:50
@aimeeu aimeeu added the backport/1.10.x backport to 1.10.x release line label Aug 8, 2025
@aimeeu aimeeu marked this pull request as draft August 8, 2025 20:50
@aimeeu aimeeu changed the title Docs: Update SSO with Auth0 guide Docs: Update SSO with Auth0 guide DRAFT Aug 8, 2025
@aimeeu aimeeu requested a review from tunzor August 11, 2025 12:48
Copy link
Contributor

@tunzor tunzor left a comment

Choose a reason for hiding this comment

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

LGTM 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport/website This will backport PR changes to `stable-website` && the latest release-branch backport/1.10.x backport to 1.10.x release line theme/docs Documentation issues and enhancements
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants