For users to connect their Microsoft 365 mailboxes, calendars, tasks (To Do), contacts and OneNote notebooks, the platform needs an app registration in your Microsoft directory (Entra ID). Users then sign in themselves with "Sign in with Microsoft" and confirm the access once. No password and no token ever leaves the server.
1. Register the app in Microsoft Entra
In the Microsoft Entra admin center under Applications → App registrations → New registration:
- Name: e.g. RIVUS360.
- Supported account types: Accounts in this organizational directory only.
- Redirect URI: platform Web, address
https://<your-address>/sync/oauth/microsoft/callback/– a single entry covers mail and synchronisation. - Under Certificates & secrets, create a new client secret. Note the value immediately and the expiry date.
- Under API permissions → Microsoft Graph → Delegated permissions, add:
| Permission | For |
|---|---|
User.Read, offline_access |
sign-in, lasting connection |
Mail.ReadWrite, Mail.Send |
read and send mail |
Mail.ReadWrite.Shared, Mail.Send.Shared |
shared mailboxes only (info@, team mailbox) |
Calendars.ReadWrite |
calendar |
Tasks.ReadWrite |
reminders and tasks (Microsoft To Do) |
Contacts.ReadWrite |
contacts |
Notes.ReadWrite |
OneNote |
Optionally grant admin consent – then users do not have to consent individually.
2. Store it in the platform
Admin settings → System → Graph API (tenant level, applies to all companies; a company can also have its own configuration):
| Field | Value from Entra |
|---|---|
| Microsoft service | Microsoft Graph API |
| Authentication method | OAuth 2.0 |
| Microsoft tenant ID | Directory (tenant) ID |
| Client ID / Application ID | Application (client) ID |
| Client secret | the secret's value |
| Secret expires on / Reminder before expiry | expiry date – the platform reminds you in time |
Tick Default configuration and Active, then Save configuration. Tenant ID, client ID and secret are stored encrypted; the secret cannot be read back afterwards.
Warning: When the client secret expires, all Microsoft connections break. Create a new one in good time and enter it here.
Continue with Set up mailboxes.
