Skip to content

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

  1. Please visit the Slack app management site by clicking here.
  2. Log into this site. Any user of the organization can login here.
  3. Click on the Create New App button on the top right corner. Select the option From scratch to proceed.

    Connection

    Figure 1. Create New App on Slack

    Connection

    Figure 2. From scratch

  4. Enter the app name, and select the workspace of your organization to develop the app in.

    Connection

    Figure 3. Enter the app name, and select the workspace

  5. At the next window, click on OAuth & Permissions in the left navigation list.

    Connection

    Figure 4. OAuth & Permissions

  6. Under the Scopes section, provide the admin scope for user token.

    Connection

    Figure 5. Assign Scopes

  7. To obtain the OAuth Token, install the app in the selected workspace by clicking on Intall to your workspace name.

    Connection

    Figure 6. Install the app in workspace

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

  9. At the last step, you will have a OAuth Token. Copy this token.

    Connection

    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:

  1. Create a slack app by following the same steps 1 to 6 mentioned above.
  2. Enter the URL https://hire2retire.robomq.io/api/auth/callback/Slack in the redirect URL option under the OAuth & Permission.
  3. 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.
  4. 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.
  5. 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.

    Connection

    Figure 8. Grant organization level access

  6. Once your app completes the OAuth flow, you will be granted an OAuth token

For more information, please refer to Slack official documentation here

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.

Connection

Figure 9. Authentication Form for Slack on RoboMQ Hire2Retire

Once the connection is established successfully, then you can define the roles and mapping on Hire2Retire Provisioning.