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