Single sign-on is turned on per organization. Contact support@script.it to turn it on.
What’s supported
- Any OpenID Connect provider, including Microsoft Entra ID, Okta, Google Workspace, Keycloak, and Auth0.
- A sign-in link for your members, which you can put behind a tile in your provider’s app portal.
- Roles from groups and workspaces from groups, read from the groups claim in the provider’s ID token.
- A maximum sign-in age, after which members go back through your provider.
Before you start
You need Manage verified domains in the organization. Owners and Admins hold it by default. Register an application at your identity provider:- Set its redirect URI to the Redirect URI shown in Settings → Organization → Single sign-on.
- Make sure the ID token carries the
emailclaim. Without it, members can’t sign in. - To use group rules, add a claim that lists the member’s groups.
- Note the provider’s issuer URL, the client ID, and a client secret.
Connect your provider
1
Open single sign-on settings
Go to Settings → Organization with the organization active, and expand Single sign-on.
2
Fill in the form
3
Connect
Select Connect. Script.it checks the issuer before it saves anything.
4
Share the sign-in link
Copy Sign-in link for your members. It looks like
https://app.script.it/login?sso=acme. Send it to your members, or put it behind a tile in your provider’s app portal.How members sign in
Members open your sign-in link and sign in at your provider. If they’re already signed in there, it completes without a prompt.- New to Script.it? Their account is created, and they join your organization.
- Already have an account with the same email? If the email’s domain is one of your verified domains, the accounts are linked on the first try. Otherwise, Script.it asks them to sign in once the way they usually do, then links the accounts.
- Either way, signing in through your provider makes them a member of your organization, whatever their email domain. The organization opens as their active account.
Sign-in age and offboarding
A sign-in through your provider lasts as long as Sign-in valid for (hours) says. After that, Script.it sends the member back to your provider. An active member goes through without a prompt. A member you disabled at the provider is refused.Roles from groups
Under Roles from groups, map provider groups to organization roles. Each rule says: members of this group get this role. The role can be a built-in one or a custom role.- Order matters. A member gets the role of the first rule that names one of their groups. Move a rule up or down to change its priority.
- Everyone else sets the role for members no rule matches. Without it, they get Member.
- Rules apply at every sign-in, using the groups that sign-in carries. Editing the rules updates members right away, from the groups they had at their latest sign-in.
- A role given by hand wins. If you change a member’s role in the member list, the rules stop changing it. Choose From SSO groups in their role picker to hand them back to the rules.
- The Owner’s role never comes from the rules.
Workspaces from groups
Under Workspaces from groups, give provider groups access to workspaces. Each rule says: members of this group are an Editor or a Reader of this workspace.- Access is updated each time a member signs in.
- The rules only add and remove access they granted. Access someone gave by hand is never changed.
- A sign-in that carries no groups claim leaves access as it was. A claim that lists no groups removes the access rules gave.
- When you remove a rule, members keep the access until their next sign-in.
- A workspace never loses its last Editor because of a group change.
Where groups come from
You can change the groups claim later under the connection’s details. Members’ groups are read from the new claim at their next sign-in.
Remove single sign-on
Select Remove single sign-on under the connection’s details. Removing it:- Stops sign-in through your provider and frees the sign-in slug.
- Deletes the role and workspace rules.
- Withdraws the workspace access the rules granted, except where it’s a workspace’s last Editor.
- Leaves each member’s account, their membership, and the role they hold now.