Java based OES XACML Samples
----------------------------

Overview
--------
This test suite provides java based samples, which can be run against the OES XACML gateway. The following cases are tested in the suite:

1)Authorization with user-role.
2)Authorization using resource attribute.
3)Authorization using environment attribute.
4)Authorization using predicates and obligations.

Software Pre-requisites
-----------------------
1)Oracle IDM suite.
2)Oracle Weblogic Server.
3)OES Client.
4)Running Oracle DB.
5)Oracle Repository Creation Utility (rcu).
6)Apache Ant >= 1.6.3

Environment Setup
-----------------
1) Install and configure the "Oracle Entitlements Server" and "OES client" using the guide at http://download.oracle.com/docs/cd/E21764_01/install.1111/e12002/oes.htm
    a) Install OES with an SSL port.
    b) Configure a Webservice Security Module when installing "OES Client".
    c) Configure the WS SM in "uncontrolled" or "controlled-push" mode.

2)Start the WS SM client. Go to <client_home>/oes_sm_instances/<sm_name>. Run ./startWSServer.sh

Test Setup and run
------------------
NOTE: Set ANT_HOME, JAVA_HOME properly before running ant command. Make sure $ANT_HOME/bin|%ANT_HOME%\bin and $JAVA_HOME/bin|%ANT_HOME%\bin added in PATH


1)Extract the test to a convenient location. Go to wsxacml-samples.

2)Set properties of the webservices SM client in config/build.properties.

3)Run "ant setup" to seed policies into the policy store.

4)If the WS SM is configured in "controlled-push" mode, perform the following:
  a)Open a browser window and go to "http://<weblogic_host>:<weblogic_port>/apm".
  b)Login with your weblogic username or password.
  c)Click on "System Configuration" tab.
  d)In the left pane, click on "Security Modules" and click "Open".
  e)Click "New" in the top-right pane. Enter the name of the configured WS SM under "Name" and click "Save".
  f)Click "Add" in the bottom-right pane. Search for "xacml" and add the application.
  g)Click on "Authorization Management" tab. In the left pane, expand "Applications".
  h)Click on "xacml" and click "Open".
  i)Click on "Policy Distribution" tab.
  j)Click on the configured WS SM and click "Distribute".
  k)Check distribution station by clicking "Refresh". Wait for distribution to complete.
  l)Logout from the apm tool.

5)Go to the wsxacml-samples location and run "ant build".

6)There are 4 tests in the suite as mentioned in the overview. To run any of them, run "ant -Dchoice=<choice 1..4> run".

7)The test can also be run by running the runXACMLSample.sh|runXACMLSample.bat script generated in the dist directory.

8)Run "ant unsetup" to remove the test policies from the policy store.