Using MS Graph Connectivity to Work with O365 Data¶
For users of the Email Sidebar on:
2 min read
MS Graph secure API can be used instead of Exchange Web Services to work with MS Office 365 data via RG Email Sidebar. MS Graph has several benefits over EWS; it is mostly in demand for high-security corporate environments, as it offers configurable granular data access permissions control. It allows to provide focused access only to specific Office 365 data types, e.g. Contacts, Tasks, Emails, or Calendar items. The same configured MS Graph data access permissions are applied for both RGES Sync app and RGES Add-In app; item types with disabled access permissions remain inaccessible by RG Email Sidebar.
Also see this Microsoft article to learn more about MS Graph data access control management and security.
This access type can be enabled for a specific org or a specific user in an Org via RGES Admin panel: open the Organizations tab > Mailbox access type > set to MS Graph
Server IP whitelisting is also required to work via MS Graph but involves a different set of IPs, you can request the list from our Support team.
Tip
After user switching from another access type or after a new user is initialized: the user must re-login via O365 OAuth 2.0 in order to refresh the access token
Another special feature of MS Graph is its full data exchange compatibility with other Microsoft 365 apps: MS Teams, MS Office apps, OneNote, etc. For example, RG Email Sidebar can be configured to auto-generate MS Teams room links for its Meeting Scheduler features (Time Slots, Book me).
MS Graph Limitations¶
As of RG Email Sidebar version 2302 (winter 2023), there are several limitations for using the Solution via MS Graph:
Note
a. Only Office 365 mailboxes are supported, cannot be used for MS Exchange or Gmail mailboxes
b. OAuth 2.0 mail data access authorization only
c. Notifications on non-essential meeting updates (including past meetings) made by the organizer get automatically sent out to all attendees
d. With MS Graph connectivity, localizations into other languages is implemented for all RG Email Sidebar components, except for Sync dashboard
e. Presently, there are several limitations with Outlook Tasks syncing
f. Calendar events instant sync from MS Outlook to Salesforce is not supported