[Notification] We're upgrading the JumpCloud Support Center the week of September 30th.

Support Center

Single Sign On (SSO) with HipChat

Important: This article contains out-of-date information. For current application information, see Connecting Applications with JumpCloud Using Pre-Built Connectors.



Configure the JumpCloud SSO Application

  1. Access the JumpCloud Administrator Console at https://console.jumpcloud.com.
  2. Select Applications in the main navigation panel on the left side.
  3. Select + in the upper left, scroll or search for the application in the Configure New Application side panel and then select Configure.
  4. You can upload a service provider application's XML metadata file to populate SAML connector attributes for that application. The attributes populated by the metadata file may vary by the application. To apply a metadata file for the application you're connecting, click Upload Metadata. Navigate to the file you want to upload, then click Open. You'll see a confirmation of a successful upload. Be aware that if you upload more than one metadata file, you'll overwrite the attribute values applied in the previously uploaded file.
  5. In the IDP Entity ID field, enter https://YOURDOMAIN.TLD (e.g., https://thebestwidgets.com).
  6. Select Upload IdP Private Key and upload the private.pem file generated according to the above prerequisites.
  7. Select Upload IdP Certificate and upload the cert.pem file generated according to the above prerequisites.
  8. In the SP entity ID field, paste the Audience URL supplied by the Service provider.
  9. In the ACS URL field, paste the Recipient (ACS Consumer URL) supplied by the Service provider.
  10. In the field terminating the IDP URL, either leave the default value or enter a plain text string unique to this connector.
  11. (Optional) In the Display Label field, enter a label that will appear under the Service Provider logo within the JumpCloud User console.
  12. Select Activate.
  13. Select Export Metadata on the right-hand side of the page.

Configure the Service Provider

  1. Log in to the HipChat as an administrator.
  2. Go to User management > SAML.
  3. Select SAML single-sign on.
  4. In the Provider field, choose Custom SAML 2.0.
  5. Select select here to upload and upload the XML file exported in the steps above.
  6. All fields should be populated.
  7. Custom attributes should contain user.firstname, user.lastname, user.title. Do not change these values. Fill them in if they are missing.
  8. Allow both internal directory and SAML single sign-on is recommended until SAML workflow is validated to avoid accidental lockout.
  9. JIT and profile sync are optional HipChat settings, please refer to their documentation for usage.
  10. Select Save.

Validate SSO authentication workflows

IdP Initiated

  • Access the JumpCloud user console at https://console.jumpcloud.com.
  • Select the Service Provider icon.
  • This should automatically launch and login to the application.

SP Initiated

  • Navigate to your Service Provider application URL, select Log in with single sign-on
  • You will be redirected to log in to the JumpCloud User Portal.
  • If required, log into the JumpCloud User Console as the appropriate user.
  • The browser will be redirected back to the application and be automatically logged in.

Last Updated: Aug 20, 2019 09:47AM MDT

Related Articles
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found