Use JumpCloud SAML Single Sign On (SSO) to give your users convenient but secure access to all their web applications with a single set of credentials.
Read this article to learn how to configure SSO with MDM Automated Enrollment.
Prerequisites
- A JumpCloud administrator account.
- An organization administrator account for your MDM provider.
Configuring the SSO Integration
To configure JumpCloud
- Log in to the JumpCloud Administrator Portal.
- Go to USER AUTHENTICATION > SSO.
- Click + Add New Application, then select the Custom SAML App.
- Enter a Display Label in the General Info tab. Optionally, you can enter a description and adjust the logo shown for the application.
- Select the SSO tab.
- For IDP Entity ID, enter https://YOURDOMAIN.TLD (e.g., https://thebestwidgets.com).
- For SP Entity ID, enter the value provided by the MDM web application.
Some web apps refer to this as the SAML audience.
- For the ACS URL, enter the value provided by the MDM web application.
Some web apps refer to this as the Consumer URL.
- Add any desired attributes.
- Click activate then continue.
To configure the Automated Enrollment Authentication Settings
The settings in your MDM provider may differ. Use the following instructions as a reference.
- Log in to the MDM web application as an Organization Admin.
- Navigate to your enrollment configuration settings and search for authentication settings.
- Under Identity Provider Settings, link the web app to JumpCloud.
- If prompted, the SAML target URL on the MDM web app should match the IDP URL that’s provided in the JumpCloud configuration.
- If prompted, the X.509 fingerprint or certificate on the MDM web app should match the public certificate that’s created after activating the JumpCloud Custom SAML Application. To find and upload the certificate:
- In the JumpCloud Administrator Portal, navigate to USER AUTHENTICAION > SSO.
- Select the custom SAML application, then click IDP Certificate Valid.
- Click Download certificate.
- Upload the file or copy and paste the certificate into the related field.
The certificate.pem will download to your local Downloads folder.
- Each MDM vendor differs in the steps required to complete a configuration. Complete any additional steps, then save the configuration.
Authorizing User SSO Access
Users are implicitly denied access to applications. After you connect an application to JumpCloud, you need to authorize user access to that application. You can authorize user access from the Application Configuration panel or from the Groups Configuration panel.
To authorize user access from the Application Configuration panel
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications, then select the application to which you want to authorize user access.
- Select the User Groups tab. If you need to create a new group of users, see Get Started: User Groups.
- Select the check box next to the group of users you want to give access.
- Click save.
To learn how to authorize user access from the Groups Configuration panel, see Authorize Users to an SSO Application.
Removing the SSO Integration
These are steps for removing the integration in JumpCloud. Consult your SP's documentation for any additional steps needed to remove the integration in the SP. Failure to remove the integration successfully for both the SP and JumpCloud may result in users losing access to the application.
To deactivate the SSO Integration
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to deactivate and click to open its details panel.
- Select the SSO tab.
- Scroll to the bottom of the configuration.
- Click Deactivate SSO.
- Click save.
- If successful, you will receive a confirmation message.
To delete the application
- Log in to the JumpCloud Admin Portal.
- Go to USER AUTHENTICATION > SSO Applications.
- Search for the application that you’d like to delete.
- Check the box next to the application to select it.
- Click Delete.
- Enter the number of the applications you are deleting
- Click Delete Application.
- If successful, you will see an application deletion confirmation notification.