Configuring BMC Remedy Single Sign-On integration for BMC Digital Workplace Catalog

Task 1: Perform the pre-integration preparation tasks

1. Create a catalog administrator user with admin, myit admin, and myit super admin permissions on the ITSM server. 

2. To leverage and use the default BMC Digital Workplace Catalog system users, you must enable AR authentication for bypass while using any of the supported authentication systems.

3. Ensure you can access BMC Digital Workplace Catalog server from the command line as <BMC_DWP_USER>. Example: Demo

4. Obtain the following installation settings, used for the BMC Digital Workplace Catalog installation:

   Installation parameter	Description	Example
   installLocation	The location of the BMC Digital Workplace Catalog installation.	/opt/bmc/digitalworkplace
   tenant_domain_name	The tenant domain name configured for the BMC Digital Workplace Catalog.	calbro.com
   bmc_dwp_server_host_name	The fully qualified domain name or IP address of the server on which BMC Digital Workplace Catalog is installed	127.0.0.1

Now you can configure the BMC Digital Workplace Catalog server to authenticate through BMC Remedy SSO.

Task 2: Configure BMC Remedy Single Sign-On for integration with BMC Digital Workplace Catalog

To configure the authentication scheme to prepare for integration with BMC Digital Workplace Catalog:

1. Log onto the BMC Remedy SSO Administration Console.
2. Go to General > Advanced and set values based on the following example:

   • Cookie Name: Any arbitrary value.

   • Backchannel Service URL: The URL to access BMC Remedy SSO.

   

3. Go to Realm > General to confirm that the value of the Tenant field matches the tenant domain name configured for BMC Digital Workplace Catalog.

   

4. In the Application Domains field, add the domain of the BMC Digital Workplace Catalog server.

   Note

   You cannot use the same application domain in other realms.

5. Go to Realm > Authentication to confirm the AR Server Information settings.

6. Click Test.
   The success message will appear if the configuration is correct.

   

7. Save the configuration.

Task 3: Ensure that BMC Remedy SSO can find the BMC Digital Workplace Catalog installation

The rsso-agent-osgi.jar library expects the environment variable BMC_AR_SERVER_HOME to contain the BMC Digital Workplace Catalog installation location. The location variable is registered during installation or upgrade.

1. On the BMC Digital Workplace Catalog server, find the hidden ~/.bmc_profile file.
   The home directory represented by ~ should be owned by the user who starts the application.

2. Open the ~/.bmc_profile file in a text editor. The setting for the environment variable should be present.

   BMC_AR_SERVER_HOME="/opt/bmc/digitalworkplace"

3. If this location is incorrect, edit the location. The environment variable shall be set after you reboot the server.

Task 4: Configure the BMC Digital Workplace Catalog server for integration with Remedy SSO

1. Navigate to /opt/bmc/digitalworkplace/sb/configure_rsso/

2. Type ./configure_rsso.sh

3. You will be prompted to provide the following details:

   Prompt	Example
   Enter agent id Note: The agent-id value for BMC Digital Workplace Catalog and BMC Digital Workplace must match for the single logout functionality to work.	agent-dwpcatalog
   Enter SSO External URL	http://<RemedySSO_Server>:<Port>/rsso
   Enter SSO Service URL	http://<RemedySSO_Server>:<Port>/rsso
   Enter Tenant domain set in SSO Realm configuration	coke.com
   Enter the BMC Helix Digital Workplace Catalog system administrator login name	DWPCSaaSAdmin
   Password for BMC Helix Digital Workplace Catalog system administrator	***************
   Enter Tenant administrator login name	tenant_admin@coke.com
   Password for Tenant administrator	***************

4. Restart the  BMC Digital Workplace Catalog server.

   The following video (14:20) describes how to configure BMC Digital Workplace Catalog with BMC Remedy SSO.

    https://www.youtube.com/watch?v=K6T5MzQqGNM

5. (High availability) To configure additional BMC Digital Workplace Catalog servers to authenticate using BMC Remedy SSO as an ID provider, ensure that all the servers share the same values for the following settings:

   • sso-external-url
   • sso-service-url
   • agent-id

Task 5: To configure integrated applications to not require the tenant domain

BMC Digital Workplace Catalog by default requires end users to enter the tenant domain when logging in to BMC Digital Workplace Catalog.

• User login that requires a tenant domain has the following format <user login>@<domain.com>
• User login that does not require a tenant domain has the following login format - <user>

You can configure integrated applications not to require the tenant domain. Without this setting, applications require login requests in a format used by BMC Digital Workplace Catalog. With this setting, applications accept login requests that do not include a tenant domain.

Configure the following applications not to require the tenant domain:

Task 6: To configure logging to help troubleshoot issues with RSSO 

1. On the BMC Digital Workplace Catalog server, open /opt/bmc/dw/bin/arserverd.conf.
2. Copy the last jvm.option.xx parameter, and add it to the file.

3. Replace the xx value of the jvm.option.xx parameter with the "+1" value. In the following example, the previous line was 22:

   jvm.option.23=-Drsso.log.cfg.file=/opt/bmc/digitalworkplace/conf/rsso-log.cfg

4. Open /opt/bmc/digitalworkplace/conf/rsso-log.cfg, and make sure it has the following configuration:

   rsso.log.name.format=rs_Try.%g.log
   rsso.log.level=FINEST
   rsso.log.roll=10
   rsso.log.limit=5242880
   rsso.log.dir=/opt/bmc/digitalworkplace/db/

5. Open /opt/bmc/digitalworkplace/pluginsvr/log4j_pluginsvr.xml

6. Make the following changes to debug:

   <logger name="com.bmc.arsys.pluginsvr">
   <level value="debug" />
   </logger>
   ......
   <root>
   <priority value ="error" />
   <appender-ref ref="PluginLog" />
   </root>

7. Open the /opt/bmc/digitalworkplace/conf/logback_server.xml

   <logger name="com.bmc.rsso" level="DEBUG" additivity="false">
   <appender-ref ref="BUNDLE" />
   </logger>

8.  Restart the BMC Digital Workplace Catalog server.

9. Log in to the Mid tier tool as Demo.

10. Click on the AR System Administration Console, and go to Common Server Configuration > General > Plugin Server Configuration. 
11. Click OK through the warning messages that show up. 
12. Once the Plugin Server Configuration screen appears, click on the Plugin Server Configuration tab. 
13. Under the Logging Configuration, switch the Enable Plugin Log to True and the Log Level to Debug, and click Apply. 
14. Click OK through the warning messages that show up.

Task 7: To validate the integration between BMC Digital Workplace Catalog and Remedy Single Sign-On

Once you have carried out all the necessary steps, log in to BMC Digital Workplace Catalog and BMC Digital Workplace to ensure Remedy SSO has been installed and configured correctly. If it is correctly installed, you will be able to access both servers by logging in just once.