Etherpad-lite Mattermost OAuth2 Authentication

Use http://passportjs.org/ and https://github.com/jaredhanson/passport-oauth to provide OAuth2 based authentication to Etherpad lite from Mattermost.

Install

In your etherpad-lite dir:

npm install ep_oauth_mattermost

Configure your backend using settings.json or environment variables.

Either add to settings.json:

  "mattermost_oauth": {
    "enabled":true,
    "clientId":"CLIENTID",
    "clientSecret":"CLIENTSECRET",
    "serverUrl":"https://MATTERMOSTURL.com",
    "authEndpoint":"/oauth/authorization",
    "userInfoEndpoint":"/api/v4/users/me",
    "tokenEndpoint":"/oauth/access_token",
    "idField":"Field to use for id",
    "usernameField":"Field to use for username",
    "redirectUrl":"URL for your site"
  }

or define the following environment variables:

  OAUTH2_ENABLED = 
  OAUTH2_CLIENT_ID = 
  OAUTH2_CLIENT_SECRET = 
  OAUTH2_SERVER_URL = 
  OAUTH2_AUTH_ENDPOINT = 
  OAUTH2_USERINFO_ENDPOINT = 
  OAUTH2_TOKEN_ENDPOINT = 
  OAUTH2_ID_FIELD = 
  OAUTH2_USERNAME_FIELD = 
  OAUTH2_REDIRECT_URL = 

Inspirations

• https://github.com/HumanBrainProject/ep_oauth2 plugin

License

MIT