Skip to main content

SharePoint Integration

Link your SharePoint to SideDrawer

Written by Support
Updated today

To configure the SharePoint integration with SideDrawer, you will need:

  1. Admin access to your Microsoft Azure environment

  2. Admin credentials for your SharePoint account

  3. Admin access to your SideDrawer Console

Configure SharePoint Integration in Microsoft Azure

In Azure, you will need to set up and authorize the SideDrawer integration, and copy the Client ID, Tenant ID, and Client Secret, which you'll use in the next step to authorize the integration from your SideDrawer Console.
As you go through the steps in Azure, you'll want to copy these values to your clipboard or a temporary note or text file - just make sure to delete the note when you're done.

  1. Log into the Microsoft Azure portal using your admin credentials
    ​

  2. Open the Azure Active Directory
    ​

  3. Navigate to the App registrations menu
    ​

  4. In the top menu, select New registration
    ​

  5. Give the registration a name - e.g. SideDrawer Integration
    ​

  6. Select the Supported account types - usually, this will be the first option, Accounts in this organizational directory only
    ​

  7. Click Register to create the registration
    ​

  8. Now that your registration is created, under Essentials, copy the Application (client) ID and Directory (tenant) ID values
    ​

  9. In the navigation list, select Manage->API permissions
    ​

  10. Under Configured permissions, select Add a permission - this will open the Request API permissions panel
    ​

  11. In API permissions, add the following permissions:
    ​


    Required Permissions (8 total):

    1. Microsoft Graph -> User.Read

    2. SharePoint -> AllSites.Read

    3. SharePoint -> AllSites.Write

    4. SharePoint -> MyFiles.Read

    5. SharePoint -> MyFiles.Write

    6. SharePoint -> Sites.Search.Al

    7. SharePoint -> Sites.Selected

    8. SharePoint -> User.Read.All
      ​

  12. Next, you'll need to generate the Client Secret - this is the password that you will enter in your SideDrawer Console to authorize the connection between SideDrawer and SharePoint
    In the left-hand menu, select Certifications & secrets, then New client secret:
    ​


    ​

  13. Select the expiration period - a Client Secret has a built-in expiration date and will need to be renewed after 6 months, 1 year, or 2 years.
    We recommend setting your Client Secret for 1 year - remember to come back and renew it before it expires!
    ​

  14. Copy the Client Secret to your clipboard or to the same temporary file as the other IDs
    ​

  15. Navigate to the Authentication section and add the SideDrawer Redirect URLs that Microsoft will accept as destinations when returning authentication responses (tokens) after successfully authenticating or signing out users:
    ​

    1. PROD Environment
      ​https://api.sidedrawer.com/api/v1/developers/integrations/provider/sharepoint/auth

    2. DEV Environment
      ​https://api-dev.sidedrawerdev.com/api/v1/developers/integrations/provider/sharepoint/auth

    3. UAT Environment
      ​https://api-uat.sidedraweruat.com/api/v1/developers/integrations/provider/sharepoint/auth

    4. SBX Environment
      ​https://api-sbx.sidedrawersbx.com/api/v1/developers/integrations/provider/sharepoint/auth

    5. NXT Environment
      ​https://api-nxt.sidedrawernxt.com/api/v1/developers/integrations/provider/sharepoint/auth
      ​

  16. Now that you have the integration created in Azure, and have the Application (client) ID, the Directory (tenant) ID, and the Client Secret copied to your clipboard or temporary note, you're ready to set up the integration on the SideDrawer side, from your Console

Configure SharePoint Integration in SideDrawer Console

Before you follow these steps, ensure that you've configured the integration in Microsoft Azure, and that you've copied the Client ID, Tenant ID, and Client Secret so you can enter them here

  1. In your SideDrawer Console, select Developers -> Integrations from the left-hand menu
    ​

  2. Select Set up a new integration:
    ​


    ​

  3. Select SharePoint in the integrations drop-down
    ​

  4. In the details screen, enter the following details:

    1. Name of the integration

    2. Client ID

    3. Client Secret

    4. Tenant ID

    5. Site Name

    6. Callback URL
      ​

  5. Click on Confirm button (the new Integration should be created and listed).

Update Client Secret for Existing Integration

If you've already set up the integration in Azure, here's how to check whether your client secret is expired, and update it if needed:

  1. Verify in the list that your App has ✓ Current value in the Certificates & secrets column (if you don't have a particular one, use SD Integrations)
    ​
    If your App shows an ! Expired value in the Certificates & secrets column, select the App in the list, click on the Client credentials link and add a New client secret.
    ​


​


​

Did this answer your question?