SAML SSO Setup for JumpCloud

Allow your users to login to Localize using JumpCloud as the Identity Provider

With SAML SSO for JumpCloud, your users will be able to login with their JumpCloud login, simplifying and securing their login to the Localize dashboard.

Click here for a general overview of the SAML SSO setup and login processes.

Setting up SAML SSO

The setup is similar for different IdPs. Below we provide the detailed steps for setting up a SAML SSO application using JumpCloud.

Step 1: Enable SAML SSO in Localize

First you'll need to enable the use of SAML SSO across your Localize Organization.

  1. Navigate to the Settings page under the Manage Organization menu item.
  2. Check the box next to Enable SAML SSO
1370

This will display important information for Localize as the Service Provider (SP). You'll use this info later in the process.

Step 2: Create your SAML Application in JumpCloud

Next you'll need to use the information provided by Localize in the SSO Settings panel to create and set up your SAML application in JumpCloud.

  1. Open a new browser tab and login as an administrator to the JumpCloud Admin Portal
  2. Choose Applications from side menu
  3. Click the + button and choose Custom SAML APP at the bottom of the right side popup that appears.
  4. In the page that appears, under Details -> General Info -> Display Label enter a name for the app.
  5. Under Single Sign-On Configuration, enter the following information by copying-and-pasting from the Localize tab.
FieldValueDescription
Identifier (Entity ID)Localize-SSOThe unique Localize SP entity ID.
ACS URL(Copy and paste from the Localize settings page)The Localize endpoint that's responsible for receiving and parsing your SAML assertion.
Sign on URLhttps://app.localizejs.comThe URL at Localize that starts the SAML login process.
  1. Also set the following values:
FieldValue
SAMLSubject NameIDemail
SAMLSubject NameID Formaturn:oasis:names:tc:SAML:2.0:nameid-format:emailAddress
Signature AlgorithmRSA-SHA256
IdP-Initiated URL (optional)https://app.localizejs.com
IdP URLModify it or leave it as default value
  1. Click Save
  2. After saving, click on the application created, click Export Metadata.
    a. Download the file and name it metadata.xml.
  3. Copy the IdP URL

Step 3: Enter the IdP Details in Localize

  1. Switch to the Localize browser tab
  2. Paste the IdP URL endpoint into the IdP URL field.
  3. Open the metadata.xml file that you downloaded, copy the contents, and paste them into the Metadata text box.
  4. Click Save

Step 4: Configuring Users

  1. Switch back to the JumpCloud browser tab.
  2. Click Groups in the left side menu
  3. Click + and create a group that can access Localize
  4. Click on Applications in the left side menu.
  5. Select the application you just created above.
  6. In the User Groups section enable the user group you just created.
  7. Click Save
  8. Click Users in the left side menu
  9. For each user you want to add to the new group, select the user and add them to the new group.
    a. Make sure that the email addresses your users use to sign in to Localize match the email addresses they use to sign into JumpCloud.
  10. Click Save User after adding each user to the group.