If you're having trouble at any stage please contact us at support@skyformation.com.

Preface

The goal of this guide is to add a new SkyFormation's Zoom Cloud App Connector to your SkyFormation Platform.

Prerequisites

The Zoom connector uses an app that needs to be set up on the Zoom platform. You can either use JWT or OAUTH2 type application.

For Auth2 authentication

NOTE: To create the Zoom App the user account needs to be with type "Licensed" and "role" owner

1. Go to your Zoom profile in the zoom.us website.
2. In the left navigation panel, go to Admin -> Advanced -> App Marketplace.
3. On the top right, open “Develop” dropdown menu and select “Build App”
4. Select OAuth and click “Create”
5. Fill in app name. App type should be “Account-level app”. Publishing feature should be disabled.
6. You will be redirected to a window where you will see the Client ID and Client Secret for your app, this credentials will be used in the UI when we will onboard the connector. Either save them in some secure place or follow the previous steps to view them from Zoom’s website when needed.
7. In the same window, unser “Redirect URL for Oauth” and “Whitelist URL” add `https://auth.skyformation.net/v1/oauth` to have Skyformation be able to properly authenticate.
8. In the left panel, under “Scopes” we will need to ad permissions for the Zoom app in order for Skyformation to be able to fetch the events. Click “Add scopes”. We currently need:
   * account:master
   * accounts:read:admin
   * group:master
   * group:read:admin
   * report:master
   * report:read:admin
   * role:read:admin
   * user:master
   * user:read:admin

For JWT Authentication

Please follow this guide to create a JWT app - guide

Note: Only 1 JWT app can exist in an org. . If your org. already has a JWT app please use it for this integration

From the JWT App registration process, keep aside the API Ket and API Secret.

- Open the following services to be approachable from the SkyFormation machine:

   https://api.zoom.us/v2/report

On-board steps

1. Logon to your SkyFormation Platform:

2. Navigate via left navigation panel to “Settings” section

3. Navigate via New Settings left navigation panel to “Accounts” section

4. Click the “Add Account” botton

5. At the “SELECT SERVICE TO ADD” choose Zoom

6. Fill in the following information:

- Tenant (relevant only for the multi-tenant SkyFormation edition)
* Choose the tenant the new connector will be attached to.

- Account Name
* Give the custom connector a meaningful name for you. This will become your application connector name displayed in the SkyFormation platform and added to entire events sent to your SIEM system from this connector as an identifier.

Example: “Zoom integration”

- Description
* Add any text that describe the specific application and meaning for the business.

Example: “Web conferencing”

For JWT Authentication:

- API Key
* API Key of the JWT App

- API Secret
* API Secret of the JWT App

- Authentication Method: JWT

7. Test the settings correctness

For Oauth2 Authentication:

- Authentication Method:
* oauth2

- Client_id:
* Fill in from the Oauth onboarding step (step 6)
- Client_secret:
* Fill in from the Oauth onboarding step (step 6)

Click the “TEST CONNECTION” button

If you see a green OK sign appears as above you have completed the onboard successfully.

- Click “SAVE” button

8. Start the new connector

When a new cloud connector is added its default state is STOPPED.

To start it press its START button.

DONE !