About
The OneDrive module provides the ability for users to ingest content from their personal OneDrive folder by adding an 'Add from OneDrive' button in the Add New menu. This article is intended for KMS site administrators and describes how to enable and configure the 'OneDrive" module and set the required Microsoft settings.
The accounts shown herein have the theming module enabled.
Set up the OneDrive module
Before enabling the OneDrive module, you must register an application in Microsoft Azure.
Register an application in Microsoft Azure
- Go to https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade.
- Click the +New registration button.
- In the Register an application page, enter the following:
- Name - Enter a meaningful name for the app. (e.g. Kaltura OneDrive integration)
- Check the option: Accounts in any organizational directory (Any Azure AD directory - Multitenant).
- In the Redirect URI, fill in the following:
- Select a Platform: Choose Web.
- Redirect URI: https://{kaltura_site_base_URL}/onedrive/index/blank-page
- Replace "{kaltura_site_base_URL}" with your application base URL.
- Click Register.
A new application is created, and the Overview tab is displayed. Grab the Application (client) ID, and save it for later. - Go to the Certificates & secrets tab and click the +New client secret button.
- Create a client secret and click Add.
- Go to the Authentication tab and check the options:
- Access tokens (used for implicit flows)
- ID tokens (used for implicit and hybrid flows)
- Save your settings.
API Permissions
To get the integration working, you need the following permissions:
- files.read.all: Allows reading all files on the Microsoft 365 platform you have access to.
- openid: Enables multi-factor authentication on the M365 platform.
- profile: Required along with user.read to create a OneDrive URL.
- user.read: Grants read access to user profile information.
Make sure that your KMS site name does not have underscores. If it does, delete the underscores when you type it in.
Enabling the OneDrive module
In your application's Configuration Management console, navigate to the OneDrive module and configure the following:
- Set enabled to 'Yes'.
- Optional - Set which users/groups/roles are allowed to use this tool.
- Enter the Application (client) ID you created in the application page in Microsoft Azure in in the 'applicationId' field.
- Click Save.
Import content from OneDrive
After registering the new application, users may import data from OneDrive from the "Add New" menu.
The application administrator should enable the OneDrive module and set up a registered app in Microsoft Azure.
- Select OneDrive from the + Create drop-down menu. The OneDrive import page is displayed.
- Click Select a file from your OneDrive.
A file picker window displays. - After selected the desired media, the import preparation begins.
- When the media preparation is completed, the import begins. During the import process, you may edit the metadata of the media entry, or navigate away from the page, and the import process will continue in the background.
- After the ingestion is completed, you can view the media in its dedicated page or in your My-Media.
Importing a Teams meeting recording
For Microsoft Teams non-Channel meetings, the recording is stored in a folder named Recordings that's at the top level of the OneDrive for Business that belongs to the person who started the meeting recording.
- Navigate to the Recording folder on OneDrive.
- Choose a file and import your Teams recording.