Slab supports Okta's Push Groups feature, which allows the members of a group in Okta to be one-way synced to the matching group in Slab. If you already assign users via Okta, this is an extremely powerful tool.
Before we jump in, let's look at some prerequisites:
You'll want to be familiar with groups in Slab. Check out our article here.
Before you can push groups with Okta, you'll need to have SCIM provisioning set up
⚠️ Be aware: When a group in Okta is synced to a group in Slab, Okta is always the source of truth — it will always overwrite Slab.
Pushing groups
To push a group to Slab, you must first create a group in Okta (if you already have a group you want to use, you can skip this):
Go to Directory → Groups
Click Add group
Give the group a name, and then add the users you want to the group
⚠️ Be aware: Okta does not support using the same group for assignments and for group push, so keep your push groups separate from groups used for assigning users to the Slab app. You can learn more in Okta's documentation.
Now that you have a group set up, you're ready to set up group pushing!
Go to the Slab app under Applications
Go to the Push Groups tab
Click on the + Push Groups button, then select Find groups by name
In the search box, enter the name of the group you want to push, and select it:
Next, you'll need to choose whether this push group should create a new Slab group or use an existing Slab group:
To create a new Slab group, select the Create Group option from the dropdown
To push to an existing Slab group, select the Link Group option from the dropdown, and then choose the Slab group you want to link
Finally, click the Save button.
You have successfully created a push group! To see the group in Slab:
Go to Groups in the sidebar
Click on the group that you pushed from Okta
Now, whenever you add or remove a user to the group from Okta, the change will be synced to the Slab group.
Adding and removing users from a group
To add or remove a user from a push group, be sure to do so in Okta rather than in Slab.
Go to the group in Okta
If adding a user, click the Assign people button and search for the user to add
If removing a user, click the X next to that user in the group
This will automatically add the user to (or remove the user from) the group in Slab.
Group roles
In Slab, a user can be a regular member of a group or an owner. When a user is added to an Okta push group, they will be added to the Slab group as a regular member. To make a user an owner, you must do so within Slab. You can learn how to do that here.
Stop a group from syncing
Need to stop a group from syncing to Slab?
Go to the Slab app under Applications
Go to the Push Groups tab
Click the dropdown under Push Status and select Deactivate group push
Troubleshooting
If you are experiencing an issue with a push group (e.g., users aren't syncing to the group in Slab), you can manually push the group from Okta.
Go to the Slab app under Applications
Go to the Push Groups tab
Find the group in question, and click the dropdown under Push Status and select Push now
If you are still experiencing an issue or have a question about push groups, please reach out to us at support@slab.com.