This is part IV of Oracle Entitlement Server & Client (Security Module) 11gR2 installation and Configuration, In this post I am going to integrate Oracle Service Bus (OSB) 11g (188.8.131.52) with OES 11g R2 (184.108.40.206) using OES Client (Security Module) for OSB.
Note: When you are installing OES client software in part III of this series, Install OES client software in same Middleware Home as OSB . OSB and OES client must be in separate Oracle Home but under same Middleware Home.
Things you must know before configuring OSB with OES
Pre-Requisites steps before integrating OSB with OES
Make sure following steps are configured before configuring OES Security Module for OSB with JRF
1. OES server software is installed & configured
2. OSB Server software is installed
3. OES SM is installed in same Middleware Home as OSB (OSB ORACLE_HOME and OES SM ORACLE_HOME are in different directory but under same Middleware Home)
4. OSB Domain configuration is optional (If OSB domain is NOT yet configured then you can configure OSB domain during OES integration). In this example OSB domain already exists.
5. As discussed in my previous post things you must know while configuring OES SM and mentioned earlier in this post you must decide on Security Policy distribution mode (Controlled Pull, or Non Controlled Pull) I am going to use Controlled-Pull
Note: Controlled-Push is NOT supported with WebLogic/OSB SM with JRF and hence I am using controlled-pull.
OSB integration with OES
1. Update smconfig.wls.controlled.prp on OSB node (In this step we are creating properties file that will be used later in this post to create an instance of Security Module for OSB on OSB host)
cd $OSB_MIDDLEWARE_HOME/oesclient/oessm/SMConfigTool (where oesclient directory is OES CLIENT ORACLE_HOME)
cp smconfig.wls.controlled.prp smconfig.wls.osb_controlled_pull.prp
Open file smconfig.wls.osb_controlled_pull.prp file and change
In controlled pull or uncontrolled pull you don’t define below two properties
a) Controlled-Pull here represents that Policies from OES Policy Store (Database) will be pulled by OES SM (Security Module) for OSB in controlled manner.
b) OSBSM is name of security module instance
c) DB means OES policies are stored in a database
d) [DBHOST]:[DBPORT]/[SERVICE_NAME] is database details of OES Policy Store Database
e) OES_OPSS is the name of OES Policy Store schema name in OES Database
f) welcome1 is password of OES_OPSS schema
g) cn=oes_domain is domain name of OES server (note that this name is WebLogic Domain name where OES is deployed)
h) cn=jpsroot is location of Policy Store of OES domain
2. Run configuration tool
$OES_CLIENT_HOME/oessm/bin/config.sh -onJRF -smType wls -prpFileName $OES_CLIENT_HOME/oessm/SMConfigTool/smconfig.wls.osb_controlled_pull.prp –serverLocation <LocationofWebLogicServerHomeOfOSB>
./config.sh -onJRF –smConfigId SMFORWC3 -prpFileName /oracle/apps/atul/mw1035/oesclient/oessm/ SMConfigTool/ smconfig.wls.controlled_pull.prp –serverLocation /oracle/apps/atul/mw1035/wlserver_10.3
Note: Above command will do two things
a) Create Security Module instance directory under $OES_CLIENT_HOME/oes_sm_instances/[SMConfigID] i.e. $OES_CLIENT_HOME/oes_sm_instances/OSBSM
b) Starts installer to create/extend domain to include OESSM (as shown below)
Note: If there is no OSB WebLogic Domain then select “Create a New WebLogic Domain“, if OSB domain already exists then select “Extend an existing WebLogic Domain”
Note: Select the OSB domain (only if you are extending OSB domain to include OESSM). If you are creating new OSB Domain, then enter location of OSB Domain.
Note: Select Template “Oracle Entitlement Server Security Module on Service Bus” . If you are creating new WebLogic Domain then apart from “Oracle Entitlement Server Security Module on Service Bus” select OSB related templates.
In this example you can see that Oracle Service Bus is already selected and Greyed out.
Follow steps to complete domain extension .
3. Update jps-config.xml from OSB domain for “OES Security Module for OSB” by using OESSMCONFIG tool
cd $OESCLIENT_ORACLE_HOME/oes_sm_instances/[OESSM_NAME]/bin/ (where OESSM_NAME in my case is OSBSM )
./oessmconfig.sh -jpsconfig [OSB_DOMAIN]/config/fmwconfig/jps-config.xml (jps-config.xml must be from OSB DOMAIN/config/fmwconfig where you wish to configure OES Security Module )
a) Policy Distribution Mode to “Controlled-Pull”
b) Policy Store to “Database Configuration through URL jdbc.url=jdbc:oracle:thin:@[DBHOST]:[DBPORT]/[SERVICE_NAME] is database details of OES Policy Store Database
OES_OPSS is the name of OES Policy Store schema name in OES Database
welcome1 is password of OES_OPSS schema
c) cn=oes_domain is domain name of OES server (note that this name is WebLogic Domain name where OES is deployed)
d) cn=jpsroot is location of Policy Store of OES domain
4. Create Application & Register Security Module in OES (http://OESHost:adminPort/apm )
4.1 Create Application in OES
APM : Authorization Management -> Applications -> New
4.2 Create Security Module in OES
APM : System Configuration -> Security Modules -> New
Enter Display Name
4.3 Bind Security Module to Application in OES
APM : System Configuration -> Security Modules -> OSBSM -> Add
5. In OSB Domain, OES Proxy Provider must be enabled to secure and protect OSB runtime so next step is to configure OES Proxy Authorization Provider
OSB WebLogic Domain : Security Realm -> myrealm -> Providers -> Authorization -> New
5.1 Re-order the Authorization Provider so that OES Authorization Proxy is first provider
5.2 Restart WebLogic Admin & Managed Server of OSB
6. Distribute Application Policy to Security Module (SM) for OSB
More on Policy Modelling for OSB Resources in OES Server in upcoming posts
Oracle ACE, Author, Speaker and Founder of K21 Technologies & K21 Academy : Oracle Gold Partner specialising in Design, Implement, and Trainings.