This guide walks you through setting up SCIM provisioning with Ping Identity for your Sketch Workspace. You’ll need SAML SSO configured before you begin — if you haven’t done that yet, follow the Ping Identity SSO setup guide first.
If you need help along the way, contact us and we’ll help you out.
1. Create a custom user attribute
This step controls whether Sketch provisions users as Editors or Viewers. Make sure you’re in the same environment as your SAML app. You can verify this in the header breadcrumb.
- Go to Directory > User attributes.
- Click the blue + button, select Declared, and continue.
- Enter
accessLevelin the name field. - Enter Access Level as the display name.
- Optionally, enter a description.
- Select Enumerated values from the dropdown and add:
editorviewer
- Click Save.
Apply the attribute to users
Apply the Access Level attribute to the users who need access to Sketch.
- Go to Directory > Users.
- Select a user and click Edit user.
- Scroll to the bottom and click +Add in the Custom attributes section.
- Select the Access Level attribute and set the value to
editororviewer.
We’ll provision users without a custom attribute value as Viewers.
2. Create user groups
User groups control who has access to Sketch. You’ll assign these groups to your SAML app in the next step.
- Go to Directory > Groups.
- Click the blue + button.
- Enter a descriptive name — for example,
Sketch-viewersorSketch-editors. - Add the required members to each group.
Assign groups to the SAML app
By default, all users in your directory can sign in to Sketch. Assigning groups lets you limit access to specific users.
- Go to Applications > Applications.
- Click the SAML app you configured for Sketch.
- Go to the Access tab and click Edit.
- Select your Editors and Viewers groups and save.
If you don’t assign any groups, all users in your directory can sign in to Sketch. We’ll add them as Viewers by default.
3. Set up SCIM provisioning
Before you start, get the SCIM Base URL and token from your Sketch Workspace:
- Open the web app and go to Settings > Single Sign-on.
- Click Enable SCIM.
- Have the SCIM Base URL and SCIM token ready.
Create a provisioning connection
- Go to Integrations > Provisioning.
- Click the blue + button and select New Connection.
- Select SSO Identity Store.
- Search for “scim” and select SCIM outbound.
- Enter a name and an optional description.
- Paste the SCIM Base URL from your Sketch Workspace.
- Set Authentication method to OAuth 2 Bearer Token and paste the SCIM token.
- Test the connection. If it’s successful, move on to configure connection preferences.
Configure connection preferences
- Select a user identifier:
- Choose userName if your users sign in with their email address.
- Choose workEmail if they use a separate username.
-
Paste the following value in the Custom Attribute Schema URN field:
urn:ietf:params:scim:schemas:extension:sketch:1.0:User - Enable the following options:
- Enable users creation
- Enable users updation (Ping Identity’s label for user updates, including Enable users disable)
- Enable users deprovision
- In Remove Action, select Delete.
- Save, then enable the connection.
4. Configure provisioning rules
Create two rules — one for Editors, one for Viewers. The Editors rule needs an extra attribute mapping in step 6. Skip that step for the Viewers rule.
- Click the blue + button and select New Rule.
- Select PingOne as source.
- Select the connection you created and continue.
- Name the rule — for example,
Sketch-editorsorSketch-viewers. - Add a user filter:
- Select
Group namesin the Attribute field. - Click the value field and select the group that matches the rule.
- Select
- For the Editors rule, map the
accessLevelattribute:- Click +Add.
- Select
accessLevelin the left column androlesin the right column.
- Click Save.
5. Enable provisioning rules
Enable the provisioning rules for both Editors and Viewers. User syncing starts shortly after — give it a few minutes, then check your Sketch Workspace to confirm provisioning worked correctly.
Considerations
- If you reach your Editor seat limit, Ping Identity will still provision the user, but we’ll add them as a Viewer to avoid unwanted extra charges.
- If you disable a user, we’ll remove them from the Workspace. Any documents in their My Drafts folder will move to a restricted folder that Workspace Admins can access.