Skip to main content
Support

Configuring Slack Single Sign On

Many teams use Slack to communicate with their team, so it makes sense to have the ability to log into other services using the same service.

River Sloane
Updated by River Sloane
3 min read

Many teams use Slack to communicate with their team, so it makes sense to have the ability to log into other services using the same service.

Here's how to configure Slack SSO so your team members can Sign in with Slack.

Only some of our plans have access to Slack SSO

Setting up Slack SSO

  1. Head to Settings > Sign-in & access
  2. Under Single sign-on find Slack
  3. Click the β‹― menu > Connect
  4. Click Connect Slack and follow the instructions
  5. Slack sends you back to Settings > Integrations. Head to Settings > Sign-in & access again, find Slack, and click the β‹― menu > Configure
  6. Tick Let users log in with Slack
  7. Close the panel and click Save changes

Now anyone in your Slack workspace will be able to sign in with Slack from the login page. Slack shows Partially connected until you tick that box.

To limit who can sign up through Slack, add your domains to Email domains in the same section. Once your account reaches its user limit, new people can't join through Slack unless you've invited them. Neither of these stops existing users from signing in. Someone who already belongs to HelpDocs accounts in another organization can't join through Slack unless they've been invited to that account. Without an invitation, they see a message asking for an invitation with a different email address. An invitation lets them join as a guest, as explained in Inviting Guests From Another Organization.

Assigning User Groups to Slack SSO Users

This is only relevant to accounts with the Permissions feature

When a member of your team signs up to HelpDocs they'll get assigned the default role from your account. If you're using our Permissioning features to show internal docs to your team, you may want to assign them to user groups at signup. Luckily it's super simple.

  1. Head to Settings > Sign-in & access
  2. Find Slack and click the β‹― menu > Configure
  3. Set the default groups you'd like to assign Slack users under Default user permission groups
These permission groups will only be added to a user the first time they sign in with Slack, so you can change their group on a per-user basis later
  1. Close the panel and click Save changes

Someone you invite who then signs in with Slack gets the role and any groups on their invitation.

Requiring SSO

You can turn off password sign-in for your whole account with Require SSO. Slack counts as SSO here once Let users log in with Slack is ticked.

Require SSO applies to everyone on your account, including the owner, except guests. Guests sign in through their own organization. Sign in with Slack yourself before you turn it on, because a password won't get you in afterwards.

What did you think of this doc?

Previous Shared Password Protection