Introduction

OneDrive is Microsoft's cloud-based file hosting service, designed to facilitate seamless file storage, synchronization, 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 organizations seeking a centralized 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. For adding 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"section from the left menu.
  3. Click the "Connectors" tab. The "Connectors" screen will appear.
  4. Click  from the grid header.



  5. A dialog will appear to add the connector details. The connector dialog is comprised of two screens, i.e. Basic Information and Details. Specify the basic information and click the "Next" button to provide the respective connector details. See the below table for fields description.




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


Basic Information

Fields

Description

Name

Specify a unique name for this connector, i.e. My OneDrive. This connector will be used in the configuration of Global Settings.

Provider

Select the provider for this connector, i.e. "OneDrive". 

Purpose

This field will display the purpose of the selected provider above, i.e. the purpose of "OneDrive" is "Cloud Drive".

Active

Tick this check box to make this connector active. Inactive connectors cannot be configured in the Global Settings.


Details

Fields

Description

Logo

Select an appropriate image in the jpeg, jpg, gif or png format for the connector's logo that will be displayed on the login screen.

Application ID

Specify the registered app ID that has been provided by OneDrive to connect to the OneDrive server, e.g. 6cb83478-721c-9034-8318-78a09f6ed409

Application Secret

Specify the registered app secret that has been provided by OneDrive to connect to the OneDrive server, e.g. Os6iC59BGb8dOmh2jjLJQDM

Allow Multiple Files Selection

Tick this check box to enable the end users to import multiple files from OneDrive.


Configure the OneDrive Connector as Default in the SigningHub Global Settings

  1. Click the "Configurations" option from the left menu.
  2. Click the "Global Settings" option.
  3. Global Settings will appear, select the "Default Connectors" option from the top right drop down. 
  4. Configure these settings as required and click the "Save" button from the screen bottom. 
  5. 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. Access the SigningHub Web portal.
  2. Click your profile drop down menu (available at the top right corner).
  3. Click the "My Settings" option. 
  4. Click the "Cloud Drives" option from the left menu.
  5. Click the "Enable" option against the OneDrive cloud drive.



  6. A pop-up will appear asking for the authentication of the cloud drive. Provide your credentials and click Login.
  7. Upon successful authentication, the cloud drive will be enabled, and will start appearing in the Post Processing screens.
  8. To pull document from OneDrive, go to “Start New Workflow” and click on the OneDrive icon to upload document.
  9. Document will be pushed to the OneDrive account (if post processing was set during workflow) that has been configured, once a workflow will be completed.



See Also