How to Obtain the OneDrive Integration Key

Introduction

OneDrive is Microsoft's cloud-based file hosting service, designed to facilitate seamless file storage, synchronisation, and collaboration across various devices. Users can securely store documents, photos, and videos in the cloud, accessing them from Windows and Mac computers, as well as iOS and Android devices. Integrated with Microsoft 365, OneDrive enables real-time collaboration on Office documents, allowing multiple users to edit files simultaneously. The service offers versioning, ensuring the ability to revert to previous document states, and incorporates robust security features like file encryption and two-factor authentication. With its cross-platform accessibility and integration with Microsoft's suite of productivity tools, OneDrive provides a versatile and efficient solution for individuals and organisations seeking a centralised and collaborative approach to cloud-based file management. A OneDrive connector can be configured in SigningHub Admin by providing two integration keys, i.e. Application ID and Application Secret.

How it works?

1. Create the OneDrive App in Azure Active Directory.

2. Create a OneDrive connector in SigningHub Admin.

3. Configure the OneDrive Connector as Default in SigningHub Admin.

4. Enable your cloud drives in SigningHub Web.

Create the OneDrive App in Azure Active Directory

1. Sign in to the Azure portal using your Azure Active Directory administrator account.

   
2. Select "Azure Active Directory" from the left tab.

   
3. Click on the "Enterprise Applications" from the left panel.

   
4. Click on the "New application" button.

   
5. Type "OneDrive" in the search bar, and select the app icon.

   
6. Enter the name for the app, and click on the "Create" button.

   
7. You will be taken to the app overview screen. Select "Properties" from the left tab.

   
8. From the properties screen, click on the "application registration" hyperlink.

   
9. From the left tab, click on "Authentication".

   
10. Click on the "Add a platform" button.

    
11. From the "Configure platforms" pop up, select "Web".

    
12. Set "https://web.signinghub.com/OAuth/OneDriveCallBack" under :Redirect URls" and click the "Configure" button.

    
13. Select "API permissions" from the left tab.

    
14. From the "API permissions" screen, click the “Add a permission” button. (Permission is needed to read and writes files on OneDrive).

    
15. From the "Request API permissions" screen, select "APIs my organizaion uses".

    
16. Search and select, “Office 365 SharePoint Online”.

    
17. Click on the "Delegated permissions" button.

    
18. Under "Delegated permissions", select “MyFiles.Read" and "MyFiles.Write” permissions. Click the "Add permissoins" button.

    
19. Added permission will be shown as follows.

    
20. Select “Certificates & secrets” from the left tab. Create a new client secret by clicking on the “New client secret” button. Save the client secret for use in the SigningHub connector.

    
21. Get the ClientID, directory ID and endpoints from “Overview”.

    
22. To add a user, go to “Microsoft OneDrive” from “Overview”.

    
23. Click on the “Assign users and groups” button.

    

    Then click on the “Add user/group” button.

    

Create a OneDrive connector

1. Access the SigningHub Admin portal.

2. Click the 'Configurations' option from the navigation panel.

3. Click the 'Connectors' option.

4. Click theicon from the grid header.

   

5. The 'Add' connector screen will appear to add the connector details. It comprises of two sections, i.e. Basic Information and Details. Specify the basic information and click the button to provide the respective connector details.

   

   
6. Click the "Create" button. A new connector will be saved and displayed in the list.

Configure the OneDrive Connector as the Default in the SigningHub Global Settings

1. .Click the 'Configurations' option from the navigation panel.

2. Click the 'Global Settings' option.

3. Select the 'Default Connectors' option from the drop-down.

4. Select the default OneDrive connector for SigningHub Desktop Web. The selected connector will be used to pull the OneDrive content (documents) directly into SigningHub Desktop Web. The OneDrive connectors are managed through the connectors section. See details.

Enable your cloud drives

1. Log in to SigningHub Web with your enterprise owner credentials.

2. Click on "Configurations" from the left panel.

3. Click on "Cloud Drives" in the personal configurations section.

4. Switch on the toggle for the OneDrive cloud drive.

   
5. A pop-up will appear asking for the authentication of the cloud drive. Provide your credentials and click Login.

6. Upon successful authentication, the cloud drive will be enabled and will start appearing in the Post Processing screens.

7. To pull a document from OneDrive, go to the “Sign a new document” screen and click on the OneDrive icon to upload a document.

8. The document will be pushed to the OneDrive account (if post-processing was set during workflow) that has been configured, once the workflow is completed.