Slack

This page outlines the process of configuring and using the Slack API through Zilla to sync groups and users.

Steps to get required API config values

Go to Slack and open your team's slack either in the browser or in the Slack App.
- Click on Manage apps under the Tools & Settings for your workspace.
Click Build in the upper right corner.
Click Create New App.
Select “From a manifest“ in the below shown pop-up.
Select Your Workspace and click Next.

6. Remove the Example YAML and paste the following code in the YAML tab shown in step 7 below:

_metadata:
  major_version: 1
  minor_version: 1
display_information:
  name: ZillaConnector
  description: Connect Slack Workspace to Zilla Security
  background_color: "#A020F0"
settings:
  socket_mode_enabled: false
oauth_config:
  scopes:
    user:
      - team:read
      - usergroups:read
      - users:read
      - users:read.email
      - channels:read
      - groups:read
      - im:read
      - mpim:read
  redirect_urls:
    - https://app.zillasecurity.com/api/auth/callback/slack

7. Click Next.

8. Click Create.

9. Click Install App in the left panel then click Install to [Your Workspace Name] and then click Allow.

10. Click on Basic Information in the left panel. The API config values for Client ID and Client Secret can be found on the screen. Copy and save them in a safer place for use in the steps ahead.

Setup Slack Application Integration on Zilla

Visit the Zilla application and login using your admin credentials and then click Add Application in the top right.

A window with a search bar appears, type in Slack in the search bar and hit enter. Slack app entry will appear at the top of the list, click Add to Applications button to the right.
Fill in the form with appropriate details and then click Add to Applications.
A detailed view of Slack application appears. Click Sync now in top right corner.
Enable API Integration and fill in the mandatory fields. Click Next/Sync Now.

Note: Sync Slack Channels (Yes/No) field will have default value No. If it is set to Yes, then all the channels (public, private) of the workspace will be synced to Zilla. If you want to sync only specific slack channels, please mention them in comma separated format under field “Filter channels by comma separated names with wildcards (eg. ext*, *internal, *sales*)“.

Click Next and the sync will begin.
Click Allow if asked for permission and then click Done.

Sync summary window will pop-up, check and click Close.

To sync data we recommend using the API method. However, you may also sync data with our Browser Extension, follow instructions here: Slack - Browser Extension.