Managing SSO readers and reader groups

Prev Next

Give readers who sign in through your identity provider (IdP) access to the right content without inviting each one. When you turn on Auto-register SSO readers in an SSO configuration, a reader who signs in with SSO for the first time is added to the reader groups you choose. Use it for large or frequently changing reader bases that you manage centrally in your IdP.


When to use auto assign reader group

  • Your readers sign in with SAML or OpenID Connect SSO, and you don't use SCIM provisioning on that SSO configuration.
  • You want new SSO readers to get a default level of content access as soon as they sign in.
  • You serve several audiences, such as internal staff and external customers, through separate SSO configurations and want each audience in its own reader group.

Before you begin

  • SSO is already configured for your project with SAML or OpenID Connect.
  • The reader groups you want to assign already exist. To learn how to create one, read Create reader group.
  • You have the Owner or Admin project role.
NOTE

The Auto-register SSO readers toggle appears only on existing SSO configurations. It's hidden on new SSO configurations.


How to turn on auto-register SSO readers

  1. Go to Settings () > Users & Permissions > Enterprise SSO.
  2. Hover over the SSO configuration you want to update and click the Edit () icon.
  3. In the SSO configuration panel, go to the More settings tab.
  4. Turn on the Auto-register SSO readers toggle.
More settings tab of an SSO configuration with the Auto-register SSO readers toggle turned on and the reader group search field below it.
  1. In the search field that appears, search for and select the reader groups you want to assign to readers when they sign in.
  2. Click Apply to confirm the selected reader groups.
  3. Click Update to save the SSO configuration.
    Readers who sign in with this SSO configuration for the first time are added to the selected reader groups. They get read-only access to the content those groups can view.

To check the setup, ask a new reader to sign in with SSO. Then go to Settings () > Users & Permissions > Readers & groups > Reader groups, open one of the selected groups and confirm the reader appears in its associated readers.


Manage SSO readers

Auto assign reader group controls group membership for new SSO readers. Use these tasks to add, convert and manage SSO readers in other ways:

  • Add a new SSO reader: Add the reader and select the SSO user checkbox and an SSO configuration. To learn how, read Add readers.
  • Convert existing readers to SSO: Select readers in the Readers list and convert them to SSO accounts. Their content access and group memberships stay the same, and they can no longer sign in with their Document360 password. To learn how, read Convert reader to SSO. To convert accounts in bulk from the SSO configuration, read Inviting or Adding SSO users.
  • Manage readers from your IdP with SCIM: With SCIM provisioning, your IdP creates and updates readers in Document360 and, depending on the IdP, reader groups. Readers provisioned through SCIM show an SSO-SCIM badge. In Document360, you can only manage their content access. To learn more, read SCIM provisioning.

Readers always get read-only access. The Default role in an SSO configuration applies to users only, not to readers.


Considerations

Limit Detail
New SSO configurations The Auto-register SSO readers toggle is hidden on new SSO configurations. It appears only on existing ones.
SCIM provisioning Auto-register SSO readers and SCIM provisioning can't both be active on the same SSO configuration. If SCIM provisioning is turned on, use SCIM group sync to control which reader groups new SSO readers join. To use Auto-register SSO readers instead, contact Document360 support to have SCIM disabled for your project first.
When assignment happens Readers are assigned to the selected groups when they sign in with SSO for the first time.
Reader access Readers always get read-only access, whatever the Default role setting.

Best practices

  • Assign the most restrictive reader group by default. You can grant more access to individual readers later, instead of granting too much access automatically at first sign-in.
  • If your project serves several audiences, create a separate reader group for each audience and set up auto assignment in each SSO configuration.
  • Review the auto-assigned reader groups regularly, especially after organizational changes in your IdP, to make sure they still match your access requirements.

Related articles


FAQ

Why don't I see the Auto-register SSO readers toggle?

The toggle appears only on existing SSO configurations. It’s hidden on new SSO configurations. It also can’t be active on an SSO configuration that uses SCIM provisioning. In that case, use SCIM group sync instead.

If your SSO configuration uses Google Workspace as its identity provider and the toggle is not visible even on an existing configuration, contact Document360 support. The toggle may need to be enabled by the Document360 team for Google Workspace configurations.

What access do auto-registered readers get?

Readers get read-only access to the content that their reader groups can view. The Default role in the SSO configuration applies only to users.

Does domain restriction apply to readers who sign in through SSO?

No. Domain restriction (Settings > Users and security > Readers & groups > Readers > Add domain) only controls self-registration: it allows or blocks specific email domains from creating their own reader account, and can optionally map a self-registered domain to a reader group. It has no effect on readers who sign in through an SSO configuration (SAML, OpenID Connect, or JWT).

If your readers authenticate through SSO and you want everyone from a given organization or domain to land in the correct reader group automatically, use one of the following instead:

  • Auto-register SSO readers: adds a reader to the reader groups you choose the first time they sign in through a specific SSO configuration. This is the right option when you are not using SCIM provisioning. See the "How to turn on auto-register SSO readers" section above.
  • SCIM group sync: if your identity provider supports SCIM (for example Okta or Microsoft Entra ID), turn on Enable group sync in the SCIM configuration so readers and reader groups are kept in sync with your IdP's own groups.

Auto-register SSO readers and SCIM group sync cannot both be active on the same SSO configuration.

Do SSO readers count toward my overall reader account limit, or is there a separate limit for SSO readers?

SSO readers count toward the same total reader account limit as all other reader types. There is no separate or additional allowance for readers who sign in through SSO. Your plan's reader account utilization, shown on the Readers and groups page, reflects the combined total of all reader accounts regardless of how they authenticate.