Microsoft Authentication

[Osama]

	Summary	Microsoft Authentication enables login via Microsoft accounts (AKA Office 365, Microsoft 365 accounts)
	Repository Link	https://github.com/discourse/discourse-microsoft-auth
	Install Guide	How to install plugins in Discourse

As this is an official plugin maintained by the Discourse team, support, bug, ux, and feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

Features

Enables login “with Microsoft” for a forum:

You can update all settings by visiting the Admin > Settings area, and searching for “microsoft auth”

Configuration

Visit https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade and follow the directions for registering a new application.

1. Choose a name (usually your site name)
2. Under Supported account types, select the most permissive option
   
   
3. Add your site as a Redirect URI for Web in this format:
   • https://your.discourse.forum/auth/microsoft_office365/callback
     
     
     and save
4. Visit Certificates & secrets on the left sidebar menu, and
   • Put something simple under Description
   • Choose 24 months under Expires (yes, you’ll have to renew it)
   • copy the Value (this is the Application Secret) and paste into the Plugin settings before you lose it!
5. (Optional) visit Branding if you wish - this stuff is not obviously exposed
6. Visit Overview (also on the left). Copy the Application (client ID) and paste it into the plugin settings.