Configuring SAML SSO for ManageEngine OpUtils

These steps will guide you through setting up the single sign-on (SSO) functionality between ADSelfService Plus and OpUtils.

Prerequisite

1. Ensure that the ADSelfService Plus server can be accessed through HTTPS Connection (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, then select OpUtils from the applications displayed.
Note: You can also find the OpUtils application from the search bar located in the left pane or the alphabet wise navigation option in the right pane.
4. On the OpUtils page, click IdP details in the top-right corner of the screen.

5. You can configure the identity provider(IDP) details by either uploading the metadata file or entering the details manually.
1. Uploading metadata file: Click the Download IdP Metadata link to download the metadata file to be uploaded during the configuration of OpUtils.
2. For manual configuration: In the pop-up that appears, copy the Login URL and Logout URL, then download the SSO certificate by clicking Download X.509 Certificate.

OpUtils (Service Provider) configuration steps

1. Log in to OpUtils with an administrator's credentials.
2. In the OpUtils portal,go to Settings > General Settings > Authentication.

3. Select the SAML tab under Authentication.
4. Navigate to the Service Provider Details section and copy the Entity ID and Assertion Consumer URL. These will be used in a later step.

5. The IdP details can be entered in two ways: By using the Metadata file or by manually entering the IdP details.

A. Using the Metadata file

1. Navigate to the Identity Provider Details section, and choose the Upload IdP metadata file radio button.
2. Enter ADSelfService Plus as the IdP Name, and select Email ID from the Name ID Format drop-down.
3. Upload the metadata file downloaded in step 5a of Prerequisite.
4. Click Save.
5. Click Test connection to test the connection.
6. Click Enable SAML SSO.


B. Manually entering the IdP details

1. Navigate to the Identity Provider Details section, then choose the Configure IDP information manually radio button.
2. Enter "ADSelfService Plus" as the Name, then select Email ID from the Name ID Format drop-down.
3. Paste the Login URL and Logout URL values copied in step 5b of Prerequisite in the IdP Login URL and IdP Logout URL fields, respectively.
Note: The Logout URL is optional and can be skipped if single logout (automatically log out from ADSelfService Plus when logging out from OpUtils) is not required.
4. Upload the X.509 certificate file downloaded in step 5b of Prerequisite in the IDP's Certificate field.
5. Click Save.
6. Click Test connection to test the connection.
7. Click Enable SAML SSO.

ADSelfService Plus (Identity Provider) configuration steps

1. Now, switch to the ADSelfService Plus OpUtils configuration page.
2. Enter the Application Name and Description.
3. Enter the Domain name of your OpUtils account. For example, if you use johndoe@thinktodaytech.com to log in to OpUtils, then thinktodaytech.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. Paste the Assertion Consumer URL copied in step 4 of OpUtils configuration steps in the Assertion Consumer URL field.
7. Paste the EntityID copied in step 4 of OpUtils configuration steps in the Entity ID field.
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 into OpUtils through the ADSelfService Plus portal.

Note: For OpUtils, both SP-initiated and IdP-initiated flows are supported.