# SharePoint Microsoft Graph REST API Application Cert

---

#### Remote item name: **SharePoint**

**Integration Type**: Application Permission\
**Authentication Method**: Certificate based

The Microsoft Graph API is a unified REST endpoint for all Microsoft 365 services, treating SharePoint simply as another data source alongside Teams, Outlook, and OneDrive. It allows you to access SharePoint resources like sites, drives, and list items through the single graph.microsoft.com endpoint, using a consolidated permission model.

---

**🛑 Proxy Configuration:** If your environment uses a Proxy or a strict Firewall, you must authorize outbound traffic to the following Microsoft endpoints.

• **login.microsoftonline.com**\
• **graph.microsoft.com**

---

Open the **Microsoft Entra Admin Center** (formerly Azure AD) to manage your app registration: [Microsoft Entra Admin Center Link](https://entra.microsoft.com/)

Navigation: Go to **App registrations**.\
![New registration](SharePoint-Integration/new_registration.png)

**Configure API Permission**: Navigate to API Permissions. Click on Add a permission button. Select **Microsoft Graph**. Then select **Application Permission**. Search for **Files** and check the flag **Files.ReadWrite.All** permission.

![Ms graph app permission](SharePoint-Integration/ms_graph_app_permission.png)

**🛑 Important:** Grant **Admin consent** for the newly added permission.

![App permission admin consent](SharePoint-Integration/app_permission_admin_consent.png)

Fetch the application credentials from your App Registration to enable the integration:

**Client id**: See at App Registration -> Overview -> Application (client) ID

See at App Registration -> **Certificates & secrets**

![Azure app registrations certificates](SharePoint-Integration/azure_app_registrations_certificates.png)

**SharePoint VFS item configuration: Application Permission - Certificate Based**:

![App permission cert based vfs item](SharePoint-Integration/app_permission_cert_based_vfs_item.png)

Select the **Application Permission (cert based)** radio button, then click **Application Permission cert based** button.

![App permission cert based form](SharePoint-Integration/app_permission_cert_based_form.png)

Enter the **Client ID** (See at App Registration -> Overview -> Application (client) ID).

**Thumbprint**: (See at App Registration -> Manage -> Certificates & secrets) Select **Certificates**.\
**Private Key**: This is your application's unique digital credential, which pairs with the public certificate you uploaded in Azure Portal. It allows the system to securely access SharePoint without a password. We accept the **PKCS#8** key text format (often starting with -----BEGIN PRIVATE KEY-----).

**Tenant ID** (See at App Registration -> Overview -> Directory (tenant) ID), then click OK. This will automatically configure the **username** and **password** in the [VFS](VFS.md) item settings. After that, click the **OK** button.

![Client id](SharePoint-Integration/client_id.png)

**Identifying the SharePoint Target**: You must define which part of SharePoint the VFS should connect to. You can either link to a **full Document Library** or a **specific subfolder**.

**Link an Entire Document Library**:

In your web browser, open your SharePoint site and navigate to the **Document Library**. Copy the complete URL from your browser's address bar.

![Shared link document library](SharePoint-Microsoft-Graph-REST-API/shared_link_document_library.png)

It will look similar to this:

```
https://your.sharepoint.com/sites/your_site/Shared%20Documents/Forms/AllItems.aspx
```

**Link a Specific Subfolder**: If you only want the VFS to access a specific subdirectory, use a **Direct Link**:

![Shared link specific folder](SharePoint-Microsoft-Graph-REST-API/shared_link_specific_folder.png)\
In your web browser, open your SharePoint site and navigate to the **Document Library**, and find the specific folder you want to link to. Right-click on the folder. Select **Copy link** from the context menu that appears.\
It will look similar to this:

```
https://your.sharepoint.com/:f:/s/your_site/Evxo0AjlwiZAnajkk56_AC0BDxGQDy7bgNu8F7HHgVMKtQ?e=BgvJps
```

Return to the VFS settings and paste the URL into the **Shared Link** input field.

Click the **Test** button to verify the connection. If successful, click **OK** and then Save your changes.

![Sharepoint application cert vfs](SharePoint-Microsoft-Graph-REST-API-Application-Cert/sharepoint_application_cert_vfs.png)

---

Back to [SharePoint Integration](SharePoint-Integration.md)

---
