Slack - SCIM Provisioning

Slack - SCIM Provisioning

Overview

This article provides instructions on how to connect to an API to do provisioning from your application into Zilla. You will launch your application from Zilla, create SCIM API Token, and provision account in slack.

Instructions

Steps to generate SCIM API token for slack

If you already have slack application created and setup for API integration skip step 1 - 10 below and follow from step.

  1. 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.

      image-20241108-093417.png

       

  2. Click Build in the upper right corner.

    image-20241108-103613.png

     

  3. Click Create New App.

    image-20241108-105210.png

     

     

  4. Select “From a manifest“ in the below shown pop-up.

    image-20241108-105717.png

     

  5. Select Your Workspace and click Next.

image-20241108-104859.png
  1. 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

 

  1. Click Next.

image-20241108-110325.png
  1. Click Create.

image-20241108-110744.png
  1. Click Install App in the left panel then click Install to [Your Workspace Name] and then click Allow.

image-20241108-111739.png

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.

image-20241108-112409.png

 

  1. Navigate to OAuth & Permissions → under OAuth Tokens click on Install to Org and generate OAuth tokens

image-20250225-123056.png

Copy User OAuth Token which can be used as SCIM API Token in Zilla

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.

image-20240412-120718.png
  • 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.

     

    image-20241108-113609.png

     

  • Fill in the form with appropriate details and then click Add to Applications.

     

    image-20241108-113748.png

      

  • A detailed view of Slack application appears. Click Sync now in top right corner.

     

    image-20241108-113855.png

     

  • Enable Provisioning 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*)“.

image-20241108-121254.png

Set Enable account modifications? (Yes/No) to Yes for enabling Provisioning.

image-20250224-071907.png

Set up joiner or leaver policy to trigger provisioning for slack.

 

When you have finished with all the steps above, review the information in Zilla that was synced.

Having trouble? Try our Troubleshooting articles or visit support.zillasecurity.com and submit a ticket. Our support team will assist you in resolving the problem as quickly as possible.