Search the documentation
Search the documentation...
SplitSecure documentation

On this page

Procedure · 3 steps

Manage groups

Group members so you can share resources and name approvers once for several people.

Updated

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

  1. In the sidebar, click Organization → Groups.
  2. Click Create group.
  3. Enter the Name, then click Create.
  1. On the group’s page, click Add members.
  2. 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