Using Zoom's GitLab notifications integration

Zoom’s GitLab integration allows you to receive Zoom Chat notifications and messages from a chatbot relating to changes in your GitLab repos. For information about the GitHub notification integration, see Using Zoom's GitHub notifications integration.

This article covers:

• How to install and configure GitLab Notifications
  • Install GitLab from the Zoom App Marketplace
  • Configure the GitLab Subscription through Gitlab.com
  • Configure the GitLab subscription through a private server
• How to use the GitLab chatbot
  • Add a subscription
  • Interact with the GitLab chatbot
• How to remove the GitLab chatbot
• Data security

Prerequisites for Zoom's GitLab chatbot integration

• A Zoom account
• A GitLab account
• Pre-approval of the GitLab app in the Zoom App Marketplace
  Note: If the app is not pre-approved, please contact your Zoom admin.
• (If using private GitLab server) Allow unsolicited ingress traffic from zoom.us to your private GitLab server

How to install and configure GitLab Notifications

Install GitLab from the Zoom App Marketplace

1. Sign in to the Zoom App Marketplace with your Zoom account.
2. In the top-right corner, search for GitLab and click the app.
3. Click Add.
4. Confirm the required app permissions and choose Allow.

Note: If your admin has installed the GitLab chatbot, the chatbot will automatically be installed for you within the client.

Configure the GitLab Subscription through Gitlab.com

After installing the app from the Zoom App Marketplace, you will be redirected to the GitLab Subscription page.

1. Click Add a Subscription.
2. Authenticate with your GitLab account through GitLab.com or through your private server.
   • If authenticating through Gitlab.com, choose Authorize with GitLab.com and then choose Authenticate with your GitLab account.
     You will be redirected to GitLab to authenticate your GitLab account and Authorize Zoom. Once complete, you will return to the subscription configuration page.
   • If authenticating through your private server, see the following steps to configure your GitLab subscription through a private server.

Configure the GitLab subscription through a private server

1. Ensure you have allowed unsolicited ingress traffic from zoom.us to your private GitLab server.
2. Obtain an Application ID and Secret from your GitLab account.
3. In your GitLab account, go to Settings, then click the Applications tab. You will need to add a new application to allow Zoom to access your repos.
4. Enter Zoom for the name and use the following URI for the Redirect URI: https://applications.zoom.us/addon/gitlab/authorization
5. Copy the Application ID and Secret for use in a later step.
6. Return to the GitLab configuration on the Zoom App Marketplace and click Add a Subscription.
7. Click Authorize with private server.
8. Enter your Server Domain and the Application ID and Secret from the previous steps.
9. Click Save.
10. Click Authorize with private server GitLab account.
    You will be redirected to your private server GitLab account.
11. Choose Authorize.
    Your GitLab account will be configured for Zoom.

How to use the GitLab chatbot

Add a subscription

Once your GitLab account has been authenticated, you will be able to add a subscription.

1. Click Add a Subscription.
2. Enter the Basic Configurations:
   • Subscription name
   • Channel you would like to add the chatbot to
   • Description of the subscription
3. Complete the GitLab Configurations page:
   • Choose the desired Project from your GitLab repository.
   • Select the events you would like to receive notifications for by selecting the check boxes.
4. Click Save Configuration.
   Once complete, you will start receiving Zoom Chat notifications based on your configuration for each subscription. Repeat these steps to add additional subscriptions for projects and channels.

Interact with the GitLab chatbot

Once you have added a subscription, you will begin to receive chat notifications in the configured Zoom chat channel. You can also interact with the chatbot in a 1:1 chat. Enter help to receive a list of possible commands.

How to remove the GitLab chatbot

1. Sign in to the Zoom App Marketplace with your Zoom account.
2. In the top right of the page, click Manage.
3. In the navigation menu, click Added Apps.
4. Next to the GitLub app, click Remove.
5. Confirm the dialogue and click Remove.

Data security

• This app has access to the following information on Zoom:
  • View all groups subscribed to by a Zoom user under the Zoom account.
  • View existing meeting details for a Zoom user under the Zoom account.
  • View information of a Zoom user under the Zoom account.
• This app has access to the following information on GitLab:
  • Your tickets, agents, and customers.
    • Agents and customers are read-only for us.
    • The only write permission we use is closing tickets.
• This chat app has the following permissions on Zoom:
  • This chat app can send a chat message to an IM channel or Zoom user under the Zoom account.
  • This chat app can create a Zoom meeting on behalf of any Zoom user under the Zoom account.
• Communications between this chat app and Zoom/GitLab are encrypted:
  • Protocol: TLS 1.2
  • Cipher suite: ECDHE-ECDSA-AES128-GCM-SHA256
  • Key length: 128 bits
  • Perfect Forward secrecy: YES
• This chat app stores access credentials in the local data store:
  • GitLab API tokens and Zoom OAuth credentials (both admin-level only) are stored in an encrypted database.

For additional help, please submit a request to Zoom support.