There is a continuous integration server called Jenkins, which can be configured to meet the needs of your organization thanks to over 600 plugins. Zoom’s Jenkins Integration allows you to receive notifications regarding build notifications to a channel in Zoom Chat as well as messages from a robot related to build notifications in Zoom Chat.
Prerequisites for Jenkins Chatbot
- There needs to 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 has not been pre-approved.
How to install and configure the Jenkins app
Install from the Zoom App Marketplace
- Log in with your Zoom account to access the Zoom App Marketplace.
- Enter Jenkins in the search box in the top right corner of your screen and you will be able to find the app.
- Find the Jenkins app in your search results and click on it once you have found it.
Note: You need to contact your Zoom administrator in order for this app to be approved for your account if it has not been pre-approved.
- Click on the Add button.
- When you have confirmed the permissions that the app requires, click on the Allow button.
Note: Jenkins Chatbot will automatically be installed for you in the client if your admin has installed the Jenkins Chatbot and your admin has enabled it.
Configure the Jenkins Chatbot
This next step will need to be completed by an admin on your Jenkins account in order to proceed.
- In the Zoom App Marketplace, you will be able to download the Jenkins Chatbot and after installing it, you will be able to access the chat channel that you wish to add Jenkins notifications to.
- You can connect to Jenkins by typing /jenkins connect.
Upon receiving a direct message from the Jenkins Chatbot, you will be notified immediately. There will be a webhook URL and a token in this message.
- In the next step, you will need to copy the URL and token of the webhook for use in the next step.
- Log in to your Jenkins account if you do not already have one.
- From the left navigation menu of your Jenkins dashboard, click the Manage Jenkins button on the left side of the screen.
- To manage your plugins, click on the Manage Plugins button.
- Search for Zoom under the Available tab on the left side of the screen.
- Install the plugin by selecting the check box and clicking the install button.
- Then, from the project’s menu, select Configure for each project for which you would like to receive notifications.
- The Zoom Build Notifier should be added to this project’s Post-build Actions.
- To fill out the textbox, you will need to add the following values that you received from the chatbot earlier (Steps 2 and 3):
- Webhook URL
- You can do this by clicking the Advanced… button.
- Make sure that the check boxes for the events that you would like to be notified about are selected.
- The changes you have made will be saved once you click Save.
How to use the Jenkins Chatbot
- Listing 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 the Jenkins Chatbot
- You will need to sign in with your Zoom account in order to access the Zoom App Marketplace.
- On the right side of the page, you will see a Manage button in the top right corner.
- Select Added Apps from the navigation menu on the left side of the screen.
- The Jenkins app can be removed by clicking the Remove button next to it.
- Click the Remove button after you have confirmed the dialogue box.
- There are a number of information on Zoom that this app has access to:
- Under a Zoom account, you can view all the 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 the Zoom account, you are able to view the information of a Zoom user.
- The information that can be accessed by this app on Jenkins is as follows:
- Information about Jenkins builds.
- It is read-only information for Zoom users.
- Information about Jenkins builds.
- There are the following permissions that this chat app has on Zoom:
- An IM channel or Zoom user under a Zoom account can be sent a chat message by 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 with Zoom/Jenkins encryptedly 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
- There is a local data store in this chat app that stores access credentials:
- There is an encrypted database that stores Jenkins API tokens as well as Zoom OAuth credentials (both of which are accessible only to admins).