Setup

The plugin needs to be set up on both the Moodle side and the Discourse side. The two need to share a unique sso secret, so create a random string that is 10 characters or longer. This string will be entered into both sites.

Discourse Setup

1. Navigate to the Discourse admin dashboard and go to Settings->Login.
2. Under the 'sso url' setting enter in "{your-moodle-url}/local/discoursesso/sso.php" substituting the base url of your Moodle installation for {your-moodle-url}.
3. Under the 'sso secret' setting enter in the previously generated secret. Optional: The following settings are optional and may be checked: 1. sso overrides bio 2. sso overrides email 3. sso overrides username 4. sso overrides name 5. sso overrides avatar (Note: the DiscourseSSO plugin will not supply an avatar if the student does not have an avatar set in Moodle. This is to keep the default Discourse avatars if the avatar is not set - otherwise these students will have the generic Moodle avatar which does not look as good.)

Moodle Setup

1. Navigate to the DiscourseSSO settings page from the administration block.
2. Enter the previously generated secret into the "Shared SSO Secret Key" field. Make sure it matches the secret entered into Discourse!
3. Enter your Discourse site URL into the "Discourse URL field"