--- title: SharePoint File Integration Setup description: SharePoint, Files, Integration, setup --- [Skip to content](https://help.myhubintranet.com/sharepoint-file-integration-setup#main-content) ![logo-large-square-1](https://help.myhubintranet.com/hs-fs/hubfs/logo-large-square-1.png?width=120&height=120&name=logo-large-square-1.png) Open main navigation Close main navigation How can we help you? - There are no suggestions because the search field is empty. 1. [MyHub Knowledge Base](https://help.myhubintranet.com/?hsLang=en-us) 2. [Settings, General & Other](https://help.myhubintranet.com/settings-general-other?hsLang=en-us) # SharePoint File Integration Setup ### What This Guide Covers This guide walks an administrator through setting up SharePoint Online as a file provider in the Display and Share Files module. Once configured, administrators and content editors can browse SharePoint document libraries and select files to display on your intranet pages. > **Your instance of Azure/Entra may be different and options may be different, so some of these options/settings may be in different places.**  > > If you have **AI Search** enabled for your site, these files will be included in the search results.   --- ### Before You Begin You will need: - Access to your organisation's [Azure Portal](https://portal.azure.com/) with permission to register applications and grant admin consent - The URL of the SharePoint site you want to connect (e.g. `https://contoso.sharepoint.com/sites/Marketing`) - A MyHub portal administrator account to enter the credentials into the FileShare module --- ### Step 1 — Register an Application in Microsoft Entra ID 1. Sign in to [https://entra.microsoft.com](https://entra.microsoft.com/) (Microsoft Entra admin center) 2. In the left navigation, go to **Entra ID** \> **App registrations** 1. **![](https://help.myhubintranet.com/hs-fs/hubfs/image-png.png?width=265&height=352&name=image-png.png)** 3. **Click **New registration**** 1. ****![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-1.png?width=670&height=101&name=image-png-1.png)**** 4. ****Fill in the registration form:**** - - **Name**: `MyHub FileShare SharePoint` (or any name that identifies this integration) - **Supported account types**: Select **Accounts in this organizational directory only (Single tenant)** - **Redirect URI**: Leave blank — client credentials flow does not use a redirect      5.  Click **Register**   After registration, you will land on the app's Overview page. Note down the following, as you will need them later: | Value | Where to find it | | --- | --- | | **Application (client) ID** | Shown on the Overview page — this is your `clientId` | | **Directory (tenant) ID** | Shown on the Overview page — this is your `tenantId` | ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-3.png?width=658&height=351&name=image-png-3.png) --- ### Step 2 — Create a Client Secret 1. In your app registration, select **Certificates & secrets** from the left menu 1. ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-4.png?width=283&height=619&name=image-png-4.png) 2. Under the **Client secrets** tab, click **New client secret** 1. **![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-09-09-9550-PM.png?width=670&height=170&name=image-png-Jun-17-2026-07-09-09-9550-PM.png)** 3. Enter a **Description** (e.g. `MyHub FileShare`) and choose an **Expiry** period. **Please note the expiry period, with a reminder to create a new secret when it expires, as MyHub cannot see the secret or the expiry date. When it expires, you will need to create a new one and add it to your MyHub site.** 4. Click **Add** 5. **Immediately copy the secret Value** — this is your `clientSecret` 1. ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-14-58-2944-PM.png?width=670&height=178&name=image-png-Jun-17-2026-07-14-58-2944-PM.png) > **Important:** The secret value is only shown once. If you navigate away without copying it, you must delete it and create a new one. --- ### Step 3 — Grant API Permissions 1. In your app registration, select **API permissions** from the left menu 1. ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-19-16-6240-PM.png?width=231&height=615&name=image-png-Jun-17-2026-07-19-16-6240-PM.png) 2. Click **Add a permission** 1. **![](https://help.myhubintranet.com/hs-fs/hubfs/undefined-Jun-17-2026-07-19-56-9403-PM.png?width=590&height=225&name=undefined-Jun-17-2026-07-19-56-9403-PM.png)** 3. Select **Microsoft Graph** from the list of APIs 1. ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-20-34-1474-PM.png?width=670&height=276&name=image-png-Jun-17-2026-07-20-34-1474-PM.png) 4. Select **Application permissions** (not Delegated) 5. Find and check **Sites.Read.All** - ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-23-12-0512-PM.png?width=670&height=184&name=image-png-Jun-17-2026-07-23-12-0512-PM.png) - This allows the app to read all SharePoint site collections via Microsoft Graph - If your organisation requires shareable link creation, also add `Sites.ReadWrite.All` 6. Click **Add permissions** 7. Click **Grant admin consent for \[Your Organisation\]** 1. **![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-24-22-4530-PM.png?width=670&height=129&name=image-png-Jun-17-2026-07-24-22-4530-PM.png)** 8. Confirm by clicking **Yes** The **Status** column next to `Sites.Read.All` should now show a green tick marked **Granted for \[org\]**. ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-24-49-5559-PM.png?width=670&height=129&name=image-png-Jun-17-2026-07-24-49-5559-PM.png) > **Why Microsoft Graph, not the SharePoint API?** The module makes all SharePoint calls through Microsoft Graph endpoints (`/sites/`, `/drives/`, `/items/`). Permissions must be added under **Microsoft Graph** — adding them under the separate SharePoint API entry will not grant the access the module needs. > > **Why admin consent is required:** `Sites.Read.All` is an application permission. It grants access to all sites across the tenant without a specific user signing in. Only a tenant administrator can approve this. --- ### Step 4 — Find Your SharePoint Site URL Your site URL follows this format: ``` https://[tenant].sharepoint.com/sites/[sitename] ``` Examples: - `https://contoso.sharepoint.com/sites/Marketing` - `https://contoso.sharepoint.com/sites/IT` - `https://contoso.sharepoint.com` (root site) You can copy the URL directly from your browser when visiting the SharePoint site. Use only the site root — do not include any library or folder path. --- ### Credentials to Enter in MyHub Once the above steps are complete, enter the following values in the MyHub FileShare provider configuration (accessible from Site Settings - File Share Settings or the module's Change Source screen): ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-17-2026-07-29-33-4191-PM.png?width=670&height=311&name=image-png-Jun-17-2026-07-29-33-4191-PM.png) | Field in MyHub | Value | | --- | --- | | **Tenant ID** | Directory (tenant) ID from Step 1 | | **Client ID** | Application (client) ID from Step 1 | | **Client Secret** | Secret value from Step 2 | | **Site URL** | Full SharePoint site URL from Step 4 | --- ### Required Permissions Summary | Permission | Type | Purpose | | --- | --- | --- | | `Sites.Read.All` | Application | Browse document libraries and read file metadata | --- ### Troubleshooting **Test connection fails with "Access denied"** : Confirm admin consent was granted (Step 3). The status column in API permissions must show a green tick. - Confirm the permission type is **Application** (not Delegated). **Test connection fails with "Tenant not found"** : Double-check the Tenant ID. It must be the Directory ID GUID from Microsoft Entra ID, not the tenant domain name. **Secret expired** : Return to the app registration in the Microsoft Entra admin center, go to **Certificates & secrets**, delete the expired secret, create a new one, and update the `clientSecret` value in the FileShare module provider settings. Make a calendar reminder before the next expiry date. **"Sites.Read.All does not give access to a specific site"** : This is expected — `Sites.Read.All` is a tenant-wide permission by design. If your security policy requires site-scoped access only, contact your SharePoint administrator about site-level app permissions. - [Contacting MyHub](https://help.myhubintranet.com/contacting-myhub?hsLang=en-us) - [Modules](https://help.myhubintranet.com/modules?hsLang=en-us) - [MyHub Security](https://help.myhubintranet.com/myhub-security?hsLang=en-us) - [User Management & Permissions](https://help.myhubintranet.com/user-management-permissions?hsLang=en-us) - [Learning Management System](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#main-content) - [Overview Video](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#overview-video) - [Settings & Configuration](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#settings-configuration) - [Content & Library](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#content-library) - [Pathways](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#pathways) - [Roadmaps](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#roadmaps) - [Gamification & Badges](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#gamification-badges) - [Learnings](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#learnings) - [Events](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#events) - [Learning Management Forms](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#learning-management-forms) - [Certificate](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#certificate) - [Announcements](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#announcements) - [Continuing Professional Development (CPD)](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#continuing-professional-development-cpd) - [Reporting & Dashboards](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#reporting-dashboards) - [Settings, General & Other](https://help.myhubintranet.com/settings-general-other?hsLang=en-us) - [Single Sign On Options](https://help.myhubintranet.com/single-sign-on-options?hsLang=en-us) - [Performance & Growth Module](https://help.myhubintranet.com/performance-growth-module?hsLang=en-us) [![blank-logo-1](https://help.myhubintranet.com/hs-fs/hubfs/blank-logo-1.png?width=10&height=10&name=blank-logo-1.png "blank-logo-1")](https://www.myhubintranet.com) © [MyHub Intranet Software](https://www.myhubintranet.com/) 2025.