moodle plugin install guide version 1

1 Moodle-Office 365 Plugin User Installation Guide Version 1.0 June 21 st 2013 Advaiya INC. 2 1.0 INTRODUCTION 3 1.1 Document purpose 3 1.2 Scope 3 1.3 Prerequisites 3 2.0 SYSTEM REQUIREMENTS 4 2.1 Overview 4 2.2 Software requirements 4 2.3 Hardware requirements 4 2.4 Operating systems 4 2.5 Database support 4 2.6 Assumptions and constraints 4 3.0 PLUGIN INSTALLATION AND CONFIGURATION 5 3.1 Moodle installation and Office 365 integration 5 3.2 App for SharePoint installation procedure for administrators 27 3.3 App for SharePoint installation procedure for students 31 4.0 USING THE FEATURES OF THE MOODLE-OFFICE 365 PLUGIN 36 4.1 Creating users in Active Directory from Moodle 36 4.2 Adding existing users to Windows Azure Active Directory 37 4.3 Active Directory bulk user creation 38 4.4 Bulk licensing PowerShell export 39 4.5 Accessing Office 365 plugin features 40 4.6 Dynamic course creation 40 5.0 APPENDIX 43 3 5.1 Tenant administrator 43 5.2 Base SharePoint URL 45 5.3 App ID and App Secret 45 1.0 Introduction Moodle is an open source Course Management System (CMS) also known as a Learning Management System (LMS) or a Virtual Learning Environment (VLE). It has become very popular among educators around the world as a tool for creating online dynamic websites for their students. Microsoft has developed a plugin to integrate Moodle with Microsoft Office 365 and SkyDrive. This will allow teachers to create courses and assignments in Moodle that can be read, edited, and submitted by students in SharePoint. The plugin also enables various features such as: 1. User management features such as adding a new user, deleting a user, and user group creation in Office 365 through Moodle. 2. Single sign-on to Office 365 and Moodle 3. Task list and Calendar integration 4. Enabling students to edit and submit the assignments in the browser itself. 1.1 Document purpose The purpose of this document is to provide step-by-step instructions to configure and install the Microsoft-provided plugin for integration with Moodle. It will also describe the new features that are enabled by this plugin. 1.2 Scope The scope of this document is limited to instructions for installing the new plugin modules delivered by Microsoft. Installation of Moodle, Office 365, and other required system components is outside the scope of this document. It is also assumed that the administrator using this document is familiar with Moodle and Office 365 installation processes and features. 1.3 Prerequisites The administrator should know how to manage the Windows, Apache, MySQL, and PHP software stack (also known as “WAMP”); have basic MySQL command knowledge used in operating MySQL; and basic knowledge of CMS installation. This document does not elaborate on the details of any system utility except as necessary to complete the tasks within. 4 2.0 System requirements 2.1 Overview This section explains hardware, software, operating system, resource requirements, and the licenses required to successfully complete the installation. Please ensure that the system is pre-configured to meet these minimum requirements before starting the installation. 2.2 Software requirements  A working installation of Moodle v2.3 or higher which can be downloaded from http://download.moodle.org/  Office 365 E3 or Educational account with available user licenses.  Windows Azure Active Directory account linked to Office 365 account root tenant account (achieved by accessing the Windows Azure portal while logged in as an Office 365 administrator and creating a new Windows Azure account).  Windows Azure Active Directory Module for Windows PowerShell, which will be used for Office 365 auto-licensing and Access Control service provisioning. 2.3 Hardware requirements  Disk space: a minimum of 160 MB is required to install this app.  Memory: a minimum of 256 MB is required, 1 GB of memory or more is strongly recommended. 2.4 Operating systems Windows or Linux. 2.5 Database support MySQL is the primary development database. 2.6 Assumptions and constraints 1. The mail server should configure properly. 2. The administrator should have the knowledge of basic Moodle features. 3. The student should have SkyDrive Pro installed for certain features of Moodle. 4. Wherever a server’s cross-domain policy restricts iframe loading of apps for Office 365, the app will be forced to load in a new browser tab. 5. For any app to work, a user must have an active Office 365 authentication token within an active browser session. 5 3.0 Plugin installation and configuration 3.1 Moodle installation and Office 365 integration 1. In Moodle, on the File tab, click the root directory, open the Login folder, and rename index_form.html to index_form_backup.html. 6 7 8 2. Copy the plugin directory structure to the Moodle root directory for the installation. 3. Log on to Moodle as an administrator. The plugin will initiate the installation procedure automatically. 4. After the plugin has installed, log on to Moodle, on the left menu click Site administration, click Plugins, click Authentication, click Manage authentication, click Office 365 and Azure Active 9 Directory SSO and Integration. This is disabled initially. Click the icon beside it to enable it and click Settings. 10 This will bring up the plugin settings page. 5. To get the settings values, log on to Office 365 in a new browser tab as a Tenant Administrator. See Appendix 5.1 for steps on how to get a Tenant Administrator account. 6. Using a base SharePoint site collection URL, go to https://yourbaseurl.SharePoint.com/_layouts/15/appregnew.aspx See Appendix 5.2 for steps on how to get a base SharePoint URL. 7. Generate an App ID and App Secret. Then enter the desired title. See Appendix 5.3 for steps on how to generate an App ID and App Secret. 8. The App Domain should be the root host of your Moodle installation. [...]... after the authentication After the redirect URI has been entered, click Create 11 10 Once the redirect URI has been entered, click “create” 11 12 12 Save your App ID and App Secret for use later 13 Next go to: https://yourbaseurl.SharePoint.com/_layouts /15 /appinv.aspx 14 Paste the App ID that was just created and click Lookup 13 15 Copy and paste the following text into the Permission Request XML box: ... Moodle, and submitted for grading 35 4.0 Using the features of the Moodle- Office 365 plugin 4 .1 Creating users in Active Directory from Moodle The Moodle- Office 365 plugin allows creation of new Moodle users, through Active Directory The user can then log on to Moodle, using only their Active Directory credentials 1 To add a new user, log on to Moodle as an administrator 2 On the left menu panel, click Site... the Moodle App folder of the installation package, browse to Moodle. app and select the file 8 The app will be uploaded and installed to your tenant’s app catalog 30 3.3 App for SharePoint installation procedure for students 1 The Moodle app for SharePoint allows students to view their current Moodle courses and grades in a single location, it also allows students to submit assignments back to Moodle. .. their SkyDrive Pro folders 2 To install the Moodle app, the student only needs to log on to Office 365 and click Newsfeed from the main menu 31 3 On the left menu, click Apps 32 4 This will show a view of the currently installed apps and allows students to install a new app by clicking add an app 5 Because the Moodle app is installed in the tenant’s app catalog, the MoodleIntegration app will automatically... 14 15 16 After receiving the confirmation, go back to Moodle and enter the App ID, App Secret, and your SharePoint Base URL into the settings 17 Go back to Office 365 While still logged on to Office 365 as an administrator, go to https://manage.windowsazure.com/ 18 If you do not have a Windows Azure account, you will receive the following message: 16 19 If the above prompt appears,... the MoodleIntegration app is clicked, the user must allow the app permissions within their site After permission is granted, the app will be installed automatically 7 After the installation is complete, the main part of the app can be accessed by clicking on Apps in the left menu 34 8 From inside the MoodleIntegration app, the student is able to view their courses and assignment information from Moodle, ... ID URI 27 On the next page, click Configure key 18 28 Under keys, click Select duration and choose the duration for which you would like the key to be valid The duration will determine how long the key will work For security purposes, select 1 year 29 Then click SAVE The key is now generated 19 30 Copy the key and client ID, and then go back to Moodle 31 Enter the key for the value Azure AD Client Key,... back to Moodle, they can go to SkyDrive Pro and click the options menu for the file Assignments can be requested by the teacher in a certain format or with content already added to the document, these assignments will be automatically generated in the enrolled student’s SkyDrive Pro folder under the Courses folder 10 When the student clicks Submit to Moodle, the document will be transferred to Moodle, ... the user 4 When the user is created in Moodle, the plugin will automatically add the user to Active Directory and email a confirmation to the user by using the email address provided in the registration process Note: email confirmations require email messaging to be set up in Moodle and working properly Email settings can be found under Site Administration > Plugins > Message Outputs > Email 36 ... Directory services 21 After entering the Windows Azure portal, on the left menu, click ACTIVE DIRECTORY 22 Click your directory name: 23 Then at the top of the screen click Integrated Apps 24 At the bottom of the screen, click ADD 25 At the next prompt, enter a name for the new app, then choose SINGLE SIGN-ON, READ AND WRITE DIRECTORY DATA 17 26 At the next prompt, enter the domain where Moodle is hosted . 1 Moodle- Office 365 Plugin User Installation Guide Version 1. 0 June 21 st 2 013 Advaiya INC. 2 1. 0 INTRODUCTION 3 1. 1 Document purpose 3 1. 2 Scope. 3.0 PLUGIN INSTALLATION AND CONFIGURATION 5 3 .1 Moodle installation and Office 365 integration 5 3.2 App for SharePoint installation procedure for administrators 27 3.3 App for SharePoint installation. within an active browser session. 5 3.0 Plugin installation and configuration 3 .1 Moodle installation and Office 365 integration 1. In Moodle, on the File tab, click the root directory,