Contents
1 About the Microsoft OneDrive repository
2 Enabling the OneDrive repository
About the Microsoft OneDrive repository
The Microsoft OneDrive repository allows you to access your documents from Microsoft OneDrive within LMS. As well as adding basic files, the OneDrive repository link allows you to access your OneDrive live directly from the configuration icon.
The first time you access the OneDrive repository, you will be prompted to agree to connect. Once you have agreed, you can then log in, view and use your files.
Enabling the OneDrive repository
To use the OneDrive repository, an administrator must first create a Microsoft OAuth 2 service.
- Go to ‘OAuth 2 services’ in Site administration and click the button to create a new Microsoft service.
- Follow the instructions in OAuth 2 Microsoft service and obtain a client ID and secret.
- Enter the client ID and secret and save changes.
- Go to ‘Manage repositories’ in Site administration and enable the OneDrive repository.
- On the OneDrive configuration page, make sure that Microsoft is selected as the OAuth 2 service, then save changes.
Note: OneDrive requires that requests are delivered over SSL – this means that the OneDrive repository will not work if your site is not running over HTTPS.
Access controlled links
Users may submit files from OneDrive as ‘access controlled links’ in assignments. Once submitted, the user may no longer change them, but the instructor is allowed to edit them.
The instructorr may display files from OneDrive as ‘access controlled links’. The instructor can then continue updating the files, but users can only view them.
To enable this feature, ensure that:
- A system account has been connected in OAuth 2 services in Site administration. This account will own and control access to files submitted by users and instructors. Instructors will be able to edit the files but users will not. This should be a dedicated account for this purpose.
- “Supported files” is set to “Internal and External”.
- “Default return type” is set to “External (only links stored in LMS)”.
The OneDrive (legacy) repository
The OneDrive repository used in earlier versions of LMS has been renamed to ‘OneDrive (legacy)’. The API used by this repository plugin has been deprecated by Microsoft and will stop working eventually. Users are encouraged to migrate to the new OneDrive repository right away. Another reason for migrating to the new OneDrive repository is that it works with Business accounts as well as personal.
Note: You need to enable the new OneDrive repository (as above) before migrating from the OneDrive (legacy) repository.
Repository capabilities
There is just one capability associated with this repository: View OneDrive repository.
See also
- OAuth 2 authentication for enabling users to log in to LMS with their Microsoft account