Adding your Slack API credentials to Oomnitza

Complete the following steps to add your Slack API credentials to Oomnitza. You can use your API credentials to run the last login user integration.

Warning
A workspace must be on a paid plan to use this method, otherwise, a paid-only error is thrown when running the integration.

Procedure

To set up API authentication in Slack, complete the following steps:

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:admin. The scope must be installed by an admin or Owner of an Enterprise Grid Slack subscription. 
11. Install the app to an individual workspace, NOT the entire organization. Refer to step 3 in the Slack API Documentation for instructions.

Note
Be mindful of where the app has been installed. Installing the app at an Organization level may prevent Oomnitza's Slack integration from properly accessing the necessary Workspace level data. If you've set up your app and confirmed the correct scopes, but the Slack Integration returns an empty response, you may need to recreate the app and install it solely to a Workspace, not an Organization.

Results
To retrieve your token, navigate to Features > OAuth & permissions > OAuth Tokens for Your Workspace. Your user token should start withxoxp

Return to Oomnitza with your token and complete the following steps:

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the Slack User Load - Last Login integration, and then click the forward button > to select the integration.
4. Enter "Bearer" followed by a space and the API Key. For example,Bearer aefgd-adw3n-jknadd78l1kjndc.
5. Click Create.

Integration not in the list? Click Advanced Mode and complete these steps:

1. Add the information details. Enter a descriptive name for the credentials such as Slack Last Login (API Key), to distinguish it from the OAuth credentials.
2. Click the AUTHORIZATION tab.
3. Ensure that API Key is selected as the Authorization type.
4. Ensure that the Token Name is Authorization
5. Enter "Bearer" followed by a space and the API Key. For example,Bearer aefgd-adw3n-jknadd78l1kjndc.
6. Ensure that Add to Header is selected.
7. Save your changes

Next steps

 Now that you have added your API credentials, you can run the Slack last login user integration.