Microsoft oAuth
The Microsoft oAuth integration connects Full Fabric to your institution's Microsoft 365 tenant (Microsoft Entra ID). It powers two features: Outlook calendar sync, which writes course sessions into people's Outlook calendars and into room calendars, and Microsoft sign-in for IMAP email sync, which lets staff connect their Microsoft 365 mailbox without giving Full Fabric a password. Full Fabric uses its own Microsoft application: your institution only supplies its tenant ID, and a Microsoft administrator grants that application access to the tenant.
Note: Microsoft oAuth does not add a sign-in button to the Full Fabric login page. To let people sign in to Full Fabric with their Microsoft Entra ID account, set up a SAML provider instead: see SSO / SAML.
How It Works
- An administrator enters the tenant: in Settings → Microsoft integrations → Authentication → oAuth, add your Microsoft Entra Tenant ID.
- A Microsoft administrator grants consent: the Permissions card links to Microsoft's consent page for your tenant.
- The integration is enabled: click Enable at the top of the page.
- Features start working: staff can connect their mailbox for IMAP sync, and Outlook calendar sync can be turned on for people and rooms.
Connecting the Tenant
Go to Settings → Microsoft integrations, then oAuth under Authentication. The page is titled Microsoft oAuth and has three cards: Microsoft Entra ID, Permissions and Outlook sync.
On the Microsoft Entra ID card, click Add details (or Update details), fill in the fields and click Save details. The card's Read the setup guide link opens the Full Fabric help article on connecting Microsoft email accounts through Microsoft Azure.
| Field | Required | Notes |
|---|---|---|
| Tenant ID | Yes | The tenant ID of your institution's Microsoft Entra ID |
| Domain match | No | An email domain, for example school.edu. When set, Outlook sync writes to the email address on each person's profile that contains this domain, and a person with no such address cannot be synced. When empty, Outlook sync uses each person's main email address. |
Saving the details re-checks the permissions against the tenant you just saved.
Granting permissions
The Permissions card shows what Full Fabric's Microsoft application may do in your tenant:
| Row | Permission shown | Status |
|---|---|---|
| Outlook calendar | Calendars.ReadWrite |
Granted or Not granted |
| IMAP sync | User.Read (delegated) | No status: each staff member grants mailbox access when they connect their own mailbox |
Once the permissions load, the card ends with "A Microsoft admin grants these from the consent page." The consent page link opens Microsoft's admin consent screen for your tenant. Someone with administrator rights in your Microsoft tenant must approve it there. Afterwards, come back to the page and click Refresh on the card: Outlook calendar should show Granted.
Enabling and disabling
Use Enable at the top of the page to switch the integration on. Disable asks for confirmation ("Disable Microsoft oAuth?") and warns that Outlook calendar sync will stop for everyone.
While Microsoft oAuth is disabled:
- No calendar changes are sent to Outlook, for people or rooms
- The Microsoft Outlook option disappears from the Calendar feed window in the academic calendar
- The Outlook Calendar Email field and column disappear from Rooms
- Staff cannot choose Oauth2.0 with a Microsoft email account for IMAP
The Outlook sync card (the Sync until date and Turn on sync for) is covered in Outlook calendar sync.
Connecting a Staff Mailbox for IMAP
With Microsoft oAuth enabled, a staff member can connect their Microsoft 365 mailbox from their own settings:
- Open the IMAP preferences tab.
- Under Please choose your IMAP authentication method, choose Oauth2.0 with a Microsoft email account.
- Enter the Microsoft email address and click Authenticate with Microsoft.
- Sign in at Microsoft and allow Full Fabric to access the mailbox over IMAP and to keep that access.
Full Fabric then returns to the IMAP preferences tab with Microsoft 365 set as the incoming mail server. The tab shows Current status: active. once the mailbox can be reached. Unlink Microsoft account removes the stored Microsoft credentials and, if IMAP was using them, switches IMAP sync off.
Common Failures
| What you see | Usual cause | Fix |
|---|---|---|
| Permissions card: "Microsoft settings are not configured" | No Tenant ID saved | Add the tenant ID on the Microsoft Entra ID card |
| Permissions card: a message starting "Failed to get token:" followed by Microsoft's error | Microsoft refused the tenant, usually a wrong Tenant ID | Check the tenant ID in Microsoft Entra ID and save it again |
| Outlook calendar shows Not granted | Admin consent has not been given yet | Ask a Microsoft administrator to approve the consent page, then click Refresh |
| Permissions card: "The permissions could not be loaded." | The check failed without a message | Click Refresh |
| Oauth2.0 with a Microsoft email account cannot be selected | Microsoft oAuth is disabled | Enable it on the Microsoft oAuth page |
| After Authenticate with Microsoft: "We couldn't verify your identity", with technical details such as "You did not grant access to the sign-in provider." or "Your session expired before the sign-in completed. Please try again." | The staff member declined at Microsoft, or the sign-in did not finish | The page redirects after a few seconds; start again from IMAP preferences |
| IMAP preferences shows "Current status: inactive." and "Unable to authenticate. Please check your IMAP details." | The mailbox could not be reached with the saved details | Check the Microsoft email address, then Authenticate with Microsoft again |
Permissions
The Microsoft integrations section of Settings is shown to staff with Global integrations; see Integrations. Connecting a mailbox is part of each staff member's own IMAP settings.