Using Zoom’s GitLab notifications integration

Zoom’s GitLab integration allows you to get notifications directly from Zoom Chat regarding changes in your GitLab repositories, enabling you to receive messages from a chatbot that will assist you as you work. In order to learn more about Zoom’s integration with GitHub notifications, please visit Zoom’s GitHub notifications integration for more information.

Prerequisites for Zoom’s GitLab chatbot integration

• An account with Zoom is required

• An account on GitLab is required

• It has been pre-approved for inclusion in the Zoom App Marketplace as the GitLab app
  Note: Your Zoom administrator will be able to assist you if the app has not been pre-approved.

• Allow unsolicited traffic from zoom.us to be sent to your private GitLab server in case you are using a private GitLab server

How to install and configure GitLab Notifications

Install GitLab from the Zoom App Marketplace

1. Log in with your Zoom account to access the Zoom App Marketplace.

2. Go to the top-right corner of your screen and type GitLab into the search box. Click on GitLab to open it.

3. Please click on the Add button.

4. Once you have confirmed the permissions that are required, click on the Allow button.

Note: A GitLab chatbot will automatically be installed in your client if your admin has installed it within the GitLab admin interface.

Configure the GitLab Subscription through Gitlab.com

The subscription page for GitLab will be displayed to you after you have installed the app from the Zoom App Marketplace.

1. Then click on the Subscriptions tab.

2. Through GitLab.com or your private server, you will be able to authenticate with your GitLab account.

   • When logging in with GitLab.com, choose Authorize with GitLab.com, then select Authenticate with your GitLab account if you are using GitLab.com as your authentication method.
     It will redirect you to GitLab for the purpose of authenticating your GitLab account and authorizing Zoom. After completing the steps, you will be brought back to the page where you can configure your subscription.

   • In order to configure your GitLab subscription via a private server if you are authenticating through your private server, please follow the steps below.

Configure the GitLab subscription through a private server

1. In order to prevent unwelcome traffic from zoom.us entering your private GitLab server, please ensure that you have allowed it to do so.

2. From your GitLab account, you will need to find the Application ID as well as the Secret.

3. The GitLab account settings can be found by clicking on the Settings tab, then selecting Applications from the list. In order to allow Zoom to access your repositories, you will need to create a new application.

4. In the name field, enter Zoom and in the Redirect URI field, put the following URL: https://applications.zoom.us/addon/gitlab/authorization

5. You will need to copy the Application ID as well as the Secret in order to continue.

6. On the Zoom App Marketplace, go to GitLab configuration and go to Add a Subscription on the GitLab configuration page.

7. In the Private Server Authorize section, click Authorize.

8. From the previous steps, you will have to enter your Server Domain along with the Application ID and Secret in order to proceed.

9. Save the file by clicking the Save button.

10. Using the GitLab account that is associated with your private server, click Authorize.
    Upon clicking on this link, you will be redirected to your GitLab account on your private server.

11. Select the Authorize option.
    Zoom will be configured as part of your GitLab account.

How to use the GitLab chatbot

Add a subscription

Adding a subscription will become possible once you have authenticated your GitLab account and your account has been approved.

1. Please click the Add a Subscription button.

2. Here are the basic configurations that need to be entered:

   • Name of the subscription

   • Please select the channel to which the chatbot should be added

   • A brief description of the subscription can be found below

3. You will need to complete the following steps to configure GitLab:

   • From the repository of your GitLab account, select the project you would like to work on.

   • Choose the check boxes under the events that you want to receive notification for and you will be notified by email.

4. Then click Save Configuration to save the changes.
   Once you have completed these steps, Zoom Chat notifications will begin to appear based on the subscriptions that you have configured. If you want to subscribe to additional projects or channels, you will need to repeat these steps.

Interact with the GitLab chatbot

It will only take a few seconds once you’ve subscribed to the Zoom chat channel that you want to receive chat notifications within to begin receiving them. In addition to interacting with the chatbot in a 1:1 chat, you can also ask it questions. In order to find out all the possible commands you can use, enter help.

How to remove the GitLab chatbot

1. Log in with your Zoom account to access the Zoom App Marketplace.

2. Click on Manage at the top of the page on the right hand side of the page.

3. Select the Add Apps option from the navigation menu at the top of the page.

4. To remove the GitLub application, click the Remove button next to it.

5. Click on the Remove button after you have confirmed the dialog box.

Data security

• Using this app, you will be able to access the following Zoom information:

  • Using the Zoom account, you can view all the groups that a Zoom user has subscribed to.

  • The Zoom account allows you to view the details of existing meetings for a Zoom user.

  • Under the Zoom account, you can view information about a Zoom user.

• The following information can be accessed by this app on GitLab:

  • The tickets you sell, the agents you work with, and the customers you serve.

    • We have read-only access to the accounts of our agents and customers.

    • It is only for closing tickets that we use write permission.

• Zoom allows the following permissions for this chat app to operate:

  • A chat message can be sent through this chat app to a Zoom user, or to an IM channel in an IM conversation.

  • There is an option to set up a Zoom meeting using this chat app that can be used by any Zoom user under a Zoom account.

• This app transmits encrypted communications between Zoom/GitLab and this chat application:

  • Protocol: TLS 1.2

  • Cipher suite: ECDHE-ECDSA-AES128-GCM-SHA256

  • Key length: 128 bits

  • Perfect Forward secrecy: YES

• There are a number of credentials that are stored in this chat app’s local data store:

  • There is an encrypted database on which GitLab API tokens and Zoom OAuth credentials (both of which are only accessible by admins) are stored.

The Zoom support team is available to provide additional assistance if needed.