Setting up SCIM provisioning

Who can use this feature

  • Supported on Enterprise plans
  • Anyone with an org admin role can access and edit SCIM settings

What's in this article:

Features

Writer supports the following provisioning features:

  • User and Group Push: IdP groups are automatically pushed to Writer Teams, and users are pushed as team members in your Writer organization.
  • User and Group Import: Writer users are imported into IdP and matched against existing users, or created as new ones. Writer Teams are imported as IdP groups.
  • Update user attributes
  • Deactivate/reactivate users

Presently, Writer doesn't support the following provisioning features, but may in the future:

  • Sync password
  • Create/delete teams

Requirements

  • Set up SAML SSO between Writer and IdP
  • SCIM included in your Writer Enterprise subscription (ask your CSM, or check service agreement to confirm)

Setup instructions

1. Locate SCIM setup details in Writer

To get started, visit the Admin PanelSingle sign-on page and find the SCIM section.

From here, you can select the default team new users are assigned to. More importantly, though, this is where you'll find important setup details, including your unique bearer token:

Unique identifier: email
Endpoint: https://app.writer.com/api/scim/v2
Bearer token: unique to your Writer organization

2. Configure SCIM in IdP

Go to the Writer SSO application in your IdP, and enable SCIM provisioning with your Writer setup details.

If Okta is your IdP, check out this article for more steps on setting up SCIM.

FAQ

General

Q: Can we provision our entire organization?

Yes and no. IdPs typically don't allow you to select everyone for a group push. However, if all of your users are assigned to groups, you can push all of these to Writer, which will provision everyone.

Q: Can we manage imported group memberships in our IdP?

No.

Q: Can we create or delete Writer Teams in our IdP?

No.

Q: Can we set the team admin user role in our IdP?

No.

Troubleshooting

If you have questions around our SCIM integration, please contact support@writer.com.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Support Contact Support