Enabling SSO in Oracle Commerce V11

Once you have setup and configured your ATG server instances using the CIM tool, you are
ready to enable SSO to automatically sign-in the user from BCC to Workbench (bypassing
the login/password prompt).

By default below entries can be found in the webstudio.properties file found in

the C:\Endeca\ToolsAndFrameworks_1\11.0.0\server\workspace\conf folder.

NOTE Access the Endeca Administrators Guide to get additional details or step-by-step
instructions at this link

BEFORE

The default endeca v11 installation sets the com.endeca.webstudio.useSSO = false and rest of
the properties are commented without any value for host and port.

# Commerce SSO Authentication

com.endeca.webstudio.useSSO=false
#com.endeca.webstudio.sso.loginURL=http://<SSO HOST:PORT>/sso/login
#com.endeca.webstudio.sso.controlURL=http://<SSO HOST:PORT>/sso/control
#com.endeca.webstudio.sso.logoutURL=http://<SSO HOST:PORT>/sso/logout
#com.endeca.webstudio.sso.validationURL=http://<SSO HOST:PORT>/sso/validate
#com.endeca.webstudio.sso.keepAliveURL=http://<SSO HOST:PORT>/sso/keepAlive
#com.endeca.webstudio.sso.keepAliveFrequency=1800

AFTER THE CHANGES

After you are done with the installation and configuration of ATG SSO server instance, you
would know the port @ which the SSO server is available. In my case, it is available on
http://localhost:7303 (per below).

You need to make 2 changes

1. set the value for com.endeca.webstudio.useSSO=true

2. assign the host & port values for each of the URLs

# Commerce SSO Authentication

com.endeca.webstudio.useSSO=true
com.endeca.webstudio.sso.loginURL=http://localhost:7303/sso/login
com.endeca.webstudio.sso.controlURL=http://localhost:7303/sso/control
com.endeca.webstudio.sso.logoutURL=http://localhost:7303/sso/logout
com.endeca.webstudio.sso.validationURL=http://localhost:7303/sso/validate
com.endeca.webstudio.sso.keepAliveURL=http://localhost:7303/sso/keepAlive
com.endeca.webstudio.sso.keepAliveFrequency=1800
After integrating Workbench with Commerce SSO, you must match your set of Workbench
user profiles to those in the ATG internal profile repository. You can do so by selecting the
new Commerce setting under the Source options in the Create User dialog.

The Commerce SSO server uses the ATG internal profile repository on the publishing server
as the system of record for user information. It does not automatically publish changes to
Workbench user profiles.

To enable SSO functionality you must maintain a set of Commerce type Workbench users
parallel to those in the ATG internal profile repository. Each ATG user profile must have a
corresponding Workbench user with the same name.

Experience Manager Link in BCC

n the previous post, we looked @ how to enable Oracle Commerce SSO from BCC to
Workbench, which facilitated us to launch the Workbench from the BCC menu item.

In this post, Ill walk you through the process of adding the BCC (Business Control Center)
menu item within the Endeca Workbench.

You will need to make changes to 2 files

under C:\Endeca\ToolsAndFrameworks_1\11.0.0\server\workspace\conf folder:

1. ws-mainmenu.xml
 2. ws-extensions.xml

Below are the lines of code you need to add/change to respective files:

WS-MAINMENU.XML

<mainmenu xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xsi:noNamespaceSchemaLocation=mainMenu.xsd>

<!
~ For more information on configuring the Workbench menu, see
~ the Oracle Commerce Workbench Administrators Guide.
>
<menuitem id=xmgr/>
<menuitem id=bcc-home/>
<menunode id=user-access>
<menuitem id=user-management/>
<menuitem id=bcc-access-control/>
</menunode>
<menuitem id=eac-admin-console/>
<menuitem id=eac-settings/>
<menunode id=reports>
<menuitem id=reports.today/>
<menuitem id=reports.daily/>
<menuitem id=reports.weekly/>
</menunode>
<menunode id=search>
<menuitem id=redirects/>
<menuitem id=thesaurus/>
<menuitem id=phrases />
<menuitem id=relrank />
</menunode>
<menunode id=settings>
<menuitem id=user-segments/>
<menuitem id=preview-settings/>
<menuitem id=report-settings/>
<menuitem id=locks/>
</menunode>
</mainmenu>

WS-EXTENSIONS.XML

<extensions xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xsi:noNamespaceSchemaLocation=extensions.xsd>
<!
~ The following extension is provided as an example. For more information,
~ see the Oracle Commerce Workbench Administrators Guide.
~
~ The defaultName, defaultDescription, and defaultIcon values are only used
~ if equivalent attributes are not specified in the resource property files
~ in the conf/locales folder. For example, if you do not specify an
~ extension name for French locales in those resource property files,
~ then the defaultName value is used.

<extension id=testExtension
defaultName=Test Extension
defaultDescription=Demonstrates extensions with tokens.
defaultIcon=http:://www.example.com/sample-tool_icon.png
url=http://www.example.com:8989/TestExtension/index.jsp?eac-host=$
{EAC_HOST}&amp;eac-port=${EAC_PORT}&amp;eac-app=${EAC_APP}>
</extension>
>
<extension id=bcc-home defaultName=BCC defaultDescription =BCC
url=http://localhost:7003/atg/bcc
externalURL=true/>

<extension id=bcc-access-control
defaultName=BCC Access Control
defaultDescription=BCC Access Control
role=admin
url=http://localhost:7003/ControlCenter/application/accesscontrol
externalURL=true/>

</extensions>

NOTE Access the Endeca Administrators Guide to get additional details or step-by-
step instructions at this link

Look for the topic Integrating Workbench with the Business Control Center in the above
link (PDF).