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.