Skip to content

docs: add OIDC documentation for Microsoft Entra ID user auth #20202

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.

Sign up for GitHub

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

Jump to bottom
Merged
matifali merged 28 commits into from
Nov 7, 2025
Merged

docs: add OIDC documentation for Microsoft Entra ID user auth #20202

matifali merged 28 commits into from
Nov 7, 2025

Conversation

@PhoenixSheppy
Copy link
Contributor

@PhoenixSheppy PhoenixSheppy commented Oct 7, 2025 •
edited
Loading

Propose Microsoft Entra ID OIDC Directions for Admin Documentation based on my personal experience / setup.

Propose information on changing access URL in Tutorials -> FAQs

@cdr-bot cdr-bot bot added the community Pull Requests and issues created by the community. label Oct 7, 2025
@github-actions
Copy link

github-actions bot commented Oct 7, 2025 •
edited
Loading

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 7, 2025

I have read the CLA Document and I hereby sign the CLA.

@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 7, 2025

recheck

cdrci2 added a commit to coder/cla that referenced this pull request Oct 7, 2025
@cdrci2
@PhoenixSheppy has signed the CLA in coder/coder#20202
012a238
@PhoenixSheppy PhoenixSheppy changed the title Add Microsoft Entra ID OIDC Directions docs: update: Add Microsoft Entra ID OIDC Directions Oct 7, 2025
@PhoenixSheppy PhoenixSheppy changed the title docs: update: Add Microsoft Entra ID OIDC Directions docs: add Microsoft Entra ID OIDC Directions Oct 7, 2025
@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 7, 2025

everything should be tip-top shape, man tight checks on those PRs!

@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 7, 2025

Missed a few spots with "Google" lol, used the google.md as a boilerplate for my writing.

@PhoenixSheppy PhoenixSheppy changed the title docs: add Microsoft Entra ID OIDC Directions docs: add Microsoft Entra ID User Auth OIDC Directions Oct 7, 2025
Copilot AI reviewed Oct 7, 2025
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR adds comprehensive documentation for configuring Microsoft Entra ID authentication with Coder using OpenID Connect (OIDC). The documentation provides step-by-step instructions for setting up authentication integration between Coder and Microsoft's identity platform.

  • Creates a new Microsoft Entra ID OIDC authentication guide
  • Provides detailed Azure app registration setup instructions
  • Includes Coder configuration examples with environment variables

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

PhoenixSheppy and others added 3 commits October 7, 2025 14:56
@PhoenixSheppy
Update docs/admin/users/oidc-auth/microsoft.md
6fa26dc 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@PhoenixSheppy
Update docs/admin/users/oidc-auth/microsoft.md
6c9dc1f 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@PhoenixSheppy
Update docs/admin/users/oidc-auth/microsoft.md
3edc9de 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@DevelopmentCats
Copy link
Contributor

DevelopmentCats commented Oct 7, 2025

You would also want to add this to the docs/manifest.json as well

You can use the commit from when we made the google doc for reference.

ea7025b

@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 7, 2025

You would also want to add this to the docs/manifest.json as well

You can use the commit from when we made the google doc for reference.

ea7025b

Thanks! Done!

@matifali matifali requested a review from david-fraley October 8, 2025 06:52
@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 8, 2025

I added additional information regarding changing your access URL, intended to make this another PR, but whoops got bundled in. Updating desc on this PR to reflect those changes.

@PhoenixSheppy PhoenixSheppy changed the title docs: add Microsoft Entra ID User Auth OIDC Directions docs: add Microsoft Entra ID User Auth OIDC Directions, Information on Changing Access URL in Tutorial -> FAQs Oct 8, 2025
@PhoenixSheppy PhoenixSheppy changed the title docs: add Microsoft Entra ID User Auth OIDC Directions, Information on Changing Access URL in Tutorial -> FAQs docs: add Microsoft Entra ID User Auth OIDC Directions and Information on Changing Access URL in Tutorial FAQs Oct 8, 2025
@PhoenixSheppy PhoenixSheppy changed the title docs: add Microsoft Entra ID User Auth OIDC Directions and Information on Changing Access URL in Tutorial FAQs docs: add Microsoft Entra ID user auth OIDC directions, add Information on changing access URL in tutorial FAQs Oct 8, 2025
@PhoenixSheppy PhoenixSheppy changed the title docs: add Microsoft Entra ID user auth OIDC directions, add Information on changing access URL in tutorial FAQs docs: add Microsoft Entra ID user auth OIDC docs and provide Information on changing access URL Oct 8, 2025
david-fraley
david-fraley requested changes Oct 20, 2025
View reviewed changes
@PhoenixSheppy PhoenixSheppy changed the title docs: add docs for Microsoft Entra ID user auth OIDC docs and on changing access URL add OIDC documentation for Microsoft Entra ID user authentication and changing access URL Oct 22, 2025
@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 22, 2025

Adjusted changes as requested by @david-fraley

pr-title checks are a pain, just ignore, I think the title isn't the issue at hand.

@david-fraley david-fraley changed the title add OIDC documentation for Microsoft Entra ID user authentication and changing access URL docs: add OIDC documentation for Microsoft Entra ID user authentication and changing access URL Oct 22, 2025
@david-fraley david-fraley changed the title docs: add OIDC documentation for Microsoft Entra ID user authentication and changing access URL docs: add OIDC documentation for Microsoft Entra ID user auth Oct 22, 2025
@david-fraley
Copy link
Collaborator

david-fraley commented Oct 22, 2025

Adjusted changes as requested by @david-fraley

pr-title checks are a pain, just ignore, I think the title isn't the issue at hand.

Updated the PR title for ya to match the regex. You needed the doc:... in front of the title, and then for it to be shorter!

david-fraley
david-fraley approved these changes Oct 22, 2025
View reviewed changes
Copy link
Collaborator

@david-fraley david-fraley left a comment •
edited
Loading

Choose a reason for hiding this comment

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

Nice work; thank you for helping us with our docs @PhoenixSheppy!

@DevelopmentCats
Copy link
Contributor

DevelopmentCats commented Oct 22, 2025

Thanks for the contribution @PhoenixSheppy ❤️

DevelopmentCats
DevelopmentCats reviewed Oct 22, 2025
View reviewed changes
@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 22, 2025

Nice work; thank you for helping us with our docs @PhoenixSheppy!

Thanks for the contribution @PhoenixSheppy ❤️

❤️ No problem guys, thanks for creating such wonderful software!

@PhoenixSheppy
Copy link
Contributor Author

PhoenixSheppy commented Oct 30, 2025

Could I get some eyes on this, I'm not sure why, but this has been open for a while now and hasn't been merged after approval.

Thank you.

@github-actions github-actions bot added the stale This issue is like stale bread. label Nov 7, 2025
@matifali matifali merged commit 1d1e1f9 into coder:main Nov 7, 2025
25 checks passed
@github-actions github-actions bot locked and limited conversation to collaborators Nov 7, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

Copilot code review Copilot Copilot left review comments

@DevelopmentCats DevelopmentCats DevelopmentCats left review comments

@david-fraley david-fraley david-fraley approved these changes

Assignees

@PhoenixSheppy PhoenixSheppy

Labels

community Pull Requests and issues created by the community. stale This issue is like stale bread.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@PhoenixSheppy @DevelopmentCats @david-fraley @matifali