Use Zoom’s Jenkins chatbot integration

There is a continuous integration server called Jenkins that can be customized to your company’s needs thanks to over 600 plugins. Zoom’s Jenkins integration allows you to receive build notification notifications to a channel in Zoom Chat, as well as receive build notification messages from a robot in Zoom Chat.

Requirements for Jenkins Chatbot

• There must be an administrator account for Jenkins
• Jenkins Chatbot has been pre-approved as an app on the Zoom App Marketplace
  Note: Please contact your Zoom administrator if the app is not pre-approved.

How to install and configure the Jenkins app

Install from the Zoom App Marketplace

1. Sign in with your Zoom account to access the Zoom App Marketplace.
2. Type Jenkins in the search box in the top right corner of your screen and you can find the app.
3. Locate the Jenkins app in your search results and once you find it, click on it.
   Note: You must contact your Zoom administrator to have this app approved for your account if it is not pre-approved.
4. Click the Add button.
5. Once you have confirmed the permissions required by the app, click on the Allow button.

Note: Jenkins Chatbot is automatically installed for you in the client if your admin has installed the Jenkins Chatbot and your admin has enabled it.

Configure the Jenkins chatbot

Note:

This next step must be performed by an administrator of your Jenkins account in order to proceed.

1. You can download the Jenkins chatbot from the Zoom App Marketplace and, once installed, access the chat channel you want to add Jenkins notifications to.
2. You can connect to Jenkins by typing /jenkins connect.
   If you receive a direct message from the Jenkins chatbot, you will be notified immediately. This message contains a webhook URL and a token.
3. The next step is to copy the webhook’s URL and token for use in the next step.
4. Sign in to your Jenkins account if you don’t already have one.
5. From the left navigation menu of your Jenkins dashboard, click the Manage Jenkins button on the left side of the screen.
6. To manage your plugins, click the Manage Plugins button.
7. Look for “Zoom” under the “Available” tab on the left side of the screen.
8. Install the plugin by checking the box and clicking the Install button.
9. Then, from the project’s menu, select Configure for each project you want to receive notifications about.
10. The Zoom Build Notifier should be added to the post-build actions of this project.
11. In order to fill out the text field, you need to add the following values, which you received earlier from the chatbot (steps 2 and 3):
12. You can do this by clicking the Advanced… button.
13. Make sure the checkboxes for the events you want to be notified about are checked.
14. The changes made are saved as soon as you click Save.

How to use the Jenkins chatbot

• List all commands: Type /jenkins help
• Connect to a channel: Type /jenkins connect
• Remove the Jenkins integration from a channel: Type /jenkins disconnect

How to remove Jenkins chatbot

1. You must sign in with your Zoom account to access the Zoom App Marketplace.
2. On the right side of the page, you will see a Manage button at the top right.
3. Select Added apps from the navigation menu on the left side of the screen.
4. The Jenkins app can be removed by clicking the remove button next to it.
5. Click the Remove button after confirming the dialog box.

data security

• There is a range of information about Zoom that this app has access to:
  • Under a Zoom account, you can view all groups subscribed to by a Zoom user.
  • Under the Zoom account, you can view the details of existing meetings that have already been scheduled by a Zoom user.
  • Under Zoom Account, you can view a Zoom user’s information.
• The information that this app can access on Jenkins is as follows:
  • Information about Jenkins builds.
    • This is read-only information for Zoom users.
• There are the following permissions this chat app has on Zoom:
  • A chat message can be sent to an IM channel or Zoom user under a Zoom account using this chat application.
  • Any Zoom user under the Zoom account can use this chat application to create a Zoom meeting for them on their behalf.
• This chat app communicates encrypted with Zoom/Jenkins through the following channels:
  • TLS 1.2 is the protocol used for this connection.
  • Cipher suite: ECDHE-ECDSA-AES128-GCM-SHA256
  • The length of the key is 128 bits.
  • The answer is YES when it comes to Perfect Forward Secrecy
• In this chat app there is a local data storage that saves access data:
  • There is an encrypted database storing Jenkins API tokens as well as Zoom OAuth credentials (both accessible only to admins).