Platform.sh is now Upsun. Click here to learn more
Upsun Fixed User Documentation

Single Sign-On (SSO)

Try Upsun for 15 days
After that, enjoy the same, game-changing Upsun features for less with the First Project Incentive!¹ A monthly $19 perk!
Activate your 15-day trial
¹Terms and conditions apply

Tier availability

This feature is available for Upsun Fixed Elite and Enterprise customers. Compare the Upsun Fixed tiers on our pricing page, or contact our Sales team for more information.

Upsun Fixed allows you to set up mandatory SSO with a third-party identity provider (IdP) for all your users.

Your SSO provider can be enabled for a specific email domain, for example @example.com. Every user with a matching email address needs to log in or register on Upsun Fixed using your SSO provider. Such users can’t use an alternative provider, or register a password, or change their email address.

Mitigation controls Anchor to this heading

If you deactivate a user on your identity provider, they can’t log in or register on Upsun Fixed.

If the user is already logged in to Upsun Fixed, they are automatically deactivated after their access token has expired (generally after 1 hour).

A deactivated user can no longer use SSH, Git, or other Upsun Fixed APIs.

Service users Anchor to this heading

If you have a service user with an email address under your SSO domain, such as machine-user@example.com, you can exclude that user from the SSO enforcement rule so they aren’t required to authenticate through your identity provider.

Please open a support ticket if you need to exclude a service user.

SSO providers Anchor to this heading

Google Anchor to this heading

Tier availability

This feature is available for Enterprise customers. Compare the tiers on our pricing page, or contact our sales team for more information.

Enforce your users to authenticate with Google. Please open a support ticket to enable Google SSO.

Issue with re-authenticating every 15 minutes Anchor to this heading

If your organization has Google SSO enabled on Upsun Fixed, you may be required to re-authenticate with Google every 15 minutes. This happens when Upsun Fixed doesn’t possess a valid refresh token from your Google account.

To resolve that, you need to:

  1. Go to https://myaccount.google.com/permissions and revoke the access from the Upsun Fixed application that has Access given to auth.api.platform.sh.
  2. Go to https://auth.upsun.com/auth/authorize/google?prompt=consent for the system to obtain a valid refresh token for your Google account.

OpenId Connect Anchor to this heading

Tier availability

This feature is available for Elite customers. Compare the tiers on our pricing page, or contact our sales team for more information.

Enforce your users to authenticate with your OpenID Connect provider, such as Okta, Azure Active Directory or Ping Identity. To enable SSO with your OpenID Connect provider, contact Support.