Pitileni ku fyalimo

Connect Microsoft 365

Create an app registration in Microsoft Entra and store it in the platform – for mail, calendar, To Do, contacts and OneNote.

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:

  1. Name: e.g. RIVUS360.
  2. Supported account types: Accounts in this organizational directory only.
  3. Redirect URI: platform Web, address https://<your-address>/sync/oauth/microsoft/callback/ – a single entry covers mail and synchronisation.
  4. Under Certificates & secrets, create a new client secret. Note the value immediately and the expiry date.
  5. 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):

Microsoft API settings

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.

Ukwafwa & Ukwafwilisha

Tamwasanga ico mwalefwaya? Iciputulwa ne cifulo ca kwafwa fili pa kutinikapo kumo fye.