Configuring SAML SSO for ManageEngine ADManager Plus MSP

The following steps will help you enable single sign-on (SSO) to ADManager Plus MSP from ADSelfService Plus.

Prerequisites

1. Ensure that the ADSelfService Plus server can be accessed through an HTTPS connection (the Access URL must be configured as HTTPS).
2. Log in to ADSelfService Plus as an administrator.
3. Navigate to Configuration > Self-Service > Password Sync/Single Sign On > Add Application, and select ADManager Plus MSP from the applications displayed.

Note: You can also find ADManager Plus MSP from the search bar located in the left pane or the alphabet-wise navigation option in the right pane.

4. On the ADManager Plus MSP configuration page, click IdP Details in the top-right corner of the screen. A pop-up will appear.
5. You can configure the identity provider details in ADManager Plus MSP by either uploading the metadata file or entering the details manually.
   • Uploading the metadata file: Click the Download IdP Metadata link to download the metadata file to be uploaded during the configuration of ADManager Plus MSP.
   • For manual configuration: Copy the Entity ID, Login URL, and Logout URL, which will be used during the configuration of ADManager Plus MSP. Download the SSO certificate by clicking the Download X.509 Certificate link.

ADManager Plus MSP (service provider) configuration steps

1. Log in to ADManager Plus MSP with administrator credentials.
2. Navigate to Delegation > Configuration > Logon Settings > Single Sign-On.
3. Select the Enable Single Sign-on with Active Directory check box.

4. Choose the SAML Authentication radio button.
5. In the Configure Identity Provider section, enter the details given below.
   • In the Identity Provider (IdP) field, choose the Custom SAML option.
   • For SAML Config Mode, you can either choose the Upload Metadata File option or the Manual Configuration option.
   • If you choose the Upload Metadata File option, upload the metadata file downloaded in step 5a of the prerequisites.
   
   • If you choose the Manual Configuration option, paste the Entity ID value copied in step 5b of the prerequisites in the Issuer URL/Entity ID field.
   • In the IdP Login URL field, enter the Login URL value copied in step 5b of the prerequisites.
   • In the IdP Logout URL field, enter the Logout URL value copied in step 5b of the prerequisites.

   Note: The Logout URL is optional and can be skipped if single logout (automatically log out from ADSelfService Plus when logging out from ADManager Plus MSP) is not required.

   • Paste the entire contents of the X.509 certificate downloaded in step 5b of the prerequisites in the X509-Certificate field.

6. Copy the values of the ACS/Recipient URL and the Issuer URL/Entity ID from the Service Provider Details section; these will be used later.

7. Click Save.

ADSelfService Plus (identity provider) configuration steps

1. Switch to ADSelfService Plus' ADManager Plus MSP configuration page.
2. Enter the Application Name and Description.
3. Enter the Domain Name of your ADManager Plus MSP account. For example, if you use johndoe@admanagerplus.com to log in to ADManager Plus MSP, then admanagerplus.com is the domain name.
4. In the Assign Policies field, select the policies for which SSO needs to be enabled.

Note: ADSelfService Plus allows you to create OU- and group-based policies for your AD domains. To create a policy, go to Configuration > Self-Service > Policy Configuration > Add New Policy.

5. Select the SAML tab and check Enable Single Sign-On.
6. In the Assertion Consumer URL field, enter the ACS/Recipient URL copied in step 6 of ADManager Plus MSP configuration.
7. In the Entity ID field, enter the Issuer URL/Entity ID value copied in step 6 of ADManager Plus MSP configuration.
8. In the Name ID Format field, choose the format for the user login attribute value specific to the application.

Note: Use Unspecified as the default option if you are unsure about the format of the login attribute value used by the application.

9. Click Add Application.

Your users should now be able to sign in to ADManager Plus MSP through the ADSelfService Plus portal.

Note: For ADManager Plus MSP, both SP-initiated and IdP-initiated flows are supported.