Need to set up SCIM provisioning with Okta? Check out this article first.

1. Go to the Okta Directory > Groups and set up groups for Whimsical editors and viewers by using the Add group button. You can also use existing groups that you might have, for example “Contractors” and “Employees”.

2. Go to your Applications page and open the Whimsical app:

3. Once the Whimsical app is open, click on the Assignments tab. Then select the Assign button > Assign to Groups:

4. You can find the Whimsical groups you set up in Step 1 here. Click the Assign option for a group:

5. For the Whimsical editor group, select Workspace Editor = true, and for the Whimsical viewer group, select Workspace Editor = false.

This will take effect from when a user first logs in with SAML and the SCIM editor is set to undefined. Then the role can be changed using the Members page in workspace settings.

6. Once completed, your groups will show as Assigned:

The priority order in the Groups tab defines which role a user should have if they end up in both groups.

7. At this point, if you haven’t already added users to your groups, you can do this now. Users can be added to groups either before or after groups are assigned to Whimsical.

For example you may already have groups by company roles in place, like “Product”, “Operations”, “Engineering”. You could assign editor access to the existing to “Product” and “Engineering” groups, but viewer access to the “Operations” group.

Note: You do not need to assign any attribute mappings to the editor group attribute under the Provisioning tab. It is mapped through Group assignments. You can leave this blank, showing “Not mapped”.