Configuring BMC Digital Workplace for Remedy Single Sign-On
Remedy Single Sign-On (Remedy SSO) is an authentication system for a multi software environment that enables users to present credentials for authentication only once. After Remedy SSO authenticates the users, they can gain access to any other application with automatic authentication without providing the credentials again.
Remedy SSO supports the following authentication methods:
- BMC Remedy AR System Server
- Kerberos (Starting from version 9.1.01)
- Certificate-based (Starting from version 9.1.01)
- Remedy SSO authentication or Local authentication (Starting from version 9.1.02)
- OAuth 2.0 (Starting from version 9.1.04)
- OpenID Connect (Starting from version 9.1.04)
This topic describes how to configure the integration of Remedy Single Sign-On with BMC Digital Workplace.
Based on your organization’s requirement, you can configure any of the authentication methods to authenticate the users for various BMC applications.
As an administrator you can integrate Remedy SSO with BMC Digital Workplace. After the integration, you can configure the required protocol for authentication. BMC does not support the Kerberos authentication for mobile apps, but you can configure the Kerberos authentication for web apps.
Remedy Single Sign-On authentication applies to both the universal client and to mobile applications. When a user logs in to on a mobile device, the user is prompted to enter the host name and port. If the server has SSO enabled, the mobile client opens a browser to the SSO login page. The SSO server sets the SSO cookies after authentication on to the device browser. When the user relaunches the application, if the cookies are not expired, the mobile client displays the application. If the cookies are expired, the user is shown the login page again for authentication.
Before you begin
- Install Remedy Single Sign-On and configure realms. For more information, see the online documentation.
- Install BMC Digital Workplace.
- Verify that access to the Remedy SSO servers and the BMC Digital Workplace server requires the same domain. Otherwise, deploying the Remedy Single Sign-On agent will not work.
- Create the rsso-agent.properties file.
To integrate Remedy SSO with BMC Digital Workplace
For clusters, complete the following procedure for each BMC Digital Workplace server.
- Start the DWPTomcat service.
- Make sure single sign-on integration is enabled on BMC Digital Workplace database table.
To enable the integration, set SAML_authentication to True.
Edit the set_env.bat (Windows) or set_env.sh (Linux) and set SAML_authentication to True.
Run this SQL query to update the value:
UPDATE DWP_System.TENANT SET SAML_AUTHENTICATION = 1 where SAML_AUTHENTICATION = 0
- Stop the DWPTomcat service.
- Copy the following JARs from installer/Disk1/files/rsso-agent/ into tomcat/external-conf/lib folder:
- Copy the following properties files from installer/Disk1/files/rsso-agent/ into tomcat/external-conf folder:
rsso-agent.properties—modify this file manually to point to correct and new RSSO server that is compatible with the sso sdk.
The configuration in rsso-agent.properties is similar to Mid Tier integration, except
The value of the agent-id property in rsso-agent.properties file should be a unique identifier, but should be same on all nodes in a BMC Digital Workplace cluster. It is recommended that you set its value to a simple identifier instead of a HTTP URL. For example,
For more information, see in the Remedy SSO online documentation.
Restart the Tomcat service.