Before you start
- An Owner or Admin role to create or change a group. Every member can see the groups.
A group lets you share a resource, or name the approvers of a StepAuth policy, once for several people. A member who joins the group gets what it grants, and a member who leaves loses it.
Kinds of groups
| Kind | Where it comes from | Who changes it |
|---|---|---|
| Local | Created in the Web App | Administrators, in the Web App |
| SCIM group | Pushed by your identity provider through SCIM into an identity pool. Its Source is the pool’s name | Your identity provider only |
| Everyone | Created with the organization. Every active member is in it | Nobody. It is not on Groups |
A local group’s name is unique in the organization. A SCIM group’s name is unique only within its identity pool, so two pools can each have a group with the same name. Everyone is reserved.
Create a local group
In the Web App
- In the sidebar, click Organization → Groups.
- Click Create group.
- Enter the Name, then click Create.
- On the group’s page, click Add members.
- Pick the members, then click Add.
The list offers only active members of the organization. To take someone out, click Remove in their row.
- To rename it, click the pencil next to its name, edit the name, then save it.
- To delete it, click Delete, then Delete in the confirmation. Its members lose whatever it granted them.
You cannot rename or delete a SCIM group, or change its members, in the Web App. Do it in your identity provider.
Where groups are used
Manage Access on a resource lists your groups under Groups. Everyone appears there as Global Access, labeled Everyone in, followed by your organization’s name.
A StepAuth policy names approvers by group:
(group "Security") (group "Security" "Okta pool")A bare name, as in the first line, always means a local group, or Everyone. A SCIM group needs its identity pool after its name, as in the second line. The pool name ignores case, the group name does not.
Older groups and pools
SplitSecure did not always record the names of groups and identity pools. A group or pool created before it did has no name record. A StepAuth policy that names one of them by name cannot be saved: the editor shows Some names were not found and The policy was not saved. Saving again fails the same way.
Repair the name record, then save the policy again:
- An identity pool gets its record on its next update. Open the pool under Organization → Advanced → SSO / Identity pools, then click Save changes.
- A local group gets its record when it is renamed to a different name. To keep its name, rename it twice: to a temporary name, then back.
- A SCIM group gets its record on its next push from your identity provider.
Troubleshooting
| Issue | Solution |
|---|---|
| a group with that name already exists | Another local group has this exact nameChoose another name |
| the group name Everyone is reserved | Everyone is the built-in group, in any letter caseChoose another name |
| Delete is disabled, or Remove does nothing | The group comes from your identity providerChange it in your identity provider |
| this org has no group named a name, with (an IdP-synced group needs its pool named too) | The policy names a SCIM group without its poolAdd the pool after the group name |
| Some names were not found for a group that exists | The group or its pool predates name recordsFollow Older groups and pools above |