Skip to content

SeAT

SeAT-Discourse Installation

In order to install SeAT-Discourse you must prepare some things and finally install the plugin:

Preparation

Create API key

Navigate to discourse.example.com and log on using the new Admin User. Top right press the 3 lines and select Admin. Go to API tab and press Generate Master API Key.

Add the following values to your SeAT .env file:

  • DISCOURSE_URL: https://discourse.example.com (do not add a trailing slash!)
  • DISCOURSE_API_USERNAME: the username of the admin account you generated the API key with
  • DISCOURSE_API_KEY: the key you just generated

Configure SSO

Navigate to discourse.example.com and log in. Back to the admin site, scroll down to find SSO settings and set the following:

  • enable_sso: True
  • sso_url: http://seat.example.com/discourse/sso
  • sso_secret: some secure key

Save, now set DISCOURSE_SECRET in your SeAT .env file to the secure key you just put in Discourse.

Package installation

Install Discourse SSO for Laravel:

Add herpaderpaldent/seat-discourse to SeAT Plugins list to install inside your .env

# SeAT Plugins
    # This is a list of the all of the third party plugins that you
    # would like to install as part of SeAT. Package names should be
    # comma seperated if multiple packages should be installed.
    SEAT_PLUGINS=herpaderpaldent/seat-discourse

Inside your SeAT Folder run the following:

composer require herpaderpaldent/seat-discourse

add the following to your SeAT .env file:

  • DISCOURSE_URL (do not add a trailing slash!)
  • DISCOURSE_API_USERNAME the username of the admin account you generated the API key with
  • DISCOURSE_API_KEY the key you just generated
DISCOURSE_URL=https://discourse.example.com
DISCOURSE_API_USERNAME=username
DISCOURSE_API_KEY=key
DISCOURSE_SECRET=secret

Hint

If you use Docker you need to run docker-compose up -d in your opt/seat-docker folder.

Success

Now you got SeAT-Discourse installed.

For SeAT 3.0, you are done with the Install

The package uses the auto registration feature

Left to do

  • document Discourse configuration
  • send log out to Discourse when disabling/deleting the user
  • failed login redirect