Oracle^® Business Intelligence Enterprise Edition Deployment Guide > Implementing Single Sign-On Products With Oracle Business Intelligence > Enabling SSO Authentication for Oracle Business Intelligence >

Configuring Oracle BI Presentation Services to Operate in an SSO Environment

Perform the following configuration on all instances of Oracle BI Presentation Services in your deployment. Shut down the Oracle BI Presentation Services before making any changes.

The instanceconfig.xml file is located in the OracleBIData>\web\config directory. On Linux or UNIX, the file is located in OracleBI_HOME/OracleBIData/web/config.

To configure Oracle BI Presentation Services to Operate in an SSO environment

• Open instanceconfig.xml for editing. Locate the <Auth> element. If this does not exist, create this element, sub-elements and parameters as shown in the following example:

  <!-- other settings ... -->
     <Auth>
        <SSO enabled="true">
           <ParamList>
              <!--IMPERSONATE param is used to get the authenticated user's username and is required -->
              <Param name="IMPERSONATE"
                 source="serverVariable"
                 nameInSource="REMOTE_USER"/>
           </ParamList>
        </SSO>

In the preceding example, Oracle BI Presentation Services is directed to build a connection string containing the Impersonate parameter and to retrieve the value for this parameter using the server-side option. This is connection string will be used to establish a connection with Oracle BI Server on behalf of the authenticated user.

Additional parameters that are supplied by the SSO system (for example, locale) can be included in the connection string by setting param name attributes in the intstanceconfig.xml file for each of the parameters and specifying where Oracle BI Presentation Services must query the value of the parameter from. The possible attribute values for the source attribute are cookie, header and serverVariable.

For detailed examples, review the sample configuration files provided in the topic Sample Configuration Files.