EchoVideo supports integration with Microsoft OneDrive, allowing EchoVideo users to subscribe to any of their OneDrive folders. These subscriptions tell EchoVideo to automatically copy new media files from OneDrive into EchoVideo.

The subscription service works with any OneDrive folder where the user can save their media files, and includes an MS Teams integration to copy Teams meeting recordings and other files into EchoVideo.

The high-level steps for configuring OneDrive to work seamlessly with EchoVideo include:

• In a browser or tab separate from any MS Azure window you may have open, add a OneDrive Configuration in EchoVideo to HOLD the values generated by Azure for the EchoVideo OneDrive App. You will return to this page / tab later.
• Create and register the EchoVideo App in Microsoft Azure. This creates the values necessary for the OneDrive configuration block in EchoVideo.
• Set API Permissions for the app to allow reading of OneDrive, SharePoint Site, and Teams meeting media on behalf of the User, based on user-configured subscriptions to the corresponding folders.
• Generate a Client Secret, then copy and paste the required app values from Azure to the OneDrive Configuration block in EchoVideo. This establishes the server-to-server authentication between EchoVideo and Microsoft.

At this point, users should see a OneDrive Settings tab on the left side of their Account Settings page. This tab allows each user to add, manage, and remove subscriptions to OneDrive folders. These subscriptions automatically copy newly generated OneDrive media files to EchoVideo.

Add a OneDrive Configuration Block in EchoVideo

The OneDrive Configuration block is located on the EchoVideo OneDrive Integrations page, as shown in the figure below. It creates fields to accept the authentication values generated by Microsoft Azure when you create the EchoVideo OneDrive app.

You do not need to add the block before creating the app, but the steps are provided here for documentation purposes. The steps below create the block itself in a separate browser or tab from the Azure procedures, and you will return to it once you have the values for copying / pasting from Azure.

Alternatively, you can copy the values generated through the App creation procedures below into a text editor, then return to EchoVideo, add the block, and copy / paste the values into the fields at the same time. This is a particularly appropriate approach if the EchoVideo Administrator and the Azure Administrator are two different people.

To create a OneDrive configuration block

1. Log in to EchoVideo as an administrator.
2. Click the Settings icon in the upper-right corner of the screen.

3. From the Settings menu, select Institution Settings.

   General settings appear and Basic Info is selected by default.

4. From the left panel, select Integrations.
5. Select OneDrive from the middle panel.

6. Click Add Configuration.

   The Add OneDrive Configuration modal opens.

   

7. Leave this browser tab open while you perform the next set of steps for creating a new App registration in MS Azure. The values you generate there will populate the OneDrive configuration block shown above.

Create the EchoVideo OneDrive App in Azure

All of the steps below are performed by an Azure administrator and assume you have the proper administrative privileges in Microsoft Azure. You must also be an institution-level Administrator in EchoVideo or be working with one to create / update the OneDrive configuration block in EchoVideo, as cited above.

As is common throughout EchoVideo's integration documentation, the procedures below are provided as a guide to the steps necessary in Microsoft Azure. Your interface may differ from what is shown here; if you need assistance, refer to the Microsoft documentation or your Microsoft support representative.

To create the EchoVideo App for OneDrive

1. Log into Microsoft Azure as an administrator, and use the search box to find App Registrations, as shown in the figure below.
   
2. From the top of the App Registrations page, click New Registration.
   
3. In the Register an application form, shown below, complete the entries as follows

   1. Enter a Name that clearly identifies this as the EchoVideo app for OneDrive.

      If you also have the EchoVideo app for MS Teams, be sure to name each app appropriately so you can distinguish them. End users will see the Teams app for use; they will not see the OneDrive app.

   2. Select the Supported account types option that applies to your Microsoft installation.

   3. In the Redirect URI field at the bottom of the form, enter the following, using your regional EchoVideo URL (echo360.org, echo360.net.au, echo360.org.uk, or echo360.ca):

      https://api.echo360.org/onedrive-ingest/oauth2/code

      

4. At the bottom of the form, click Register.

   The page that appears is your registered app Overview page, which contains nearly all the information and values needed to complete the application setup.
   Click Overview on the left to return to this page at any time.

5. Click API Permissions on the left, as shown in the figure below.
6. From above the API / Permissions name table, click Add a Permission, as shown in the figure below.
   
7. Select Microsoft Graph from the top of the Request API permissions dialog box, as shown below.
   
8. Select Delegated permissions as the type of permission you want to add.
   
9. In the Search box above the list of permission categories, type Files to limit the list to available file-type permissions. This is shown in the figure below.
10. Select Files.Read.All, then click Add permissions from the bottom of the dialog box, as shown below.
    
11. Repeat the above steps to also add the following application permissions, replacing "files" in the search with the corresponding terms:
    • Sites.Read.All
    • Team.ReadBasic.All
12. In the API Permissions page, select Grant admin consent for {organization-name} from above the API Permissions table, as identified in the figure below.
    If you do not see this option, you do not have permission to perform this action. Consult with another Azure administrator for access or execution of this task.
    

13. Confirm the change.

    When you are finished, the permissions table should have four entries: four Delegated permissions as shown in the figure above, all with granted admin consent.

    • User.Read is used to view information about the current user and is required for any integration.
    • Files.Read.All is for viewing files the user has access to.
    • Sites.Read.All is for discovering root items in groups the user has access to.
    • Team.ReadBasic.All is used by the EchoVideo Teams integration, which leverages OneDrive.
14. Click Certificates & secrets on the left.
15. Click New client secret.
    
16. In the popup that appears, provide a Description (purpose) for this client secret.
    

17. Select an Expires option that coincides with your institution's security policies. If you select Custom, the maximum you can set is 2 years (24 months), which is already a pre-selectable option.

    NOTE: Microsoft no longer allows you to set a client secret with a Never expiration. This means you will need to create a new secret when (or before) this one expires, and replace the value in your OneDrive configuration block in EchoVideo with the new one.

18. When finished, click Add.

    The page refreshes to show the newly created client secret, including the secret value at the bottom that you will copy and paste into EchoVideo.

    NOTE: You must obtain the value before you navigate away from this page. If you do not, you will need to delete the secret and generate a new one.

19. At the bottom of the page, hover over the Value field for the newly created secret, then click the Copy to clipboard icon that appears, as shown in the figure below.
    

20. Return to the EchoVideo browser or tab used in the first set of instructions on this page and paste the copied secret value into the Secret field of the OneDrive configuration block, as shown below.
    

    Alternatively, if you are not also the EchoVideo administrator, or you do not have the EchoVideo Teams configuration page open at the moment, you can copy the Secret value from Azure and paste it into a text editor, along with the App ID and Tenant ID (from the next steps), and then add these values to EchoVideo later, or pass them onto the EchoVideo Administrator you are working with.

21. Enter a Name for the configuration if you have not already. This can be anything you want.
22. Return to Azure and click Overview on the left.
23. Hover over the App ID field, then click the Copy to clipboard icon as shown in the figure below.
    
24. Return to EchoVideo and paste the copied value into the Application ID field of the OneDrive configuration block.
25. Return to Azure and hover over the Tenant ID field, then click the Copy to clipboard icon.
26. Return to EchoVideo and paste the copied value into the Tenant ID field of the OneDrive configuration block.
27. After the fields in the OneDrive configuration block in EchoVideo are complete, as shown below, click Save.
    

The OneDrive configuration page in EchoVideo changes to show the configuration block as complete. The communication between your EchoVideo OneDrive App in Azure and your EchoVideo tenant is now established.

Your Instructors will now see a OneDrive Settings tab on their Account Settings page. This allows them to add subscriptions to any of their OneDrive folders to automatically copy their files into EchoVideo, including their Teams meetings if desired. Refer them to For Instructors: Using OneDrive with EchoVideo for instructions on subscribing to and mapping OneDrive folder media to EchoVideo.