Connection¶
Slack on Hire2Retire uses API Key Bearer
authentication.
We at RoboMQ pay utmost attention to keep your account secure. See our Security and Privacy Policies to learn more about how RoboMQ handles your account access.
Object | Permission |
---|---|
User | Can Provision and Deprovision Users |
How to Obtain OAuth Token on Slack¶
- Please visit the Slack app management site by clicking here.
- Log into this site. Any user of the organization can login here.
-
Click on the
Create New App
button on the top right corner. Select the optionFrom scratch
to proceed.Figure 1. Create New App on SlackFigure 2. From scratch -
Enter the app name, and select the workspace of your organization to develop the app in.
Figure 3. Enter the app name, and select the workspace -
At the next window, click on
OAuth & Permissions
in the left navigation list.Figure 4. OAuth & Permissions -
Under the Scopes section, provide the
admin
scope for user token.Figure 5. Assign Scopes -
To obtain the OAuth Token, install the app in the selected workspace by clicking on Intall to
your workspace name
.Figure 6. Install the app in workspace -
You will be redirected to a window, asking for your consent. Click on the allow button to grant the access on your behalf. Please note only admin user has access to install this app.
-
At the last step, you will have a OAuth Token. Copy this token.
Figure 7. Obtain the OAuth Token
For more information, please refer to Slack official documentation here
Obtain Token for Enterpise Grid Slack plan¶
On Enterprise Grid, SCIM operations work across the entire organization, not individual workspaces. A SCIM app can provision, de-provision, and update team members in just one place rather than having to do so across every workspace in an organization.
For this reason, the OAuth token used for calling SCIM API methods must be obtained from installing the app on the organization, not just a workspace within the organization. To get a SCIM app working on an Enterprise Grid organization, you'll need to do the following:
- Create a slack app by following the same steps 1 to 6 mentioned above.
- Enter the URL
https://hire2retire.robomq.io/api/auth/callback/Slack
in the redirect URL option under the OAuth & Permission. - In the app's settings, select Manage Distribution from the left navigation. Under the section titled Share Your App with Other Workspaces, ensure all four sections are checked. Then, click Activate Public Distribution.
- Under the Share Your App with Your Workspace section, copy the Shareable URL and paste it into a browser to initiate the OAuth handshake that will install the app on your organization. You will need to be logged in as an owner of your Enterprise Grid organization to install the app.
-
Check the drop-down menu in the upper right of the installation screen to ensure you are installing the app on the Enterprise Grid organization, not an individual workspace within the organization.
Figure 8. Grant organization level access -
Once your app completes the OAuth flow, you will be granted an OAuth token
For more information, please refer to Slack official documentation here
Link Slack account on Hire2Retire¶
To establish a connection to the Slack on Hire2Retire Access, you need to provide the OAuth Token that is obtained by following the steps mentioned above.
Once the connection is established successfully, then you can define the roles and mapping on Hire2Retire Provisioning.