Monday, April 1, 2013

Branding Customization for OOTB Screens in OIM 11g R2


Branding Customization for OOTB screens

1)     Copy the new image, custom-logo.png to the $OIM_HOME/oim.ear/iam-consoles-faces.war/images/ directory.
Note1: Replace $OIM_HOME with the actual path.
Note2: Please execute this step in both the OIM servers if you are doing this in clustered environment.
2)     Add the following keys in the OIMUIBundle.properties: OIMUIBundle_en.properties in adflibCommonUI.jar file located at oracle.iam.ui package.
The adflibCommonUI.jar file is located at WEB-INF\lib folder in oracle.iam.ui.view.war file.

Execute the below commands:

Note: Replace $OIM_HOME with the actual path.

Login to OIM server using SSH
mkdir viewwar

cd $OIM_HOME

cp ./server/apps/oracle.iam.ui.view.war oracle.iam.ui.view.war.bak

cp $OIM_HOME/server/apps/oracle.iam.ui.view.war /home/oracle/viewwar

cd

cd viewwar

jar -xvf ../oracle.iam.ui.view.war

mkdir –p WEB-INF/lib/delete

cd WEB-INF/lib/delete
jar -xvf ../adflibCommonUI.jar

vi ./oracle/iam/ui/OIMUIBundle.properties

Modify the below properties as shown below:

oim.header=Custom Identity Management
login_branding_text= Custom Identity Management
IDENTITY_SELF_SERVICE_TITLE=Custom Identity Management Self Service
IDENTITY_ADVANCED_TITLE=Custom Identity Management System Administration
SIGN_IN_WELCOME_TEXT=Welcome to the Custom Identity Management User and Administrative Console
SIGN_IN_ADVANCED_WELCOME_TEXT=Welcome to the Custom Identity Management System Administration Console
 
vi ./oracle/iam/ui/OIMUIBundle_en.properties
Modify the below properties as shown below:

oim.header=Custom Identity Management
login_branding_text=Custom Identity Management
IDENTITY_SELF_SERVICE_TITLE=Custom Identity Management Self Service
IDENTITY_ADVANCED_TITLE=Custom Identity Management System Administration
SIGN_IN_WELCOME_TEXT=Welcome to the Custom Identity Management User and Administrative Console
SIGN_IN_ADVANCED_WELCOME_TEXT=Welcome to the Custom Identity Management System Administration Console

rm ../adflibCommonUI.jar

jar -cvfM ../adflibCommonUI.jar .

cd /home/oracle/viewwar/

rm -r /home/oracle/viewwar/WEB-INF/lib/delete

rm -r oracle.iam.ui.view.war

jar -cvfM oracle.iam.ui.view.war .

chmod 775 oracle.iam.ui.view.war
cp oracle.iam.ui.view.war $OIM_HOME/server/apps/
cd
rm -r viewwar
3)     Stop the OIM Managed server(s) and then remove the tmp and cache folders located at $MIDDLEWARE_DOMAIN_HOME/servers/oim-server/
4)     Start the OIM Managed server.
Note: Clear tmp and cache folders before you restart.
5)     Login to OIM Identity Console using the following URL. http://<OIM Server Hostname>:<OIM server Port>/identity and the following connections page will appear as shown in the below:
Figure : OIM login page

6)     Enter the value for User ID and Password and Click on Sign In as shown in Figure above.
Figure : OIM page after login

7)     Click on Sandboxes as highlighted in figure above. 

Figure : OIM page after login 
8)     Click on Create Sandbox as highlighted in Figure above. 

Figure : OIM Create Sandbox page. 
9)      Enter “BrandingCustomization” as the Sandbox Name and Sandbox Description and click Save and Close as highlighted in Figure above.
Figure: OIM Create Sandbox confirmation 
10)  Click OK on the Confirmation page. 

Figure : OIM page after sandbox creation 
11)            Click on Customize link as shown in Figure above.
Figure: OIM Customize page 
12)            Select “Source” from the view menu as highlighted in Figure above.
Figure: Source view
 13)            Select the logo and as highlighted in the Figure above
Figure: Component Properties popup

14)            Click Edit as highlighted in Figure above, the Component Properties popup will appear.
Figure: Component Properties popup
15)  Select the Style tab in Component Properties popup as highlighted in Figure above. Enter url('/oim/images/custom-logo.png') in Background Image field and Click Apply and then click OK.
Figure: Source view 
16)  Click on the Header next to Custom logo as highlighted in Figure above and then click Edit.
Figure: Component Properties popup
 17)  Select the Style tab in Component Properties popup as highlighted in Figure above.
Figure: Component Properties popup

18)  Enter “Arial” in Font filed and “16px” in Font Size field, then Click Apply and then click OK.
Figure: Source view
 19)  Enter http://<oim-hostname>:<oim-port>/identity/faces/signin in the browser address bar as highlighted in Figure above and click Enter.
Figure: Sign in page Source view  
20)            Select the logo and as highlighted in the Figure above
Figure: Component Properties popup
 21)            Click Edit as highlighted in Figure the Component Properties popup will appear.
Figure: Component Properties popup
 22)  Select the Style tab in Component Properties popup as highlighted in Figure above. Enter url('/oim/images/custom-logo.png') in Background Image field and Click Apply and then click OK.
Figure: Sign in page Source view. 
23)  Click on the Header next to custom logo as highlighted in Figure above and then click Edit.
Figure: Component Properties popup 
24)  Select the Style tab in Component Properties popup as highlighted in Figure above.
Figure: Component Properties popup 
25)  Enter “Arial” in Font filed and “16px” in Font Size field, then Click Apply and then click OK. 
Figure: Sign in Source View Page
26)  Click Close as highlighted in Figure above.
Figure: Sign in Page 
27)  Enter http://<oim-hostname>:<oim-port>/identity in the browser address bar as highlighted in Figure above and click Enter.
Figure: OIM Page after Login 
28)  Click on Sandboxes as highlighted in Figure above.
Figure: OIM Sandbox page 
29)  Select the Branding Customization Sandbox and click Publish Sandbox as highlighted in Figure above.

Figure: OIM Sandbox page 
30)  Click “Yes” on the Confirmation Popup as highlighted in Figure above.
You will now see your custom logo on the Identity Pages.