Integrate Jumpcloud SSO with Ezeelogin

599 admin January 6, 2025 Features & Functionalities 2860

Configure Jumpcloud SSO SAML-based Authentication in Ezeelogin GUI.

Overview: This article describes the brief guide to configuring Jumpcloud SSO authentication with Ezeelogin GUI.

Note: SAML is an authentication mechanism for web applications. It's based on web protocols and it cannot be used for user authentication over SSH.

Step 1: Login to Jumpcloud and Add the Application

Step 2: Search for SAML 2.0

Step 3: Change the Display Label and save

Step 4: Select the configure tab and fill in the Application details and activate

IdP Entity ID - Entity ID ( you can find it from ezeelogin GU > Settings > SAML)
SP Entity ID -Entity ID ( you can find it from ezeelogin GU > Settings > SAML)
ACS (Consumer) URL - Assertion Consumer Service URL ( you can find it from ezeelogin GU > Settings > SAML)

Step 5: Select the SSO tab from the right panel & Copy the Metadata URL and paste it to Metadata URL on Ezeelogin GUI > Settings > SAML Metadata URL

Step 6: Click on the fetch button, it will auto-fill the SAML setting and SAVE it.

Step 8: Select the user group tab from the left panel, add the user group name, and save it.

Step 9: Add the user by selecting the users tab.

Step 10: Select the SSO applications from left panel and assign the user group to that application

Step 11: Change Web panel Authentication to SAML from Ezeelogin GUI > Settings > General >Authentication

Step 12: Enable Auto Create User from Ezeelogin GUI -> Settings -> General -> Security -> Enable Auto Create User

Step 13: Login to Ezeelogin GUI with SAML authentication.

Step 14: After logging into GUI, you need to reset the password and security code of the SAML user under Account -> Password in order to SSH to Ezsh shell.

Step 15: You can log in to Ezeelogin shell via Webssh shell or using any SSH client such as Putty or terminal etc.

WebSSH: Click on the 'Open Web SSH Console' icon to SSH via the browser

WebSSH terminal will open like below. Users can navigate the server group with the Up and Down arrow buttons and enter to login into the server.

Native SSH Client: After resetting the password and security code you can SSH to the Ezsh shell (using Terminal or Putty) with the SAML username.

Step 16: If you are SSH ing with 2FA enabled using Putty or Terminal it would prompt you to enter the 2FA codes, The 2FA step can be disabled for SAML Authentication under Settings > Two Factor Authentication> Skip Two Factor Authentication for SAML. The user will be able to ssh without being prompted for the 2FA codes only if the user is logged into the web panel, otherwise, if the user is not logged into the web panel it would prompt for the 2FA codes.

We recommend using the web ssh shell when you are using SAML authentication, which is a lot more convenient as you would not have to worry about the SSH password or the security code for the users.

Add a different email address for each user. By default, Ezeelogin uses email addresses for creating users.
If you want to add an existing user in Ezeelogin to SSO, Add the user with the exact username, and email address as follows. (Ezeelogin will verify with the email address of the users by default). Make sure to add the email address for the Ezeelogin Administrator user.
Saml authentication is not supported for slaves if the URL is IP-based. If you want to authenticate slave using saml you have to use the domain name.

Related Articles:

2 people found this article helpful what about you?