Integrating Microsoft OneDrive with Popsync

Support Note
This topic is not relevant to all Bluescape members and may not apply to all Teams. If you’re unsure whether your Team has this integration, please reach out to your IT department.

Microsoft OneDrive and Popsync

Microsofts’ OneDrive is a popular option for users, and now by connecting OneDrive with Popsync, it’s even simpler to find and use your stored images.

1. Create app registration

  1. Log on to the Azure portal: Microsoft Azure

  2. Open Manage Azure Active Directory and select View.
     


     

  3. On the left side, select App registrations.
     


     

  4. At the top, select New registration.
     


     

  5. Enter an appropriate name for the access connector, for example, OneDrive Popsync Connector.

  6. Select who can access the organization.
     
    a. If this is internal to a single organization so users can access their personal OneDrive items, selecting Single tenant is appropriate.
     
    b. For clarification of accounts scopes, review Identity and account types for single- and multi-tenant apps found here: Supported identity and account types for single- and multi-tenant apps | Microsoft Learn.
     

  7. Select Register and agree to the Microsoft Platform Policies.
     

2. Setup redirect URI for OAuth2

  1. On the left side, select Authentication.
     

     
  2. Select Add a platform and choose Web.
     

     
  3. Enter a redirect URL, https://[myorganization].com/codeForTokenExchange.
     
    a. This is the organization-specific endpoint used for token exchange as part of OAuth2. Your Azure admin should be able to direct you where to find or setup this up. Then, select Configure.
     

     
  4. On the screen that appears, confirm the OAuth2 endpoint is set.
     

3. Add permissions for OneDrive file access

  1. Select API Permissions.
     

     
  2. Select Add a permission.
     

     
  3. Select Microsoft Graph.
     

     
  4. Select Delegation permissions.
     

     
  5. In the search box, type files.
  6. Select the Files.Read.All permission.
  7. Select Add permissions to confirm.
     

     
  8. Confirm that the Files.Read.All’ permission exists.
    a. Your Azure admin should not need to approve this permission since we ask for Read access and not Write access.
     

4. Create a client secret

  1. Select and enter Certificates & secrets.
     


     

  2. Select New client secret.
     


     

  3. Enter an appropriate name, for example, OneDrive Popsync Connector.

  4. Choose an appropriate time for Expires.
     
    a. This needs confirmation from your Azure admin for what they are comfortable with. For example, 12 months as that is what the Bluescape Azure admin approved for.

  5. Select Add and confirm the creation of the secret value.
     


     

  6. Store the secret value somewhere safe. You can only view it once, and then it is hidden from view, requiring recreation if you need to reference it again.
     

     

5. Find the Client ID

  1. Select overview and view the Application (client) ID.

6. Final result

At the end of this, you should have a client ID and client secret which should be able to be used as the connector in the Bluescape Config Center for searches in Popsync using your Azure account.
 

7. After completing your OneDrive setup

  1. After purchasing Popsync with Cloud Drive Search, send a request to support@bluescape.com indicating which of your Bluescape Team(s) you want Popsync OneDrive Search enabled.

  2. Log into Bluescape as the Team Admin, and select the Team you want Popsync OneDrive Search enabled. Click on Team Settings and select the Popsync tab.
     

  3. Scroll down to the Digital asset management integrations section. Select Manage under the OneDrive logo
     

  4. A Configuration screen appears. Enter the following values, leaving the others to their default values:
       a. Connection Name (name that appears to users in their Popsync provider list).
       b. OAuth Client Id (from steps above).
       c. OAuth Client Secret (from steps above).

  5. Toggle ON Enable this OneDrive instance with Popsync search.
     

  6. Select Save.

8. Test your configuration

  1. Log in to Bluescape Home.

  2. On the left, under Teams, select a Popsync-configured Bluescape Team.

  3. Create a new Workspace.

  4. Open the Popsync provider list. The new OneDrive entry is present.

  5. Select Login next to it and use your username and password to allow Popsync access to your data.

  6. Confirm that a Popsync search of your OneDrive system works.

Notes

  • It is possible to create a parent-folder-filtered search using the Advanced tab in the Popsync Configuration form. You can filter the search to a single parent folder by entering the folder ID.
  • It is also possible to create multiple search entries for Popsync by selecting New Instance under the Select Instance field at the top of the Enable Search form.
  • Each Bluescape user’s corresponding user must be given access to that drive’s folders to search content. If a user cannot use search to find their content, Popsync can also not find it.

The above instructions assume you are using standard Bluescape and SaaS services. If you are using custom, on-premises, or special (VPI) deployments of either service, contact Bluescape Support.

Where to Next?

Not what you were looking for? Reply below or Search the community and discover more Bluescape.