Skip to content

Suggested searches

    Search all documentation ↑↓ to navigate Enter to open Esc to close

    Slack

    Connect Slack as an access review source with OAuth so Probo can list your workspace members with their role and two-factor authentication status.

    Markdown

    Probo reads your Slack workspace members through the users.list API. For each member it records the role and whether two-factor authentication is turned on. Slack connects through OAuth only, so there is no API key to create or paste.

    • Probo organization administrator access
    • The Admin, Owner, or Primary Owner role in the Slack workspace you want to review
    Probo fieldSlack fieldNotes
    Namereal_name
    Emailprofile.emailMembers without an email address are not listed, which in practice leaves out bots and apps
    Roleis_primary_owner, is_owner, is_admin, is_restricted, is_ultra_restrictedOne of Primary Owner, Owner, Admin, Restricted (multi-channel guest), Ultra Restricted (single-channel guest), or Member
    Adminis_admin, is_owner, is_primary_ownerAdmin when any of the three is true
    StatusdeletedInactive when the member is deactivated
    MFAhas_2faEnabled or Disabled. Unknown when Slack leaves the field out, as it can for deactivated members, and for every member when the token cannot see it
    Last loginNot supported
    External IDidSlack member ID, used to track the account across reviews
    Created atNot supported

    Probo also records each member’s job title from profile.title.

    Probo reads MFA only from the has_2fa value Slack reports. If your members sign in to Slack through an identity provider, check their MFA status in that provider as well.

    1. In Probo, go to Settings > Connectors and click Add more to open the Marketplace.
    2. Find Slack and open it.
    3. Enter a Name for the connection (e.g. main) and click Connect.
    4. Sign in to Slack as a workspace admin or owner, pick the workspace you want to review, then click Allow. Probo requests the users:read and users:read.email user scopes.
    5. Go to Access Review > Sources, click Add sources, tick Slack, and click Add.

    Probo names the source after the Slack workspace and pulls its members into your campaigns. Each connection covers one workspace. To review several workspaces of an Enterprise Grid organization, connect each workspace separately.

    • “Slack must be connected by a workspace admin or owner, the only role Slack shares MFA status with.” The person who authorized Probo is not an admin or owner of the workspace, so Probo rejected the connection. Connect Slack again from the Marketplace and authorize as an Admin, Owner, or Primary Owner.
    • The source says Slack is disconnected. The token was revoked, for example because the person who authorized Probo left the workspace or removed the app, or the connection predates MFA collection and still uses a bot token, which cannot read it. Open the Slack connector in Settings > Connectors, click Reconnect, and authorize as a workspace admin or owner.
    • The source says Slack refused this request. The person who authorized the connection is no longer an admin or owner, so Slack stopped returning MFA status to their token. Click Reconnect on the Slack source in Access Review > Sources and authorize as a current admin or owner.
    • A member is missing. Probo skips Slackbot and every member without an email address, which in practice leaves out bots and apps.