Manage an SSO Connection
Update, enable, disable, or delete an existing Single Sign-On (SSO) connection.
About This Task
After you set up an SSO connection, you can change its settings, turn it on or off without deleting it, or remove it. Only organization admins can manage SSO connections.
Update an SSO Connection
- Go to Settings > Organization > SSO.
- Click the connection you want to update.
- Update the fields you want to change and click Save. If you leave the Client secret field empty while editing an OIDC connection, Haystack Platform keeps the previously stored secret.
- Use the toggle next to a connection to enable or disable it without deleting it.
Allow Sign-Up From Shared Links
By default, SSO signs in only people who are already members of your organization. If you share prototypes that require login, you can let people on your SSO domains sign themselves up through the shared link. This way, colleagues can try a prototype without you inviting each of them first.
Before you start, make sure the SSO connection is enabled and the prototype you share requires login.
- Go to Settings > Organization > SSO.
- Click the connection whose email domains you want to allow.
- Turn on Allow sign-up from shared links and click Save. People with an email address on this connection's domains can now sign up through login-required prototype links.
- To check, open a shared prototype link in a private browser window and sign in with an account on one of those domains.
To turn the option on through the REST API, set allow_share_link_signup to true when you create or update the SSO connection. It defaults to false.
When the option is on, a visitor opens a login-required shared prototype link and signs in with your identity provider:
- If they're already a member with a role in the prototype's workspace, they sign in as themselves.
- If their email domain belongs to a connection with the option on, they join your organization as a member whose only role is
prototype_userin the prototype's workspace. They can use only the prototypes shared in that workspace. Because they're members with their own email address, per-user OAuth connections work for them. - If neither applies, they use the link as a visitor scoped to that link, as before.
Members who only have the prototype_user role don't see the app. For the permissions of the role, see User Roles and Permissions.
This option applies only to prototypes that require login. If a colleague still opens the link as a visitor, check that the connection is enabled, that Allow sign-up from shared links is on for the connection that covers their email domain, and that the prototype requires login. For how to configure a prototype, see Share a Pipeline Prototype.
Delete an SSO Connection
- Go to Settings > Organization > SSO.
- Find the connection you want to remove.
- Click Delete and confirm the action.
What To Do Next
Was this page helpful?