Using Zoom's Jenkins app

Jenkins is a customizable continuous integration server with over 600 plugins, allowing you to configure it to meet your needs. Zoom’s Jenkins Integration allows you to receive Zoom Team Chat notifications and messages from a app relating to build notifications to a channel in Zoom.

This article covers:

• How to install and configure the Jenkins app
  
  • Install from the Zoom App Marketplace
  • Configure the Jenkins app
• How to use the Jenkins app
• How to remove the Jenkins app
• Data security

Prerequisites for using the Jenkins app

• A Jenkins admin account
• Pre-approval of the Jenkins app in the Zoom App Marketplace
  Note: If the app is not pre-approved, please contact your Zoom admin.

How to install and configure the Jenkins app

Install from the Zoom App Marketplace

1. Sign in to the Zoom App Marketplace with your Zoom account.
2. In the top right of your screen, enter Jenkins in the search box to find the app.
3. In your search results, find the Jenkins app and click it.
   Note: If the app is not pre-approved, contact your Zoom admin to approve this app for your account.
4. Click Add.
5. Confirm the permissions the app requires, then click Allow.

Note: If your admin has installed the Jenkins app, the app will automatically be installed for you in the client.

Configure the Jenkins app

Note: An admin on your Jenkins account will need to complete these next steps.

1. After installing the Jenkins app from the Zoom App Marketplace, access the chat channel that you would like to add the Jenkins notifications to.

2. Type /jenkins connect.
   You will receive a direct message from the Jenkins app. This message will contain a webhook URL and a token.

3. Copy the value of the webhook URL and token for use in a later step.

4. Sign in to your Jenkins account.

5. In your Jenkins dashboard, from the left navigation menu, click Manage Jenkins.

6. Click Manage Plugins.

7. Click the Available tab and search for Zoom.

8. Select the check box and install the plugin.

9. For each project that you would like to receive notifications for, click Configure from the project’s menu.

10. Add Zoom Build Notifier to the Post-build Actions for this project.

11. Add the following values that you received earlier (Steps 2 and 3) from the app in the textbox:

    • Webhook URL

    • Token

12. Click the Advanced... button.
13. Select the events' check boxes that you want to be notified about.

14. Click Save to save the changes.

How to use the Jenkins app

• 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 app

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 Jenkins 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 Jenkins:
  • Jenkins build information.
    • This information is read-only for Zoom.
• 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/Jenkins 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:
  • Jenkins API tokens and Zoom OAuth credentials (both admin-level only) are stored in an encrypted database.