Adding your Slack OAuth credentials to Oomnitza

Please follow the steps below to create an OAuth 2.0 app and add your Client ID, Client Secret and Scope to Oomnitza. You can use your API credentials to run the Slack user integration. 

Generate your Slack OAuth credentials

1. Go to https://api.Slack.com/apps.
2. Click Create an App.
3. Select From scratch.
4. Enter a name and select your workspace.
5. Click Create App. You will be brought to the Basic Information page. 
6. Select the Permissions box on the Basic Information page. Alternatively, select OAuth & Permissions in the navigation sidebar.
7. In the Redirect URLs section, click Add New Redirect URL.
8. Enter https://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_urlas the redirect URL.
9. Save the URL and scroll down to the Scopes section.
10. Add the following  User Token Scopes:
    • chat:write
    • groups:write
    • im:write
    • mpim:write
    • users:read
    • users:read.email
    • Important: The following admin scopes are required for the Slack Invite New User and Deactivate User preset. These scopes must be installed by an admin or Owner of an Enterprise Grid Slack subscription. Also, the app must be installed on the entire organization, not on an individual workspace. Refer to step 3 in the Slack API Documentation for installation instructions.
      • admin
      • admin.users:write
11. Add the following  Bot Token Scopes:
    • channels:manage
    • chat:write
    • chat:write.public
    • groups:write
    • im:write
    • mpim:write
    • users:read
    • users:read.email
12. Scroll to the top of the OAuth & Permissions page and click Install to Workspace. You'll be asked to provide your app permissions within your Slack workspace. 
13. Go back to the Basic Information page and copy your Client ID and Client Secret. You'll need this information when you add authentication credentials to the  Oomnitza vault.

For information on Slack OAuth, refer to Slack API Documentation: Installing with OAuth.

For information on Slack Scopes, refer to Slack API Documentation: Scopes.

Add your Slack OAuth credentials to Oomnitza

To add your Slack OAuth credentials in Oomnitza, complete the following steps:

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the Slack User Load integration, and then click the forward button > to select the integration.
4. Enter your Client ID and Client Secret that you copied in step 12 of Generate your Slack OAuth credentials.
5. Add the following scopes (separated by a comma) to Oomnitza, for example:users:read,users:read.email,mpim:write,im:write,groups:write,chat:write,chat:write.public,channels:manage
6. Click Authenticate. You are prompted to log in to authorize your request.
7. Click CREATE.

Information
If the integration is not listed, click Advanced Mode, and add your credentials.

1. On the INFORMATION tab, complete these actions:
   1. Add the name of the credential. 
   2. Add the name of the owner. 
2. Ensure that OAuth 2.0 is selected as the Authorization type.
3. Ensure that Slack is selected from the SaaS list.
4. Enter your Client ID and Client Secret that you copied in step 12 of Generate your Slack OAuth credentials.
5. Add the following scopes (separated by a comma) to Oomnitza, for example:users:read,users:read.email,mpim:write,im:write,groups:write,chat:write,chat:write.public,channels:manage
6. Click Authenticate. You are prompted to log into Slack to authorize your request.
7. Click CREATE.

Next steps

Now that you have added your Slack OAuth credentials to Oomnitza, you can run the Slack user integration.