Discourse is a popular forum for 'civilised discussion'. Discourse has it's own user registration but you may want your members to use their Sheep App login credentials.
Single sign-on (SSO) is a session and user authentication service that permits a user to use one set of login credentials -- for example, a username and password -- to access multiple applications, in this case, Sheep and Discourse.
NOTE - authentication is still required when moving between applications
Discourse Settings
These setup instructions will help guide you through the configuration needed for your Discourse instance.
⚠️ Before making any changes, ensure that you have backed up your data and have root access to your Discourse instance. If the SSO doesn't work for any reason, you may find yourself locked out.
💡 For convenience (and to avoid having to resort to the command line) keep an admin session open to your Discourse instance while testing.
The SSO URL you will need is:
https://api.sheepcrm.com/api/v1/{client}/partner/discourse/sso
replace {client} with your client identifier.
(note the lack of a trailing slash - discourse won't allow a trailing slash)
Take note of the secret that you use (you'll need to set the same value in SheepCRM)
SheepCRM Settings
From Settings, find the Discourse API card.
Set the Discourse URL to the URL of your instance (include https://)
Set the secret to the same value you set in the Discourse settings
Discourse admin account - your Discourse admin email
Discourse admin account API key - your Discourse admin API key email
Discourse deactivation grace period (days) -
Discourse contact access mode
Controls which contacts can access Discourse.
Active members only is the default and recommended.
Members only (including lapsed members) allows all members to access Discourse, including lapsed members.
Contacts only allows anyone with a contact record to access Discourse.
Open to all (no contact record needed) allows anyone with a sheepApp account to access Discourse, even those not in your flock.
