Skip Headers
Oracle® Health Sciences WebSDM and Empirica Study Installation Instructions
Release 3.1.2.1 for Windows 2003/2008 Server
E40537-02
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

C Configure WebSDM for SSO

This section applies only to customers that plan to configure WebSDM for an SSO (Single Sign-On) environment.

This is optional functionality. Begin by reviewing the Configuring Single Sign-On for WebSDM/Empirica Study topic in the WebSDM/Empirica Study Help.

Before configuring WebSDM for SSO, you must install Oracle Access Manager (OAM) on a server and configure a Webgate agent. Contact Oracle for assistance.

C.1 Configure WebSDM SSO

  1. Navigate to <root>\Lincoln\apps\<instance>\webapps\web_root\WEB-INF\classes.

  2. Open website.properties and uncomment the two lines for required SSO properties:

    #sso.plugins=com.oracle.hsgbu.empirica.sso.EmpiricaSsoPlugin
    #sso.EmpiricaSsoPlugin.username.header=oam-remote-user
    
  3. Optionally, enter an SSO alternative logout URL. Uncomment this line and change the value of <oam_server> to the name for the fully qualified OAM server:

    #sso.EmpiricaSsoPlugin.logoutRedirectUrl= http://<oam_server>/oam/server/logout

    For example:

    sso.EmpiricaSsoPlugin.logoutRedirectUrl= http://myserver.com:14100/oam/server/logout

  4. Configure the session timeout to be longer than the SSO timeout.

    The default WebSDM session timeout is 30 minutes. Modify WEB-INF/web.xml and <sessiontimeout> to be longer than the SSO session timeout.

  5. Configure the WebSDM server for native login:

    1. Edit /Lincoln/apps/<instance>/conf/server.xml.

    2. Under <Service name="Catalina">, add

      <Connector address="127.0.0.1" port="8080" protocol="HTTP/1.1"
      connectionTimeout="20000" redirectPort="8443" />
      
    3. If the port 8080 is not available on the server, change the value of the port attribute to an available port.

  6. Restart the WebSDM service.

C.2 Validate WebSDM SSO

  1. Open a browser window and type the WebSDM URL.

  2. At the Login prompt, enter your SSO username and password.

    The WebSDM home page appears.

  3. On the WebSDM server, start a browser and enter the WebSDM URL using the port number for native login that you set in section C.1.

  4. At the WebSDM login prompt, enter a WebSDM username that is a Superuser and enter the password.

    The WebSDM home page appears.