IBM TRIRIGA Application Platform Version 3 Release 4.1. Single Sign-On Setup User Guide



Similar documents
IBM TRIRIGA Anywhere Version 10 Release 4. Installing a development environment

Platform LSF Version 9 Release 1.2. Migrating on Windows SC

Tivoli Endpoint Manager for Security and Compliance Analytics. Setup Guide

IBM Security QRadar Version Installing QRadar with a Bootable USB Flash-drive Technical Note

IBM Endpoint Manager Version 9.2. Software Use Analysis Upgrading Guide

IBM Enterprise Marketing Management. Domain Name Options for

IBM TRIRIGA Version 10 Release 4.2. Inventory Management User Guide IBM

IBM Security QRadar Version (MR1) Checking the Integrity of Event and Flow Logs Technical Note

IBM Security QRadar Version (MR1) Replacing the SSL Certificate Technical Note

IBM Security SiteProtector System Migration Utility Guide

Installing and Configuring DB2 10, WebSphere Application Server v8 & Maximo Asset Management

IBM SmartCloud Analytics - Log Analysis. Anomaly App. Version 1.2

Linux. Managing security compliance

Sametime Version 9. Integration Guide. Integrating Sametime 9 with Domino 9, inotes 9, Connections 4.5, and WebSphere Portal

IBM Connections Plug-In for Microsoft Outlook Installation Help

IBM Configuring Rational Insight and later for Rational Asset Manager

Tivoli Endpoint Manager for Security and Compliance Analytics

Tivoli IBM Tivoli Monitoring for Transaction Performance

Release Notes. IBM Tivoli Identity Manager Oracle Database Adapter. Version First Edition (December 7, 2007)

Patch Management for Red Hat Enterprise Linux. User s Guide

Packet Capture Users Guide

Version 8.2. Tivoli Endpoint Manager for Asset Discovery User's Guide

Tivoli Endpoint Manager for Configuration Management. User s Guide

IBM Cognos Controller Version New Features Guide

Installing on Windows

Table 1 shows the LDAP server configuration required for configuring the federated repositories in the Tivoli Integrated Portal server.

IBM WebSphere Message Broker - Integrating Tivoli Federated Identity Manager

IBM Security SiteProtector System Configuring Firewalls for SiteProtector Traffic

IBM Endpoint Manager for Software Use Analysis Version 9 Release 0. Customizing the software catalog

IBM VisualAge for Java,Version3.5. Remote Access to Tool API

IBM TRIRIGA Application Platform Version Reporting: Creating Cross-Tab Reports in BIRT

Active Directory Synchronization with Lotus ADSync

IBM Security QRadar Version Common Ports Guide

Getting Started With IBM Cúram Universal Access Entry Edition

IBM Security QRadar Version (MR1) Configuring Custom Notifications Technical Note

IBM Tivoli Web Response Monitor

IBM Endpoint Manager. Security and Compliance Analytics Setup Guide

IBM Proventia Management SiteProtector. Configuring Firewalls for SiteProtector Traffic Version 2.0, Service Pack 8.1

OS Deployment V2.0. User s Guide

IBM Enterprise Marketing Management. Domain Name Options for

IBM Lotus Protector for Mail Encryption. User's Guide

IBM Security SiteProtector System Two-Factor Authentication API Guide

Tivoli Security Compliance Manager. Version 5.1 April, Collector and Message Reference Addendum

Remote Control Tivoli Endpoint Manager - TRC User's Guide

Implementing the End User Experience Monitoring Solution

IBM WebSphere Adapter for PeopleSoft Enterprise Quick Start Tutorials

Configuring Single Sign-On for Documentum Applications with RSA Access Manager Product Suite. Abstract

IBM Cognos Controller Version New Features Guide

IBM Cloud Orchestrator Content Pack for OpenLDAP and Microsoft Active Directory Version 2.0. Content Pack for OpenLDAP and Microsoft Active Directory

IBM Rational Rhapsody NoMagic Magicdraw: Integration Page 1/9. MagicDraw UML - IBM Rational Rhapsody. Integration

CA Spectrum and CA Embedded Entitlements Manager

CA Spectrum and CA Service Desk

Web Server Configuration Guide

IBM Lotus Protector for Mail Encryption

Endpoint Manager for Mobile Devices Setup Guide

Remote Support Proxy Installation and User's Guide

Enabling Kerberos SSO in IBM Cognos Express on Windows Server 2008

Deploying Business Objects Crystal Reports Server on IBM InfoSphere Balanced Warehouse C-Class Solution for Windows

Integration Guide. SafeNet Authentication Service. Oracle Secure Desktop Using SAS RADIUS OTP Authentication

IBM FileNet System Monitor FSM Event Integration Whitepaper SC

IBM Endpoint Manager Version 9.0. Patch Management for Red Hat Enterprise Linux User's Guide

IBM Enterprise Content Management Software Requirements

Reading multi-temperature data with Cúram SPMP Analytics

IBM SmartCloud Analytics - Log Analysis Version User's Guide

Lotus Sametime. FIPS Support for IBM Lotus Sametime 8.0. Version 8.0 SC

IBM FlashSystem. SNMP Guide

IBM Endpoint Manager for OS Deployment Windows Server OS provisioning using a Server Automation Plan

Software Usage Analysis Version 1.3

IBM BigFix Version 9.2. Patch for CentOS User's Guide IBM

Release 7.1 Installation Guide

IBM Client Security Solutions. Client Security User's Guide

IBM Lotus Protector for Mail Encryption

White Paper DEPLOYING WDK APPLICATIONS ON WEBLOGIC AND APACHE WEBSERVER CLUSTER CONFIGURED FOR HIGH AVAILABILITY AND LOAD BALANCE

Integrating ERP and CRM Applications with IBM WebSphere Cast Iron IBM Redbooks Solution Guide

IBM Security QRadar Version (MR1) Installing QRadar 7.1 Using a Bootable USB Flash-Drive Technical Note

Installing and using the webscurity webapp.secure client

Power Management. User s Guide. User s Guide

CA Unified Infrastructure Management Server

IBM Client Security Solutions. Password Manager Version 1.4 User s Guide

DEPLOYING EMC DOCUMENTUM BUSINESS ACTIVITY MONITOR SERVER ON IBM WEBSPHERE APPLICATION SERVER CLUSTER

Rational Developer for IBM i (RDI) Distance Learning hands-on Labs IBM Rational Developer for i. Maintain an ILE RPG application using

BMC Remedy Integration Guide

IBM Digital Analytics Enterprise Dashboard User's Guide

CA Nimsoft Service Desk

BusinessObjects Enterprise XI Release 2

TIBCO Spotfire Web Player 6.0. Installation and Configuration Manual

Continuous access to Read on Standby databases using Virtual IP addresses

IBM WEBSPHERE LOAD BALANCING SUPPORT FOR EMC DOCUMENTUM WDK/WEBTOP IN A CLUSTERED ENVIRONMENT

IBM Endpoint Manager Version 9.1. Patch Management for Mac OS X User's Guide

IBM Integration Designer Version 7 Release 5. Stock Quote Sample

Patch Management for Windows. User s Guide

IBM XIV Management Tools Version 4.7. Release Notes IBM

CA NetQoS Performance Center

PROXY SETUP WITH IIS USING URL REWRITE, APPLICATION REQUEST ROUTING AND WEB FARM FRAMEWORK OR APACHE HTTP SERVER FOR EMC DOCUMENTUM EROOM

CERTIFICATE-BASED SINGLE SIGN-ON FOR EMC MY DOCUMENTUM FOR MICROSOFT OUTLOOK USING CA SITEMINDER

Cúram Business Intelligence and Analytics Guide

SW5706 Application deployment problems

How To Enable A Websphere To Communicate With Ssl On An Ipad From Aaya One X Portal On A Pc Or Macbook Or Ipad (For Acedo) On A Network With A Password Protected (

Configuring and Integrating JMX

Disaster Recovery Procedures for Microsoft SQL 2000 and 2005 using N series

Transcription:

IBM TRIRIGA Application Platform Version 3 Release 4.1 Single Sign-On Setup User Guide

Note Before using this information and the product it supports, read the information in Notices on page 19. This edition applies to version 3, release 4, modification 1 of IBM TRIRIGA Application Platform and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2011, 2014. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents ABOUT THIS GUIDE... 1 Conventions...1 Intended Audience...1 Prerequisites...1 Support...1 1. INTRODUCTION... 2 2. CONFIGURING MICROSOFT IIS WITH IBM TRIRIGA (JBOSS)... 3 Setting up IIS...3 Configuring IIS...3 Troubleshooting...3 3. SETTING UP SSO WITH IIS... 5 Configuring IBM TRIRIGA and IIS...5 4. CONFIGURING APACHE WITH IBM TRIRIGA (JBOSS)... 7 5. SETTING UP SSO WITH APACHE... 8 6. SETTING UP SSO ON WEBLOGIC USING APACHE WITH ACTIVE DIRECTORY... 9 7. SETTING UP WEBSPHERE SSO WITH IBM HTTP SERVER USING LDAP... 12 IBM HTTP Server and WebSphere Plugin Installation...12 Setting up IBM HTTP Server for WebSphere...13 Setting up SSO...14 8. CONFIGURING IBM TRIRIGA WITH OTHER SSO SYSTEMS... 17

9. TROUBLESHOOTING AUTOMATIC LOG IN... 18 NOTICES... 19 Privacy Policy Considerations...20 Trademarks...20

About This Guide IBM TRIRIGA requires a user name and password to gain access to the applications. Many customers use single sign-on (SSO) to manage access by their users across the spectrum of applications in their environment. This guide describes how to set up SSO for the IBM TRIRIGA Application Platform. It includes steps to allow users to sign in to IBM TRIRIGA with an existing user name and password stored in Active Directory. Conventions This document uses the following conventions to ensure that it is as easy to read and understand as possible: Note A Note provides important information that you should know in addition to the standard details. Often, notes are used to make you aware of the results of actions. Tip A Tip adds insightful information that may help you use the system better. Attention An Attention notice indicates the possibility of damage to a program, device, system, or data. Intended Audience This guide is intended for users responsible for establishing and maintaining the security of their company s IBM TRIRIGA environment. Prerequisites This guide assumes the reader understands the IBM TRIRIGA Application Platform and is well versed in software security and the sign-on security of their company s environment. Support IBM Software Support provides assistance with product defects, answering FAQs, and performing rediscovery. View the IBM Software Support site at www.ibm.com/support. Copyright IBM Corporation 2011, 2014. 1

1. Introduction The information in this document guides you through configuring web servers with JBoss Application Server, and then configuring with Single Sign-On (SSO) with those servers. With SSO, your users can sign in to IBM TRIRIGA with existing user names and passwords stored in an Active Directory or LDAP Server. As noted in this document, SSO does not always result in a seamless sign on. Configuring IIS with SSO involves two steps: Configure the web server to pass web requests to JBoss. Set up SSO with the web server. This guide covers configuring IIS and Apache with JBoss. If you use WebSphere or Oracle WebLogic application servers, refer to the IBM or Oracle/BEA for documentation on setting up those application servers with your web server. Below is a diagram of an environment with a web server that proxies requests from end users to an application server. Example Environment The following identifies the flows in the example environment diagram above: Step 1 Users enter the web server URL in their browsers. Step 2 The web server challenges the browser for sign in information. It will either prompt the user for a username and password, or seamlessly pass it over. Step 3 The web server verifies the information with the directory server. Step 4 If the login was successful, the web server appends the user credentials to the HTTP header, and allows them to the application server. Step 5 The application server processes the user credentials and logs them into the application. Note Disable the http port on the application server after the web server configuration has completed. Copyright IBM Corporation 2011, 2014. 2

2. Configuring Microsoft IIS with IBM TRIRIGA (JBoss) Setting up IIS You can find information about how to set up IIS to cooperate with Tomcat at http://tomcat.apache.org/connectors-doc/webserver_howto/iis.html. Configuring IIS You can find information about how to configure IIS to cooperate with Tomcat at http://tomcat.apache.org/connectors-doc/reference/iis.html. Troubleshooting There are many places to check when troubleshooting the Jakarta Connector. If the sign in page does not display, check the following: Troubleshooting the Jakarta Connector Make sure to note down the location set in the.msi installer. The default the installer uses is: C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\ In this document, we change this to C:\Inetpub\Jakarta. Make sure the worker.properties file is in the correct config folder where the Jakarta Isapi Redirector is installed. Double check all the settings in: C:\Inetpub\Jakarta\conf\worker.properties The worker.properties file contains the configuration of the application server. C:\Inetpub\Jakarta\conf\uriworkermap.properties The uriworkermap.properties file contains the mapping from the Web root context directory to mount to the application server. We use the root / directory in this chapter. The registry contains keys for the isapi_redirect.dll, located at: HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0 This key is installed by the.msi installer. The worker_file key should point to the worker.properties file. Make sure the whole path and file name are entered correctly. The worker_mount_file points to the uriworkermap.properties. Make sure the whole path and file name are entered correctly. The isapi_redirect.dll will need permissions from the Web Service Extensions. Check the status column in the All Unknown ISAPI Extensions it should display Allowed. Copyright IBM Corporation 2011, 2014. 3

Troubleshooting the Jakarta Connector Make sure the application server can be reached from the IIS server on port 8009. To test this, click Start > Run, and enter: telnet <<APPSERVER>> <<PORT>> where <<APPSERVER>> is the hostname or IP address of the application server and <<PORT>> is the AJP Port (the default is 8009). The screen should go blank. If it returns an error in 10 seconds, the web server cannot connect to the application server. Consult your network administrator if a timeout occurs. If you configure the Jakarta virtual directory to run under a different Application Pool to its parent website, any requests to that directory will fail and you will see a 403 18 error in the IIS log files. Copyright IBM Corporation 2011, 2014. 4

3. Setting Up SSO with IIS Configuring IBM TRIRIGA and IIS After configuring IIS to pass web requests to JBoss, the next step is to set up SSO. Follow the steps below to set up SSO. To Configure IBM TRIRIGA and IIS Step 1 On the application server, modify TRIRIGAWEB.properties. This file should be located in the Tririga/config folder. Step 2 Set the following attributes: SSO=Y SSO_REMOTE_USER=Y SSO_REMOVE_DOMAIN_NAME=Y SSO_REQUEST_ATTRIBUTE_NAME=sm_user Note If the Active Directory contains usernames with inconsistent cases (for example, if IBM TRIRIGA users have been entered in lower case, and users in Active Directory are in mixed cases), use the following setting to turn off the case sensitive check upon login: USERNAME_CASE_SENSITIVE=N Note If you want to force users to log in through SSO, you must prevent them from using the default login page. Provide an alternative login page that does not contain a username, password, or login button. Use the following settings to specify the alternative login page and directory: ALTERNATE_INDEX_HTML=<indexFileName.html> ALTERNATE_RESOURCE_DIRECTORY=/<pathToTRIRIGA>/userfiles/ alt Step 3 Restart the application server to use the new settings. Step 4 On the IIS server, right-click My Computer and select Manage. Step 5 Expand Services and Applications. Select and expand Internet Information Services (IIS) Manager. Step 6 Under IIS, expand Web Sites. Step 7 Right-click Default Web Site. Select Properties. Step 8 In the Default Web Site Properties panel, select the Directory Security tab. In Authentication and access control, click Edit. Step 9 In the Authentication Methods panel, uncheck the box next to Enable anonymous access. Step 10 Check one of the boxes next to: Copyright IBM Corporation 2011, 2014. 5

To Configure IBM TRIRIGA and IIS Integrated Windows authentication Digest authentication for Windows domain servers Basic authentication (password is sent in clear text) Note If you do not know which one to set, do not choose all three. Try checking one at a time, restarting IIS after the change, and testing to see if the setting works correctly. The correct setting depends on your company s security setup. Step 11 Enter the domain name in Default Domain and Realm. The fields that are available depend on the check boxes selected in Authenticated access. Step 12 Click OK. Step 13 Click OK to override the AuthFlags property for the Jakarta Child Node. Step 14 Restart IIS and make sure JBoss has been restarted. Step 15 Make sure you have a login within IBM TRIRIGA that matches your domain login. For example, if your domain login is john.doe, the user name in the profile of the IBM TRIRIGA Employee record should be john.doe. Note Logins are case sensitive. Some logins in Active Directory are stored in mixed case. Step 16 Open your browser to http://<<webserver>>/ It should take you directly to IBM TRIRIGA. Copyright IBM Corporation 2011, 2014. 6

4. Configuring Apache with IBM TRIRIGA (JBoss) Note This process does not work with Apache 2.0. Apache 2.2 is required. This can be downloaded from apache.org or installed through the package manager on your Linux/UNIX distribution. To Configure Apache with IBM TRIRIGA (JBoss) Step 1 When running the installer, choose Custom Install, and install everything (including Build Headers and Libraries). Step 2 Create a new file called tririga.conf in the conf.d directory in the Apache install. Step 3 The contents of tririga.conf are as follows: ##################################################### LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_ajp_module modules/mod_proxy_ajp.so ProxyPass / ajp://appserver:8009/ ProxyPassReverse / ajp://appserver:8009/ ##################################################### Where APPSERVER is the hostname of your application server. Copyright IBM Corporation 2011, 2014. 7

5. Setting Up SSO with Apache To Set Up SSO with Apache Step 1 In the conf.d directory under the Apache install, create a new file named ldap.conf. Step 2 The contents of ldap.conf are as follows: ###################################################### LoadModule authnz_ldap_module modules/mod_authnz_ldap.so LoadModule ldap_module modules/mod_ldap.so <Location "/"> AuthBasicProvider ldap AuthType Basic AuthzLDAPAuthoritative off AuthName "TRIRIGA Active Directory Apache SSO" AuthLDAPURL "ldap://domaincontroler:389/dc=yourcompany,dc=com?samaccountname? sub?(objectclass=*)" NONE AuthLDAPBindDN "apache@yourcompany.com" AuthLDAPBindPassword "password for apache user" require valid-user </Location> ##################################################### Step 3 Change the underlined items to suit your Active Directory setup. Create a domain user called apache, whose password never expires. The purpose of this account is to do the initial bind to the LDAP/AD domain server to do the lookup for the end user. Copyright IBM Corporation 2011, 2014. 8

6. Setting Up SSO on WebLogic using Apache with Active Directory You can set up SSO on WebLogic using Apache front end with Active Directory to authenticate. You must first configure Apache to work with WebLogic and then configure SSO. Note These instructions use WebLogic 10.5.3 and Apache 2.2 on Solaris Intel 11. If you have trouble with the built-in version of Apache 2.2, copy it from http://httpd.apache.org/. Detailed instructions for configuring Apache 2.2 to point to WebLogic are available online at http://docs.oracle.com/cd/e13222_01/wls/docs81/plugins/apache.html. The following is a summary of the steps involved: To Configure Apache 2.2 to point to WebLogic Step 1 Copy the mod_wl_22.so from the plugin path (this varies for different OSes, refer to "Installing the Apache HTTP Server Plug-In" section) and paste it into the Apache modules folder ([apachehome]/modules). For Solaris Intel, the plugin path is WL_HOME/server/lib/solaris Step 2 Restart Apache by using the following command: /usr/local/apache2/bin/apachectl -k restart Step 3 Test Apache by going to the web server URL. For example, http://localhost/ After you configure Apache to point to WebLogic, you must set up SSO with Apache. This is very similar to the process for setting up SSO with JBoss, which was included in Section 5. Setting up SSO with Apache. You create an ldap.conf file in the conf/ folder with the code that is included below. You change the underlined text based on your Active Directory setup. The domain user called apache is used to do the initial bind to the LDAP/AD domain server. Use a user whose password never expires. The following is a step-by-step explanation. To set up SSO on Apache Step 1 In the conf.d directory under the Apache install, create a new file named ldap.conf. Step 2 The contents of ldap.conf are as follows. ###################################################### LoadModule authnz_ldap_module modules/mod_authnz_ldap.so LoadModule ldap_module modules/mod_ldap.so <Location "/"> AuthBasicProvider ldap AuthType Basic AuthzLDAPAuthoritative off AuthName "TRIRIGA Active Directory Apache SSO" AuthLDAPURL "ldap://domaincontroler:389/dc=yourcompany,dc=com?samaccountname? Copyright IBM Corporation 2011, 2014. 9

To set up SSO on Apache sub?(objectclass=*)" NONE AuthLDAPBindDN "apache@yourcompany.com" AuthLDAPBindPassword "password for apache user" require valid-user </Location> ##################################################### Step 3 Change the underlined items to suit your Active Directory setup. Create a domain user called apache, whose password never expires. The purpose of this account is to do the initial bind to the LDAP/AD domain server to do the lookup for the end user. Step 4 Update the TRIRIGAWEB.properties file with the following information and save. SSO=Y SSO_REMOTE_USER=Y SSO_REMOVE_DOMAIN_NAME=Y SSO_REQUEST_ATTRIBUTE_NAME=sm_user Note If you want to force users to log in through SSO, you must prevent them from using the default login page. Provide an alternative login page that does not contain a username, password, or login button. Use the following settings to specify the alternative login page and directory: ALTERNATE_INDEX_HTML=<indexFileName.html> ALTERNATE_RESOURCE_DIRECTORY=/<pathToTRIRIGA>/userfiles/ alt Step 5 Update the httpd.conf file by adding this line: Include conf/ldap.conf Step 6 Restart Apache and IBM TRIRIGA. After setting up SSO on Apache, you must also set it up on WebLogic. You can find additional instructions in the WebLogic Configuration & Active Directory Setup - Create a Service Principal Name (SPN) sections of http://java-hints.blogspot.com/2010/02/single-sign-on-sso-between-weblogic-and.html. Note These sections are necessary to set it up without certificates and trusts. Refer to the article for full instructions on setting up certificates and trust. The following is a step-by-step summary. To set up SSO on WebLogic Step 1 First you must disable HTTP authorization on WebLogic by following the steps in the following URL: https://forums.oracle.com/forums/thread.jspa?threadid=981500. An example path to config.xml is: //pathtoweblogic/user_projects/domains/servername/config/config.x ml Add the <enforce-valid-basic-auth-credentials> element to config.xml within the <security-configuration> element. <enforce-valid-basic-auth-credentials>false</enforce-valid-basicauth-credentials> Copyright IBM Corporation 2011, 2014. 10

To set up SSO on WebLogic </security-configuration> Step 2 Start or restart all of the servers in the domain. Step 3 Update the TRIRIGAWEB.properties file with the following information and save. SSO=Y SSO_REMOTE_USER=N SSO_USER_PRINCIPAL=N SSO_REMOVE_DOMAIN_NAME=N SSO_REQUEST_ATTRIBUTE_NAME=Proxy-Remote-User Copyright IBM Corporation 2011, 2014. 11

7. Setting Up WebSphere SSO with IBM HTTP Server using LDAP You can set up WebSphere SSO by using WebSphere and IBM HTTP Server by using LDAP. The software versions used for this guide are WebSphere 7 and IBM HTTP Server 7. These instructions are for AIX, but they should apply for other UNIX and Linux operating systems. This guide does not explain how to install WebSphere 7 but does include the steps in installing IBM HTTP Server, configuring it to forward requests to WebSphere, and configuring SSO. IBM HTTP Server and WebSphere Plugin Installation Two things are required to have IBM HTTP Server working with WebSphere: the IBM HTTP Server itself and the WebSphere web server plugin. The WebSphere Application Server package comes included with the IBM HTTP Server (IHS) and the web server plugin. The following notes will help with the installation: Install as a root user. IHS installation instructions can be found in the installation folder (readme > InstallGuide). Note: The installer requires X Windows. The web server plugin installation is part of the IBM HTTP Server installation; do not forget to install it. The install path is usually /opt/ibm/httpserver. After you finish installing IBM HTTP Server, configure the admin server in /opt/ibm/httpserver/conf/admin.conf. # Port used to access the Administration Server Listen @LISTENINGPORT@ # Default user and group settings for the server User @USER@ Group @GROUPNAME@ # ServerName gives the name and port that the server uses to identify # itself. This can often be determined automatically, but # specifying it explicitly can prevent problems during startup. # # If this is not set to a valid DNS name for your host, server-generated # redirections do not work. See also the UseCanonicalName directive. # # If your host does not have a registered DNS name, enter its IP # address. You must access it by its address anyway, and this makes # redirections work correctly. # ServerName hostname:@@adminport@@ Set the admin server login. For information, see http://pic.dhe.ibm.com/infocenter/wchelp/v7r0m0/index.jsp?topic=%2fcom.ibm.commerce.admi n.doc%2ftasks%2ftsewebibm.htm Switch to the HTTPServer_installdir/bin directory on your machine. In Aix, Linux, or Solaris, type the following command:./htpasswd -b../conf/admin.passwd user password After you finish installing IBM HTTP Server, start the web server admin by using the following commands. Copyright IBM Corporation 2011, 2014. 12

<ibm_http_server_path>/bin/adminctl start <ibm_http_server_path>/bin/apachectl start Setting up IBM HTTP Server for WebSphere The following guide describes how to forward requests from the IBM HTTP Server to WebSphere: http://thysmichels.com/2011/02/19/setup-ibm-http-server-for-websphere-application-server-v7/ The following steps describe one example of the process. To Set Up IBM HTTP Server for WebSphere Step 1 Navigate to Server > Server Types > Web Server > New and complete the form. Step 2 Select a Web server template. Copyright IBM Corporation 2011, 2014. 13

To Set Up IBM HTTP Server for WebSphere Step 3 Specify a user name and password and confirm that all auto-completed fields are correct. Step 4 Start the HTTP Server and HTTP Server Administration Services if not started. You can use the following commands. <ibm_http_server_path>/bin/adminctl start <ibm_http_server_path>/bin/apachectl start Step 5 Confirm that the Web Server has started successfully, which is indicated by the green arrow image in the Status column of the Web servers page. Step 6 Select the web server and click Generate Plug-in. Step 7 Select the web server and click Propagate Plug-in. Step 8 Test the web server. Pop up a browser tab and go to the web server URL (for example, http://localhost/) and verify that it works. Setting up SSO You can use the following steps to set up SSO for WebSphere with IBM HTTP Server. Copyright IBM Corporation 2011, 2014. 14

To Set Up SSO for WebSphere with IBM HTTP Server Step 1 On the IBM HTTP Server, in the conf/ directory under the Apache install, create a file named ldap.conf that contains the following code. Change the underlined items for your Active Directory setup. <Location "/"> AuthBasicProvider ldap AuthType Basic AuthzLDAPAuthoritative Off AuthName "TRIRIGA Active Directory Apache SSO" AuthLDAPURL "ldap://domaincontroller:389/cn=users,dc=yourcompany,dc=com?samac countname?sub?(objectclass=*)" NONE AuthLDAPBindDN "apache@yourcompany.com" AuthLDAPBindPassword "password for apache user" require valid-user </Location> Step 2 Create a domain user named apache, with a password that never expires. The purpose of this account is to do the initial bind to the LDAP/AD domain server to do the lookup for the end user. Step 3 Update the TRIRIGAWEB.properties file with the following information and save. SSO=Y SSO_REMOTE_USER=Y SSO_REMOVE_DOMAIN_NAME=Y SSO_REQUEST_ATTRIBUTE_NAME=sm_user Note If you want to force users to log in through SSO, you must prevent them from using the default login page. Provide an alternative login page that does not contain a username, password, or login button. Use the following settings to specify the alternative login page and directory: ALTERNATE_INDEX_HTML=<indexFileName.html> ALTERNATE_RESOURCE_DIRECTORY=/<pathToTRIRIGA>/userfiles/ alt Step 4 Update the httpd.conf file by adding the following lines. LoadModule was_ap22_module /pathtowebsphereplugins/plugins/bin/[32bit or 64bit folder]/mod_was_ap22_http.so WebSpherePluginConfig /pathtowebsphereplugins/plugins/config/[nameofconfiguredwebserver ]/plugin-cfg.xml Include conf/ldap.conf Step 5 Restart the IBM HTTP Server from the WebSphere Console. Step 6 In the WebSphere Console, clear the Enable application security check box. Copyright IBM Corporation 2011, 2014. 15

To Set Up SSO for WebSphere with IBM HTTP Server Step 7 In the WebSphere Console, in the Session Management configuration, clear the Security integration check box. Restart WebSphere if you made any changes. Copyright IBM Corporation 2011, 2014. 16

8. Configuring IBM TRIRIGA with Other SSO Systems IBM TRIRIGA can be used with other SSO systems that conform to one of three different mechanisms to deliver the username to the Application Server through the HTTP request header. There are five properties in TRIRIGAWEB.properties that control the IBM TRIRIGA SSO integration: SSO [Y N] - Turns the SSO integration on or off. SSO_REMOTE_USER [Y N] - If SSO is set to Y, setting this to Y will take the username from the request.getremoteuser() call in the IBM TRIRIGA Application Platform. SSO_REMOVE_DOMAIN_NAME [Y N] - Set this to Y if domain names are prefixed or appended with the domain name, and the usernames within IBM TRIRIGA only have the username. If the IBM TRIRIGA usernames have both the domain and the username, then set this to N. SSO_REQUEST_ATTRIBUTE_NAME [sm_user <<system-defined>>] - If the username is stored in a distinct HTTP attribute variable, set SSO_REMOTE_USER to N, and set this to the name of the HTTP attribute name. For example, CA Site Minder defaults the username to sm_user. Some systems enable you to define the variable name the username is in. In this case, set SSO_REQUEST_ATTRIBUTE_NAME to the variable name in your system. SSO_USER_PRINCIPAL [Y N ] - If the system is configured to append the UPN (User Principal Name) to the HTTP header, set this to Y, and set SSO_REMOTE_USER to N. This causes the IBM TRIRIGA Application Platform to retrieve the username from the call request.getuserprincipal().getname(). Note Some Java Applets prompt for the Windows user name and password. This is a known security issue with the Java Plugin and SSO. Affected applets may include: Gantt, Association Viewer, and Workflow Expression Editor. Enter the SSO user name and password again to gain access to these applets. Note IBM TRIRIGA CAD Integrator/Publisher requires Basic Authentication to be enabled to work properly with SSO. Copyright IBM Corporation 2011, 2014. 17

9. Troubleshooting Automatic Log In If you are having an issue with automatically logging in, check the following: Troubleshooting Automatic Log In If you see the error Invalid User name or Password, make sure the SSO settings in the TRIRIGAWEB.properties have been set and JBoss has been restarted. The user name is case sensitive within IBM TRIRIGA. To see the actual user name that is passed to IBM TRIRIGA by IIS, point your browser to http://<<webserver>/html/en/default/admin/requesttest.jsp. The user name shows in the Request Parameters section or in the Header Parameters section next to getuserprincipal, or in both places. Copyright IBM Corporation 2011, 2014. 18

Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. Privacy Policy Considerations IBM Software products, including software as service solutions, ( Software Offerings ) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering s use of cookies is set forth below. This Software Offering does not use cookies or other technologies to collect personally identifiable information. If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent. For more information about the use of various technologies, including cookies, for these purposes, see IBM s Privacy Policy at www.ibm.com/privacy and IBM's Online Privacy Statement at www.ibm.com/privacy/details in the section entitled Cookies, Web Beacons and Other Technologies and the "IBM Software Products and Software-as-a-Service Privacy Statement" at www.ibm.com/software/info/product-privacy/. Trademarks IBM, the IBM logo, ibm.com, TRIRIGA, and WebSphere are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and

service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. Java and all Java-based trademarks and logos are trademarks or registered trademarks or Oracle and/or its affiliates. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States, other countries, or both.