Overview
Moodle Single Sign-on (SSO) allows users to log into Moodle using their Onefile credentials. If a user does not already have an account in Moodle, one will be created automatically during the login process. This integration simplifies access and ensures user accounts stay aligned between systems.
To enable the Moodle integration, please contact your Onefile Account Manager.
The Client ID and Secret required for configuration are generated when creating a Single Sign-on app for Moodle in Onefile.
User Roles
This feature can be used by:
- Centre Managers – Can add a Single Sign-on app.
- Moodle Administrators – Can install and configure the Moodle plugin.
Downloading the Moodle Plugin
To download the Moodle plugin as a Centre Manager:
- Click the Centre icon.
- Click the Integrations icon.
- Click Go to Integrations.
- Click Configure next to Single Sign On (SSO).
- Click Add Single Sign-on App.
- Select Moodle from the external application list.
- Add all requested Moodle information.
- Click Save.
- Copy the Client ID and Secret.
- Click Continue.
- Toggle on Single Sign On (SSO).
- Click Edit next to the Moodle-enabled SSO App.
- Click Download Moodle Plugin.
Installing the Moodle Plugin
This section must be completed by a Moodle Administrator or your internal IT team with backend access.
There are two ways to install the Onefile Authentication Plugin:
- FTP method: Open the auth folder inside Moodle and paste in the unzipped plugin files.
- Moodle interface: Log into Moodle as an Administrator and upload the ZIP via the plugin upload interface.
After installation, enter the Client ID and Secret provided by Onefile (from the SSO Integrations page).
Once the plugin is installed and configured, enable it by clicking the Eye icon. Enabling the plugin will display the “Log in with Onefile” button on your Moodle login page.
Tips & Notes
- You must create the Moodle SSO app in Onefile before configuring the plugin in Moodle.
- Ensure the Client ID and Secret are stored securely and only shared with authorised administrators.
- If the login button does not appear on Moodle, check that the plugin is enabled.
Terminology
The terminology used in this article may differ depending on your Centre’s configuration or Moodle setup.
Related Articles
Need Help?
If you encounter any issues or need further assistance, please contact Onefile Support or your internal IT/Moodle support team.
