Configure Microsoft SharePoint Graph connection
Configure a Microsoft SharePoint Graph connection and a connection record that enable your ServiceNow instance to integrate with the Microsoft SharePoint using the Microsoft Graph.
Before you begin
- Request an Integration Hub subscription.
- Activate the Microsoft SharePoint Online spoke.
- Access to Microsoft Azure portal.
- Create an OAuth application on Microsoft Azure portal.
- Role required: admin.
Procedure
Configure a SharePoint Graph connection by adding permissions.
Log in to https://portal.azure.com/.
Select App registrations.
App registration button.
3. Select **All applications** or **Owned applications**.
OAuth application selection options.
4. In the search field, enter the name of the OAuth application you had created.
To learn how to configure an OAuth application, see [Configure OAuth application in Microsoft Azure](configure-oauth-application-in-microsoft-azure.md).
5. In the search results, select the name of the OAuth application you had configured.
6. On the left panel, under the Manage heading, select API permissions.
API permissions link.
7. Under the Configured permissions heading, select **+ Add a permission**.
8. In the Request API permissions window, select **Microsoft Graph**.
Microsoft Graph button.
9. Select **Delegated permissions**.
10. Under the Select permissions heading, enter `site` in the search field.
11. Expand the Sites list.
Sites list.
12. Select `Sites.FullControl.all`, `Sites.Read.All` and `Sites.ReadWrite.All`.
Microsoft SharePoint Online spoke Graph Site permissions.
13. Under the Select permissions heading, enter `User.read` in the search field.
Microsoft SharePoint Online spoke Graph User permissions.
14. Select **Add permissions**.
The permission is added.
Permissions added.
15. To grant admin consent, under the Configured permissions heading, select **Grant admin consent**.
16. Select **Yes**.
Admin consent is mandatory if the value under the Admin consent required column for the Sites.Read.All permission is Yes.
Configure the Microsoft SharePoint Graph connection record.
Log in to your ServiceNow instance.
Note: The URL of the instance and that of the instance you had provided as the redirect URL must be the same.
Navigate to All > Process Automation > Workflow Studio.
Select the Integrations tab.
In the Search all connections field, enter
Microsoft SharePoint.Note: The Outbound tab is selected by default. Confirm that the Outbound tab is already selected.
In the Search all connections field, enter
Microsoft SharePoint.In the MicrosoftSharePointGraph tile, click View Details.
View Details button on Microsoft SharePoint Graph alias.
7. Click **Configure**.
Configure button.
8. On the form, fill these details.
| Field | Description | |||
|---|---|---|---|---|
| Connection Name | The name of the connection record. The default and read-only name of the first connection record is MicrosoftSharePointGraph. To provide a custom name, you must create a connection record by clicking Add connection. | |||
| Connection URL | The URL to connect to the Microsoft Graph APIs. The URL is https://graph.microsoft.com/v1.0. | |||
| OAuth Entity Name | Name of the OAuth application that you created. To learn how to create an OAuth app, see Configure OAuth application in Microsoft Azure. | |||
| OAuth Client ID | Client ID that was generated when you created the OAuth app. To learn where to find the client ID, see Configure OAuth application in Microsoft Azure. | |||
| OAuth Client Secret | Client secret that was generated when you created the OAuth app. To learn where to find the client ID, see Configure OAuth application in Microsoft Azure. | |||
| OAuth Authorization URL | The URL must be in the format:
The tenant ID is available under the Basic information heading. Image omitted: MS-sharepoint-spoke-graph-tenant-ID.png OAuth Token URLTenant ID.</p></td></tr><tr><td> | The URL must be in the format:
The tenant ID is available under the Basic information heading. Image omitted: MS-sharepoint-spoke-graph-tenant-ID.png Token Revocation URLTenant ID.</p></td></tr><tr><td> | The URL must be in the format:
The tenant ID is available under the Basic information heading. Image omitted: MS-sharepoint-spoke-graph-tenant-ID.png OAuth Redirect URLTenant ID.</p></td></tr><tr><td> | The URL must be in the format: `https:// Image omitted: ms-sharept-graph-conn-form.png Microsoft SharePoint Graph connection form.
Image omitted: MS-sharepoint-spoke-graph-connection-created.png Connection created.
|