Office 365 Moodle Integration Project - New and Improved

Since we released the O365 integration plug-ins back in January, there has been a lot of community pick-up and feedback. We have responded with a number of improvements. This article will focus on the most noticeable surrounding the O365 single-sign-on and account connection.

The original release of the O365 plug-ins required users who wanted to use the O365 OneDrive and Outlook Calendar Moodle integrations to change their Moodle account authentication scheme to the OpenID Connect using Office 365’s AAD system. Any new Moodle account had to be created and managed from the Office 365 AAD system as well. To login, a user had to use the separate “OpenID Connect” login button on the Moodle login page.

This system worked well for new Moodle installations, where the user management system had not been established, and was therefore easy to select the OpenID Connect/AAD authentication system for their user system. But for established Moodle sites, where other user management and authentication systems were well established, this proved to be a barrier to using the O365 integrations.

Further, some Moodle sites that did want to use the OpenID Connect/AAD system for Moodle authentication, didn’t want their users to look for a separate login button on the Moodle login page, but to continue to use the standard Moodle login form.

I’ll deal with the second problem first.

As originally released, to login via O365, you had to use a separate button on the login page, like below:

However, Moodle is built such that authentication plug-ins can use the standard login form, if they choose to do so. For this case, we built in the ability for Moodle to pass the entered username and password to the OpenID Connect provider, and log the user in to both O365/AAD and Moodle at the same time, in the background. In order to facilitate this, we provided an extra configuration option:

As shown, the second radio button turns off the need to use the separate OpenID Connect login button, and allows the standard Moodle login form to function with OpenID Connect. If you select the first radio button, the login will work as it did before, and require the user to login using the external provider.

One other addition we added was the ability to select an icon for use on the login button, or upload a custom icon for the same use. This allows the OpenID Connect login button to have an icon more suited to the organization, if they choose not to show the Microsoft Office icon.

For the account connection problem, we approached it in a unique way. As the account connection mechanism existed, sites that wanted their users to take advantage of the O365 integrations required that the Moodle logins be managed from O365/AAD as well. The plug-ins provided an easy mechanism to connect existing Moodle accounts to existing O365 accounts, and then switch those users to the O365/AAD login, but that was a permanent change. And sites with many users, already have well-established user management and login systems that they use with Moodle.

To solve that problem, we provided a mechanism that allows users to either switch to using the O365 login (as before), or connect their current Moodle account to an O365 account and continue to login to Moodle as they did before. This mechanism is contained in the user profile plug-ins accessed from a user's Moodle profile page, as so:

In this shot, you can see two Office365 links: 

• Office365 Connection: You are not connected to Office 365. Connect to Office 365
• Office365: You are not using Office365 to log in. Start using Office365 to log in.

Either of these links takes you to the new O365 management page, which provides links to each function as so:

The first function on this page, "Start using Office365 to log into Moodle", works the same as the first release. If you click that link, you will be redirected to your Office365 login page to login to O365/AAD. If you login with a valid AAD account that has not already been connected to a Moodle account, your Moodle account will then be reconfigured to use AAD as the authentication scheme. Once that has been done, you will always need to login to Moodle using the AAD account information.

The second function in this page, "Connect to Office365", is the new function. If you click that link, you will be likewise redirected to your Office365 login page. If you login with a valid AAD account that has not already been connected to a Moodle account, your Moodle account will be configured to be connected to that O365 account. What that means, is that you will continue to login to Moodle in the same way you always have, but when you access any of the O365 Moodle integrations, your O365 account will automatically be used. You won't need to login twice once the connection has been made.

This second feature was one that was most asked for. This feature allows Moodle sites that cannot change their Moodle authentication schemes to still take advantage of the full O365 integrations.

One feature that has also remained is the automatic account creation. If a user that does not exist yet in Moodle, logs into a Moodle site that has the OpenID Connect O365/AAD authentication plug-in enabled, and the account information they use is a valid AAD account, they will be logged in and a new Moodle account created for them.

We have a number of other improvements and new features coming in future releases. Look to future blog posts describing these.

Office 365 Moodle Integration Project - Released!

This will be a short post, just to let everyone know that our first release of the Office 365 plug-ins are now available to the community.

Earlier today, Jean Paoli, president of MS Open Tech announced the official release of the code at the BETT show in London. This announcement coincided with the opening of the Githib repositories to the public and the submissions to the Moodle Plugins database.

I have posted an announcement in the Moodle "General plugins" forum, and more discussion can happen there. There will also be tracker items set up in the Moodle tracker to get feature and improvement requests, and deal with bugs.

You can get the plugins from the Moodle plugins database as follows:

• OneNote set of plugins.
• Office365 for Business set of plugins.
• Oembed filter. It may still be out of date, but will be updated shortly.

The current work for each has been gathered in one Github repository called "o365-moodle", but each plug-in has a current release repository of its own. The "readme" file in the "o365-moodle" repository has references for each release repository.

Start playing!

If you want any more information on how you can benefit from these developments, contact Remote-Learner at moodleo365@remote-learner.net.

Office 365 Moodle Integration Project - OneDrive

Our initial work with Microsoft Open Technologies has progressed, and we now have an integration with OneDrive for Business. In this post, I will describe and provide brief demos of how Moodle and OneDrive for Business can work together.

At its basic level, the OneDrive for Business integration is a repository plug-in. It is built to work closely with the OpenID Connect authentication plug-in that provides the Office 365 account connection. It provides two levels of repositories to every user. It provides access to each user's private files area, and it provides access to a course shared area for every course a user is enrolled in.

I'll start by looking at the personal space. Below is a screen capture of the Moodle file picker using the Office 365 OneDrive repository.

What I can see here are two folders in OneDrive. The "My Files" folder is my personal space in the OneDrive for Business application. The "Courses" folder contains subfolders for each of the Moodle courses I have access to. "My Files" displays all of the files and directories I have in my OneDrive for Business folder. The image below shows the contents in the Moodle file picker.

Looking at my OneDrive interface, I see a similar structure as below.

Note that the folder structure and contents mirrors what I saw in Moodle. If I add or change the contents of my OneDrive folder, it will likewise  be reflected in the Moodle file picker. This is what we expect from a Moodle repository plug-in. :)

If I add files to my OneDrive, I will see them when I look at "My Files" in the Moodle Office 365 OneDrive "My Files" area. Likewise, if I upload a file from Moodle into the "My Files" area, I will see it in my OneDrive folder. In the Moodle file picker image of "My Files" above, note the "Upload New File" control. Using that, I can select a file from my local machine, and upload it directly into my OneDrive folder via Moodle, where it will be available to both OneDrive and my Moodle files.

The "Courses" folder also uses my Office 365 account. It provides course-level shared access to files for all of the Moodle courses on the site that I have access to. A separate folder is created for each course, using the Moodle course names. To do this, Office 365 for Business uses Sharepoint, and specifically, Sharepoint sites. Below are two images showing the same course level directory on Moodle and on Sharepoint (OneDrive).

The integration uses Moodle capabilities to control access to the files in both Moodle and Sharepoint/OneDrive. By default, the teacher roles in a course are given read and write access to the course folder, while students are given read only. Moodle synchronizes these access permissions to Sharepoint to control it in the Office 365 realm as well.

Showing the path through Office 365 to the Moodle course files is difficult with screen snaps, so instead, below I have included a small video showing the path through to the course files.

We're very close to releasing all of this work to the community at large. And we're very excited to find out how its received. In future posts, I will discuss the technical solutions underneath the hood in more detail.

If you want any more information on how you can benefit from these developments, contact Remote-Learner at moodleo365@remote-learner.net.

Office 365 Moodle Integration Project - Progress

Along with the OneNote integration, discussed in my last post, the work with Microsoft Open Technologies has also produced two integrations with Office 365. The first is an integration with Outlook calendars and the second is a OneDrive for Business integration. In this post, I will describe and provide brief demos of the Outlook calendar integration.

The Outlook calendar synchronization allows Moodle calendar events to be synchronized back to your Outlook calendar. If you are someone who uses an Outlook calendar as a key tool, I think you will find this very useful.

This particular functionality has been built to use Office 365 for Business, meaning that it expects everyone on the site to have an Office 365 for Business account. Users without these accounts will not be able to synchronize to their Outlook calendars.

The function will allow Moodle users to connect their personal Moodle calendar, and any course calendars they have access to. To set up the calendars to connect, a local plug-in has been created. As well, a user profile field plug-in has been provided that can be added to each user's profile, providing access to the calendar sync configuration page.

Once I have logged into Moodle with my Office 365 AzureAD account, I will be able to access these functions. Looking at my profile, I will see two Office 365 functions: "AzureAD" and "Office365 Connection". The next image shows this screen:

Clicking through the "Manage" function for the "Office365 Connection", I get to the "Outlook Calendar Sync" page. This is where I can select the specific Moodle event types I want to synchronize back to Outlook:

Once I have selected my calendars, any changes to those Moodle event types will be reflected in my Outlook calendar as well. In this case, I will see any personal Moodle events and any Moodle events from the "Moodle Integration Project" course.

In the above image, there are two events in my course Moodle calendar. On the 14th, there is a personal event, and on the 16th a course event. We can see the details of the course event in the image. When I look over at my Outlook calendar, I see the same two events:

In my next post, I will discuss the OneDrive for Business integration. It takes advantage of Sharepoint to allow shared course directories as well.

If you want any more information on how you can benefit from these developments, contact Remote-Learner at moodleo365@remote-learner.net.