Installation:
The plugin is installed in the normal fashion for Moodle plugins either by cloning the plugin into the local directory from the github repository or downloading a zip and following the installation instructions:
Unpack the plugin into /local/o365 within your Moodle install.
From the Moodle Administration block, expand Site Administration and click "Notifications".
Follow the on-screen instructions to install the plugin.
Once installed the administrator will want to follow all of the instructions to configure the plugin properly.
Walkthrough:
The plugin’s usability is specifically for an administrator. It allows for three different checks to be performed that determine if the Office 365 integration is functioning properly. These tests are:
Check the health of the integration
Upload a CSV file of how Moodle users match to Office 365 users
Validate the Azure AD permissions are properly configured
The plugin is accessed via the System Administration block > Plugins > Local > Microsoft Office 365 Integration. To check the health of the integration the administrator clicks on the Perform health check link. This will open a new page, which will advise the admin of any issues. The most common issue is that the administrative user password has changed and the password in Moodle needs to be updated.
To match users from Moodle to Office 365 the first step is to click on the user match link. From there you follow the onscreen instructions to upload a CSV file that lists Moodle usernames and their Office 365 email/username.
To validate that you have configured your Azure AD application properly for your settings an administrator clicks update button under the Azure Setup area. If there are any missing permissions those are printed out for the administrator. If everything is set properly then a statement that the permissions are set properly is printed out.
Documentation:
The documentation for the plugin provided adequate information to configure the integration with Office 365 and what each of the settings and buttons are for. The documentation is outdated with some of the permissions that are required to be set in Azure AD for the integration to properly work.
Uses:Check the health of the integration
Upload a CSV file of how Moodle users match to Office 365 users
Validate the Azure AD permissions are properly configured
- Automatically sync users from Office 365 to Moodle