This guide shows how you can set up OAuth integration between Microsoft accounts and Rocket.Chat.
This is achieved with the use of (formerly called ) which is an identity service by Microsoft that provides single sign-on and other authentication methods.
To create a custom authentication method for your Rocket.Chat instance:
Navigate to Administration > Workspace > Settings > OAuth and click on Custom OAuth and set the new OAuth integration name
After creating the new integration, you are given the callback URL followed by other fields to configure
Create a new App Registration
After registering your new app, take note of Application (client) ID it will be needed to configure the integration later.
On your new app's page, navigate to Certificates and Secret tab to create a New client secret
After creating, take note of the client secret immediately, it is only displayed once. You'll need it to configure the integration in your Rocket.Chat workspace.
After creating the Azure Active Directory App with its secret, head over back to your Rocket.Chat O365 custom OAuth integration page in your workspace and set the various fields.
Enable: Set to true to enable this OAuth integration
URL: https://login.microsoftonline.com/<tenant ID>
Token Path: /oauth2/token
Token Sent Via: Payload
Identity Token Sent Via: Header
Identity Path: /openid/userinfo
Authorize Path: /oauth2/authorize
Scope: openid
Param Name for access token: access_token
Id: <Your Azure AD Application (client) ID>
Secret: <Your Azure AD client secret>
Login style: Redirect
Button Text: Login via Microsoft
Merge Users: True
Merge Users From Distinct Services: True
Do the configurations and Save changes
After saving, you will find the O365 Oauth button on the login and signup page. Clicking on them brings up a popup to authenticate your Microsoft account
Simply sign in to your Office account to authenticate
Accept the permission required to proceed
Log in to your then navigate to the Microsoft Entra ID tab
Fill in the name and other fields including the redirect URI provided by Rocket.Chat when
