This documentation supports the 18.08 version of Remedy Single Sign-On.

To view the latest version, select the version from the Product version menu.

Integrating Remedy SSO with BMC Discovery

This topic describes how to integrate Remedy Single Sign-On (Remedy SSO) with BMC Discovery.


Note

Integration with BMC Atrium Single Sign-On was deprecated in BMC Discovery 11.0 and was removed in BMC Discovery 11.3.

To integrate BMC Discovery with Remedy SSO, you must first configure the Remedy SSO server and then enable the integration. 


https://www.youtube.com/watch?v=tmER3CFf6ZI?rel=0


Before you begin


Before you begin integrating BMC Discovery with Remedy SSO, ensure that following considerations are in place:

Mandatory settings

Ensure that following settings are in place:

  • The minimum supported version of Remedy SSO is 9.1.01 and later, fully tested up to 20.02.00.

  • You must obtain a signed certificate from the Remedy SSO server and enable HTTPS on the BMC Discovery appliance.
  • The users to authenticate must be defined in an LDAP server. This is required to assign permissions to the user, based on the LDAP group that is mapped into a BMC Discovery group. This implies that the non-LDAP authentication methods that may use Remedy SSO are not supported by BMC Discovery. For example, a user locally defined in Remedy SSO cannot login into Discovery.
  • BMC Discovery and the Remedy SSO server must use the same LDAP server.
  • The BMC Discovery appliance and the Remedy SSO server must be in the same domain; for example, if your BMC Discovery domain name is discovery.calbro.com, your Remedy SSO domain name must be rsso.calbro.com, (not rsso.calbro-internal.com).
  • The BMC Discovery appliance must have a reservation in DNS and must be accessed using that DNS name; otherwise, the integration fails and the following message is displayed: Forbidden request! Goto url is wrong.
  • Contact your Remedy SSO administrator for the parameters required in the following procedure: RSSO Server URL, RSSO Realm ID, RSSO Agent ID, and RSSO Token revalidation period.


Considerations for configuring certificates

Communication between BMC Discovery and Remedy SSO can take place only over secured protocol (HTTPS). To enable communication by using HTTPS, you must obtain the HTTPS certificate from the Remedy SSO server. See Pinning an HTTPS certificate for more details.

You can supply a CA bundle that is trusted by your organization, pin the certificate downloaded from Remedy SSO, or use both.

A pinned certificate is more secure than a CA bundle; however, pinned certificates require more frequent renewal.

Note

We recommend that you use both a pinned certificate and a trusted CA bundle to verify the identity of the Remedy SSO server.

 Configuring the connection to Remedy SSO server

Before you configure the connection to the Remedy SSO server, ensure that the LDAP settings are configured and you are able to log in to the BMC Discovery appliance as an LDAP user with administrative privileges. After you activate the Remedy SSO integration, as an administrator, you can log in again and change the configuration, if required.To apply the Remedy SSO settings, you must perform following steps:

  1. On the main menu, click the Administration icon
  2. In the Security section, click Single Sign On

    By default, the Remedy SSO tab opens.

    On the Remedy SSO tab, enter the following parameters:


    Parameter nameDescription
    RSSO Server URL

    Enter the URL for the Remedy SSO server.

    Enter the URL for the Remedy SSO server. The Remedy SSO server URL must begin with https and have the same domain as the BMC Discovery appliance. For example, use discovery.calbro.com and rsso.calbro.com (not discovery.calbro.com and rsso.calbro-internal.com).


    RSSO Realm ID


    Contact your Remedy SSO administrator for the Realm ID.

    RSSO Agent ID

    Contact your Remedy SSO administrator for the Agent ID.

    RSSO Token revalidation period

    Enter the revalidation period in minutes. Contact your Remedy SSO administrator for more information.

    RSSO server timeoutEnter the server timeout in seconds. You need to monitor this parameter and accordingly increase or decrease the number of seconds required for the RSSO server to respond.
  3. Click Save.

Uploading a CA bundle

Note

We recommend that you upload a trusted CA bundle. Trusted CA bundles enable you to validate the Remedy SSO server certificate.

  1. In the Trusted CA section, click Choose File and select the CA bundle file from your local file system.
  2. Click Upload CA Bundle.
    The new certificate bundle is uploaded.

Pinning an HTTPS certificate 

The following section explains how to pin an HTTPS certificate:

  1. Download the HTTPS certificate by clicking Get certificate from server
    After the certificate is downloaded, details such as Fingerprint, Validity dates, and certificate content are displayed. 
  2. After the certificate is retrieved from the server and you have verified that it exactly matches the certificate on the Remedy SSO server, click the Pin certificate button. 

    Certificate pinning involves additional security measures of certificate checks. BMC Discovery administrator must check the channels through which the certificate is received. If the server certificate and the uploaded certificate are not identical, click Unpin Certificate and upload a valid certificate. 

After the configuration completes successfully, the Enable button becomes available. The HTTPS certificate validity is subject to a baseline check. A baseline alert is raised five days before the certificate expires.

For information about troubleshooting Remedy SSO configuration in BMC Discovery, see troubleshooting.

Enabling Remedy SSO Integration

To enable the Remedy SSO integration, click Enable.

Troubleshooting 


If you are unable to log in to BMC Discovery using Remedy SSO, use the local login URL to access the BMC Discovery UI and log in as a local user.

http://ip-address/ui/LocalLogin

Was this page helpful? Yes No Submitting... Thank you

Comments