Skip to content

Rocketchat Integration

Hadi Nategh edited this page Jul 16, 2019 · 10 revisions

WikiRocketchat Integration

Rocketchat Integration

Installation

Rocket.Chat needs to be configured and installed. The following steps show the configuration process in detail.

After installation is finished, you may want to look into some administration details e.g. to configure non-EGroupware accounts or to switch video-chat (Jitsi) off for GDPR reasons.

Installation steps
(1) Admin Info- Configuring Admin username
(2) Organization Info- Configuring Organizational data
(3) Server Info- Setting site name, language and server type
(4) Register Server- Selecting type of Server

Following steps are necessary only for on-premise installations

Only for on-premise installations
(5) Create OpenID Client- Create OpenID-Identifier and secret via Admin->OpenID
(6) Custom OAuth- Configuring Custom OAuth on Rocketchat server

Admin Info

You need to provide a valid EGroupware username (recommended your user) to configure the first administrator of Rocket.Chat. That administrator can add additional EGroupware users as Rocket.Chat admins. Additionally you should insert a valid email address, which is used for the registration process of Rocket.Chat.

Organization Info

Organization information is just some data which gets reported to Rocket.Chat via registration but its not used in EGroupware Rocket.Chat itself.

Server Info

Here you can configure the site name is displayed in external Rocket.Chat clients. It's quite useful when using more than one Rocket.Chat.

It makes sense to choose a meaningful name to identify the chat server!

Please choose a language which is common for the majority of your users. The language can be changed later on MyAccount for each user.

Register Server

You need to decide, if you like to register your Rocket.Chat to get push notifications for smartphones. In that case all inserted information of the configuration gets sent to Rocket.Chat!

EGroupware does not provide a push-service for notifications on smartphones, but you can use Rocket.Chat cloud services. Please take GDPR into account for your decision.

If you don't need push notifications, you can skip registration and click on keep standalone.

Rocket.Chat is successfully installed, you can now configure additional parameters e.g. switch video-chat off or add non-Egroupware user.

Create OpenID Client

You need to create a Client-Identifier and secret via Admin -> OpenID / OAuth2 server -> Clients.

Please insert a name for your Client-Identifier e.g. EGroupware Rocket.Chat and an Identifier - recommended Rocket.Chat

This Client-Identifier needs to be inserted in the next step where you add the custum OAuth server in EGroupware.

The secret should be a random string (recommended minimum 12 chars), which is used and inserted in the custom Oauth server configuration together with the Client-Identifier in the next step!

The Redirect URI needs to match your servername e.g. testbox.egroupware.org in my case. Using https is recommended, but only if secure connection is correctly configured! For Allowed grants you need to choose: Authorization Code, Refresh Token and Implicit.

Add Custom OAuth

Please go back to Rocket.Chat into Administration -> OAuth and click on Add Custom OAuth. Give it a name eg. EGroupware.

At the top of the page the custom OAuth server EGroupware is added and you need to insert several values. Please check all red marked rows where you need to insert your data. These listed values in the screenshot are just a few important values, but all need to be inserted correctly!

URL: http(s)://servername/egroupware/openid/endpoint.php Servername needs to be matched with your servername or IP-address.

Id needs to be the Client-Identifier you previously configured for the OpenID Client! Similar is valid for the secret.

If you can't remember the secret you chose previously, you may re-generate and save the secret in the EGroupware OpenID client.

See also previous tab Create OpenID client

Please check also our technical documentation page on Github: https://github.com/EGroupware/openid

Video Chat

You need to decide whether to allow video-chats and screen-sharing or not for GDPR reasons.

EGroupware does not provide a Jitsi-server for video-chats, therefore the Jitsi-server configured by default is a public server from the open source project Jitsi Meet. Please take GDPR into account for your decision, we have not found neither any declaration of data protection on their website nor where the servers are located.

Add non-EGroupware User

If you would like to allow non-EGroupware users to take part in your Rocket.Chat you can enable in Account Settings to show the Default Login Form.

By default we only show: EGroupware users click here and not username and password fields for external users! EGroupware users should always use the provided click here link!

Next step is to create the non-users manually in administration users. You need to specify username and password. depending on the settings to allow password change or not, please allow or deny that the user can change the password which is switched off by default.

the password change in rocket.chat will not change the user password of egroupware!

Finally, an email will be sent containing the login details for Rocket.Chat to the configured email address during the setup.

File Upload

Here we can enable file uploads and configuring max file size, valid media types and more. Storage type should be set to FileSystem.

back to Top


End of Document

Clone this wiki locally
You can’t perform that action at this time.