Rocket Chat

Since version 6.4.145 GroupOffice can integrate with Rocket.Chat. With rocket chat you can chat with your team in different channels, share files and even start a video conference from your desktop, phone or tablet!

../_images/rocket-chat.png

Rocket Chat

Installation

To install you need a working Rocket.Chat installation. See the Rocket.Chat documentation for that.

Login to Rocket.Chat as administrator and:

  1. Important: Disable OTP authentication at Administration -> Settings -> Accounts or it won’t work.

  2. go to Administration -> Settings -> OAuth.

  3. On the top right choose “Add custom oauth”.

  4. Note the callback URL / or redirect URI on top. For some reason they made it grey so it doesn’t stand out. You need that later when adding the client in GroupOffice.

  5. Fill in your URL to GroupOffice plus /api/oauth.php. For example: https://groupoffice.example.com/api/oauth.php

  6. Copy the settings from the image below. Instead of the example password choose a strong password.:

    ../_images/custom-oauth.png

    Rocket Chat custom oauth settings

    ../_images/custom-oauth-2.png

    Rocket Chat custom oauth settings part 2

  7. Login to GroupOffice and go to System Settings -> Oauth 2.0

  8. Click “Add client” and fill in the fields:

    • Match the “Identifier” and “Secret” from step 5.

    • Enable “Is confidential”

    • The redirect URI is the callback URL on top of the Rocket.Chat custom oauth page. It’s marked in the red square in the screenshot below:

      ../_images/callback-url.png

      The input should look like this:

      ../_images/rocket-chat-oauth-client.png

  9. Click save and test if you can login with GroupOffice. You should see a “Login with GroupOffice” button.

    ../_images/login-with-group-office.png

Note

If you get an error double check these settings:

  • Administration -> General -> Site URL. It has to match for the openid handshake to work.

  • Administration -> Oauth -> Groupoffice: check if id and secret match the parameters in the GroupOffice client. Also verify the other fields.