Redmine OAuth Rocket.Chat

This plugin is used to authenticate Redmine users using Rocket.Chat's OAuth provider.

Installation:

Download the plugin and install required gems:

cd /path/to/redmine/plugins
git clone https://github.com/y-k-m/redmine_oauth_rocketchat.git
cd /path/to/redmine
bundle install

Restart the app

touch /path/to/redmine/tmp/restart.txt

Registration

To authenticate via Rocket.Chat you must first register your redmine instance via the Rocket.Chat OAuth application configs.

Authentication Workflow

1. An unauthenticated user requests the URL to your Redmine instance.
2. User clicks the "Login via Rocket.Chat" buton.
3. The plugin redirects them to a Rocket.Chat sign in page if they are not already signed in to their Rocket.Chat account.
4. Rocket.Chat redirects user back to Redmine, where the Rocket.Chat OAuth plugin's controller takes over.

One of the following cases will occur:

1. If self-registration is disabled (Under Administration > Settings > Authentication) but force_account_creation option is checked, the account is created and user is redirected to 'my/page'.
2. Otherwise, self-registration method is used to register users.