Skip to content

docs: add entra connect guide - #1431

Merged
nibalizer merged 5 commits into
mainfrom
nibz/entra_connect_guide
Jul 27, 2026
Merged

docs: add entra connect guide#1431
nibalizer merged 5 commits into
mainfrom
nibz/entra_connect_guide

Conversation

@nibalizer

Copy link
Copy Markdown
Contributor

Pull Request Description

Adds docs on setting up an Entra tenant and adding it.

What and why?

How to test

What needs special review?

Dependencies, breaking changes, and deployment notes

Release notes

Checklist

  • What and why
  • Screenshots or videos (Frontend)
  • How to test
  • What needs special review
  • Dependencies, breaking changes, and deployment notes
  • Labels applied
  • PR linked to Shortcut
  • Unit tests added (Backend)
  • Tested locally
  • Documentation updated (if required)
  • Environment variable additions/changes documented (if required)

@github-actions

Copy link
Copy Markdown
Contributor

Pull requests must include at least one of the required labels: internal (no release notes required), highlight, enhancement, bug, deprecation, documentation. Except for internal, pull requests must also include a description in the release notes section.

@github-actions

Copy link
Copy Markdown
Contributor

PR Summary

This PR updates the documentation to provide detailed guidance on configuring Single Sign-On (SSO) integration with Microsoft Entra ID (formerly Azure AD). The key changes include:

  • An additional note in the FAQ documentation highlighting the support for SSO integration, now referencing a new footnote which links to the SSO setup guide.
  • Updates to the guide sidebar to include the new 'Configure SSO with Microsoft Entra ID' page, ensuring easier discovery of the SSO configuration instructions.
  • The introduction of a new document that provides a comprehensive, step-by-step guide. This guide covers prerequisites, registration of an application in Entra ID, configuration of token claims, mapping of Entra groups to product roles, and testing the sign-in process.

These enhancements are aimed at helping customers properly integrate their Microsoft Entra ID with our product, ensuring a seamless and secure SSO experience without the need for a client secret.

Test Suggestions

  • Manually follow the new SSO guide instructions to configure integration with Microsoft Entra ID and verify that each step is clear and functional.
  • Check that the sidebar link navigates correctly to the new SSO guide page.
  • Verify that all cross-references and footnotes, such as [^12], properly link to the intended documentation sections.
  • Ensure consistency in formatting and style across the updated pages.

@nibalizer nibalizer added the documentation Improvements or additions to documentation label Jul 23, 2026
Comment thread site/guide/configuration/configure-sso-with-entra.qmd Outdated
Comment thread site/guide/configuration/configure-sso-with-entra.qmd Outdated
@github-actions

Copy link
Copy Markdown
Contributor

Validate docs site

✓ INFO: A live preview of the docs site is available — Open the preview

@github-actions

Copy link
Copy Markdown
Contributor

Lighthouse check results

✓ INFO: Average accessibility score is 0.92 (required: ≥0.9) — View the workflow run

Audit mode: changed pages (3 URL(s))

Show Lighthouse scores

Commit SHA: 8c95039

For a thorough audit, run the Lighthouse check workflow manually (Actions → Lighthouse check → Run workflow) with depth 0–2, or add the lighthouse:full label for depth 2 on the next validate run.

Page Accessibility Performance Best Practices SEO
/faq/faq-organizations.html 0.91 0.42 1.00 0.82
/faq/faq-organizations.html 0.91 0.73 1.00 0.82
/guide/configuration/configure-sso-with-entra.html 0.93 0.71 1.00 0.82
/guide/configuration/configure-sso-with-entra.html 0.93 0.76 1.00 0.82
/guide/configuration/managing-users.html 0.91 0.66 1.00 0.82
/guide/configuration/managing-users.html 0.91 0.76 1.00 0.82
/faq/faq-organizations.html 0.91 0.70 1.00 0.82
/guide/configuration/configure-sso-with-entra.html 0.93 0.73 1.00 0.82
/guide/configuration/managing-users.html 0.91 0.70 1.00 0.82

@nibalizer
nibalizer added this pull request to the merge queue Jul 27, 2026
Merged via the queue into main with commit ce1a95b Jul 27, 2026
5 checks passed
@nibalizer
nibalizer deleted the nibz/entra_connect_guide branch July 27, 2026 15:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants