Folllow these instructions to allow your users to login to your Buildstash workspace using JumpCloud SSO.

This feature is currently only available to enterprise users. If you would like it activated on your workspace please contact support.

Create SSO Application in JumpCloud

1

Create custom SSO application

In your JumpCloud admin portal, navigate to “SSO Applications”, and select “Add New Application”.

Select “Custom Application”.

2

Configure custom SSO with OIDC

Then check “Manage Single Sign-On”, and select “Configure SSO with OIDC”.

3

Setup custom application name and info

Add “Buildstash” as the display label, and add a logo or preferred color to display to users.

4

Setup SSO URLs

Complete the “Redirect URI” and “Login URL” fields very carefully. They must exactly match.

The redirect URI must use your workspace’s custom subdomain. The format must be:

https://{SUBDOMAIN}.buildstash.com/jumpcloud/callback

You must set “Client Authentication Type” to “Client Secret Post”.

5

Set scopes

Select both “Email” and “Profile” user standard scopes.

You can then click “Activate”.

6

Copy client ID and secret

Copy the credentials presented. The secret will not be displayed again - so copy and store it securely, such as in a password manager.

7

Remember and set user access

The final step in JumpCloud is to ensure you grant the users you wish to have SSO to Buildstash access.

Configure SSO in Buildstash

1

Enable SSO provider

Go to your workspace settings, and under “Enterprise SSO”, select “Enable provider”.

2

Input provider credentials

Input the client ID and secret for JumpCloud you copied from a previous step.

3

Confirm correctly configured

Once details are entered and confirmed you’ll see “SSO configured with provider: JumpCloud”.

Select “Manage” to update credentials in future, disable non-SSO login, or remove JumpCloud as a login provider in future.

4

Login with SSO

You can now navigate to the login page on your workspace custom subdomain, and the JumpCloud SSO option will be presented.