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
- Log on to the Azure portal: Microsoft Azure
- Open Manage Azure Active Directory and select View.
- On the left side, select App registrations.
- At the top, select New registration.
- Enter an appropriate name for the access connector, for example, One Drive Popsync Connector.
- 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
- Select Register and agree to the Microsoft Platform Policies.
2. Setup Redirect URI for OAuth2
- On the left side, select Authentication.
- Select Add a platform and choose Web.
- 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.
- On the screen that appears, confirm the OAuth2 endpoint is set.
3. Add Permissions for OneDrive File Access
- Select API Permissions.
- Select Add a permission.
- Select Microsoft Graph.
- Select Delegation permissions.
- In the search box, type files.
- Select the Files.Read.All permission.
- Select Add permissions to confirm.
- Confirm that the Files.Read.All’ permission exists.
a. Your Azure admin should not need to approve this permission since we are asking for Read access and not Write access.
4. Create a Client Secret
- Select and enter Certificates & secrets.
- Select New client secret.
- Enter an appropriate name, for example, OneDrive Popsync Connector.
- 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.
- Select Add and confirm the creation of the secret value.
- Store the secret value somewhere safe. You are only able to view it once, and then it is hidden from view, requiring recreation if you need to reference it again.
5. Find Client ID
- 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 the connector in the Bluescape Config Center for searches in Popsync using your Azure account.
7. After completing your OneDrive setup
- After purchasing Popsync with Cloud Drive Search, send a request to email@example.com indicating which of your Bluescape Orgs you want Popsync OneDrive Search enabled.
- For each Bluescape Org you would like to use Popsync Search with a configured OneDrive, log in as the Org Admin, at this link: https://admin.apps.us.bluescape.com/
- At the top right of the page, select the icon to open the Configuration Center.
- Select Integrations > MANAGE (under the OneDrive logo).
- A Configuration screen appears. Enter these three 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).
- Select OK.
8. Test your configuration
- Log in to Bluescape Home.
- At the left, under Teams, select a Popsync-configured Bluescape Organization.
- Create a new Workspace.
- Open the Popsync provider list. The new OneDrive entry is present.
- Select the Login button next to it and use your username and password to allow Popsync access to your data.
- Confirm that a Popsync search of your OneDrive system works.
- 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.