ShortPoint aims to provide a smooth and fast integration to data sources from your Microsoft Office 365 services. You can then display these with a focus on usability, productivity, and creativity on your SharePoint page. In order to make this happen, ShortPoint requires integration with Microsoft Graph.
Please note that this integration is different from the Microsoft Graph API Connection Type that we offer in the product since version 8.5.2.0
TABLE OF CONTENTS
Overview
Microsoft Graph is an application programming interface (API) that connects to your Azure AD for authentication services and allows access to your Microsoft 365 tenancy and its contents at any given time. More information can be found in this Microsoft article.
When pulling data from sources such as your Outlook, OneDrive, OneNote, Planner, or Teams applications, ShortPoint requires an authentication token signifying that the application has appropriate permissions to your tenancy. We will be able to get these through Microsoft Graph integration.
Required Permissions
The following permissions are needed to ensure that the Graph API Connection type will work:
Mail.Read
Sites.Read.All
Files.Read.All
Directory.Read.All
Directory.AccessAsUser.All
Notes.Read.All
People.Read.All
OrgContact.Read.All
SecurityEvents.Read.All
Group.Read.All
ChannelMessage.Read.All
These are requested at a Delegated permission type. This means that the Microsoft Graph API connection will run based on the signed-in user’s permissions. It will act on the signed-in user’s behalf and therefore will not have access to anything the signed-in user could not access.
As we build new functionalities in ShortPoint, new permissions will also be required and updated.
Note: At this point, ShortPoint does not support picking a smaller set of permissions to grant during the Graph Integration process. Users will have to grant the whole set of permissions. In case you do not want to grant all these permissions to ShortPoint, please submit a support request to support@shortpoint.com indicating Graph Integration: Permissions as a topic, to set up a smaller set of permissions.
Supported Use Cases and Limitations
Currently, there are more than 80 supported use cases for the Microsoft Graph API connection type. We suggest visiting our solution article to check the full Use Cases list.
Having multiple resources and use cases available, there are some specific resources and endpoints that are not supported by ShortPoint Microsoft Graph API connection. Continue to Microsoft Graph API: Limitations solution article to know more.
Integration Options
Depending on where you are connecting and what you intend to do, view the steps to complete Microsoft Graph integration through the following articles:
Related articles: