From Studentnet Wiki
Jump to navigation Jump to search

This guide assumes that you have installed the following SAML2 plugin for your Moodle website:

Before you start, you need your IdP metadata url.

Get your metadata URL - Log in to Cloudwork Dashboard -> Single Sign On -> Identity Provider -> Copy the entity ID url

  1. Enable the SAML2 plugin (click the grey crossed-out eye)
  2. Go to the SAML2 plugin's settings
  3. Paste the metadata URL into the "IDP metadata xml OR publix xml URL" field
  4. Click on Download SP Metadata
  5. If you are mapping users on username, change Mapping Idp value to User-Name
  6. To create accounts automatically on SSO login, change 'Auto create users' to Yes.
  7. Under Data mapping, update the following settings:
    • Data mapping (First name): givenName
    • Data mapping (Surname): sn
    • Data mapping (Email address): mail
  8. Click Save changes
  9. Log in to the CLoudwork Dashboard. Go to Single Sign on-> Add New Service -> Upload an XML File
  10. Give the new service a name, and select the saved XML file from step 4.
  11. Open a new browser or incognito window, and test login. You will see a Login via SAML2 button on the login page.

SSO is now configured and working. You may now wish to configure other settings in the Moodle plugin settings. Settings of interest:

  • IdP label override: Customise the SSO login button text.
  • Dual login: By default, allows username/password based logins as well. Change to no to force users to use SSO. Admin login page is still accessible at /login/index.php?saml=off
  • Other data mapping fields and settings. This guide limits itself to Cloudwork's default attributes. If you have updated the service's attribute map in Cloudwork to send extra data, you can configure it here.