Configuring SAML SSO for ManageEngine ADManager Plus

The following steps will help you enable single sign-on (SSO) to ADManager Plus 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 from the applications displayed.

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

4. On the ADManager Plus 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 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.
   • For manual configuration: Copy the Entity ID, Login URL, and Logout URL, which will be used during the configuration of ADManager Plus. Download the SSO certificate by clicking the Download X.509 Certificate link.

ADManager Plus (service provider) configuration steps

1. Log in to ADManager Plus 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) 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 configuration page.
2. Enter the Application Name and Description.
3. Enter the Domain Name of your ADManager Plus account. For example, if you use johndoe@admanagerplus.com to log in to ADManager Plus, 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 configuration.
7. In the Entity ID field, enter the Issuer URL/Entity ID value copied in step 6 of ADManager Plus configuration.
8. In the Name ID Format field, choose the format for the user login attribute value specific to the application.

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 through the ADSelfService Plus portal.

Note: For ADManager Plus, both service-provider-initiated and identity-provider-initiated flows are supported.