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

Support Center

Single Sign On (SSO) with Rancher

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.
  3. Select the + in the upper left, scroll or search for the application in the 'Configure New Application' side panel, then select 'configure'.
  4. Optionally, enter Rancher for the Display Label. This label will appear under the Service Provider logo within the JumpCloud User Portal.
  5. 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.
  6. In the IDP Entity ID field, enter https://YOURDOMAIN.TLD (e.g., https://thebestwidgets.com).
  7. Select Upload IdP Private Key and upload the private.pem file generated according to the above prerequisites.
  8. Select Upload IdP Certificate and upload the cert.pem file generated according to the above prerequisites.
  9. In the SP Entity ID field, enter https://Rancher_Server/v1-saml/adfs/saml/metadata, where Rancher_Server matches with your Rancher Server.
Note: You can locate your Rancher Server in the Rancher application, when you configure your Identity Provider Account. Your server is listed in the Rancher API Host field.
  1. In the ACS URL field, enter https://Rancher_Server/v1-saml/adfs/saml/acs, where Rancher_Server is your Rancher Server.
  2. In the field terminating the IdP URL, either leave the default value or enter a plaintext string unique to this connector.
  3. Select Activate.

Configure the Service Provider

  1. From Global view's main menu, select Security > Authentication.
  2. Select Microsoft AD FS as your Identity Provider.
  3. Configure your Identity Provider Account. The form should have the following values:
  • Display Name Field: fullname
  • User Name Field: username
  • UID Field: uid
  • Group Field: memberOf
  • Rancher API Host: Your Rancher Server URL
  • Private Key/Certificate: Paste Private Key / Certificate here. You can obtain this from JumpCloud.
  • Metadata XML: Paste Metadata XML here. You can obtain this from JumpCloud.
  1. After you complete the form, click Authenticate.

You will get a confirmation after successfully connecting Rancher with JumpCloud that says, "Rancher is configured to work with your Identity Provider. Your users can now sign into Rancher using the login provided for your Identity Provider."

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.
  • You will be redirected to log in to the JumpCloud User Portal.
  • The browser will be redirected back to the application and be automatically logged in.


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

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