How to use Zoom’s GitLab notification integration

With Zoom’s GitLab integration, you can receive Zoom Chat notifications and messages about changes to your GitLab repositories directly from a chatbot in Zoom Chat. For more information on GitHub notification integration, see Using Zoom’s GitHub notification integration.

Requirements for Zoom’s GitLab chatbot integration

• A Zoom account is required
• An account on GitLab is required
• GitLab has been pre-approved for inclusion in the Zoom App Marketplace
  Hint: you must contact your Zoom administrator if the app is not pre-approved.
• You must allow unsolicited inbound traffic from zoom.us to your private GitLab server when using a private GitLab server

How to install and configure GitLab notifications

Install GitLab from the Zoom App Marketplace

1. You must sign in with your Zoom account to access the Zoom App Marketplace.
2. You can search for GitLab in the top right corner of the screen and click on the app once you find it.
3. Add the item to your cart by clicking the Add button.
4. After confirming the required app permissions, you need to select Allow.

Note: The GitLab chatbot will be automatically installed for you in the client if your admin has already set up the chatbot in your account.

Configure GitLab subscription via Gitlab.com

After installing the app, you will be redirected to the GitLab subscription page from the Zoom App Marketplace, after which you can sign up for GitLab.

1. Click the Add Subscription button.
2. Use GitLab.com or your private server to authenticate to your GitLab account if you have one.
   • You have the option to authenticate with Gilab.com by selecting Authorize with Gilab.com and then Authenticate with your Gilab account when using GitLab.com.
     You will be redirected to GitLab to authenticate your GitLab account and authorize Zoom to use it. Once the process is complete, you will be directed back to the subscription configuration page.
   • If you are configuring your GitLab subscription through a private server, follow these steps to configure your GitLab subscription when authenticating through your private server.

Configure GitLab subscription via private server

1. It is important that you allow unwanted traffic from zoom.us to your personal GitLab server.
2. From your GitLab account, you can get an application ID and secret.
3. In your GitLab account settings, click on the Applications tab after logging into your GitLab account. In order for Zoom to access your repositories, you need to create a new application in your account.
4. Zoom should be used as the name, and the following URI should be used as the redirect URI: https://applications.zoom.us/addon/gitlab/authorization/
5. For a later step in the process, you need to copy the application ID and secret to use them.
6. In the Zoom App Marketplace, go to the GitLab Configuration on the left side of the screen and click the Add Subscription button.
7. To authorize the server with a private key, click the Authorize button.
8. In the next step, enter your server domain and the application ID and secret that you got in the previous step.
9. Then click the Save button.
10. Then click Authorize with a GitLab account associated with the private server.
    When you click the link, you will be redirected to your personal GitLab account on your private server.
11. Click the Authorize button.
    It will take a few minutes for your GitLab account to be configured for Zoom.

How to use the GitLab chatbot

Add a subscription

To add a subscription to your GitLab account, you must first authenticate your account.

1. If you want to subscribe, click Add subscription.
2. Here are the basic configurations that need to be entered:
   • Subscription name
   • Add the chatbot to the channel you want to add it to
   • Describe what the subscription includes
3. Perform the following steps on the GitLab Configurations page:
   • In your GitLab repository, select the project you want to work on.
   • You can receive notifications for specific events by checking the boxes next to the events you want to be notified about.
4. Save the configuration by clicking the Save configuration button.
   Upon completion of the Zoom Chat subscription process, you will receive notifications from Zoom Chat based on the preferences you have configured for each subscription. If you want to subscribe to more projects or channels, repeat the steps above.

Interact with the GitLab chatbot

You’ll receive chat notifications once you’ve added a subscription to the Zoom chat channel you configured. A 1:1 chat can also be set up with the chatbot if you want to interact with it directly. You can get a list of possible commands by entering the help command.

How to remove GitLab chatbot

1. You must sign in with your Zoom account to access the Zoom App Marketplace.
2. You can find the Manage button in the top right corner of the page.
3. From the navigation menu at the top of the screen, click Added apps.
4. There is an option to remove GitLub application next to it.
5. Please confirm the dialog box by clicking the Remove button.

data security

• There are a number of pieces of information that this app can access on Zoom:
  • Under the Zoom account, you can view all the groups that a Zoom user is subscribed to.
  • You can view the details of existing meetings for a Zoom user under the Zoom account if the user has one.
  • Under the Zoom account, you can view the Zoom user’s information.
• There is the following information that this app has access to on GitLab:
  • Ticketing system, agents and customers are all part of your ticketing system.
    • As far as we’re concerned, agents and customers only have read-only access to our system.
    • To close tickets, we only use write permission to close tickets.
• There are the following permissions this chat app has on Zoom:
  • An IM channel or Zoom user under Zoom account can be contacted with this chat app by sending a message in a chat window.
  • Zoom users under Zoom account can use this chat app to create Zoom meetings on their behalf on behalf of other Zoom users.
• This chat app uses encryption to ensure communication between it and Zoom/GitLab is secure:
  • Protocol: TLS 1.2
  • Cipher suite: ECDHE-ECDSA-AES128-GCM-SHA256
  • Key length: 128 bits
  • Perfect Forward Secrecy: YES
• The following credentials are stored in the local data storage of this chat app:
  • An encrypted database stores GitLab API tokens and Zoom OAuth credentials (both for admins only).