Branding the Administrative and User Console

Purpose

This OBE tutorial describes and shows you how to brand the Oracle Identity Manager Administrative and User Console.

Time to Complete

Approximately 1 hour

Topics

This OBE tutorial covers the following topics:

 Overview
 Scenario
 Prerequisites
 Customizing the Overall Layout of a Web Page
 Adding a Logo to the Administrative and User Console
 Changing Copyright-Related Information in the Administrative and User Console
 Customizing the Colors, Font, and Alignment of Text in the Administrative and User Console
 Summary
 Related Information

Viewing Screenshots

 Place the cursor over this icon to load and view all the screenshots for this tutorial. (Caution: Because this action loads all screenshots simultaneously, response time may be slow depending on your Internet connection.)

Note: Alternatively, you can place the cursor over each individual icon in the following steps to load and view only the screenshot associated with that step.

The screenshots will not reflect the specific environment you are using. They are provided to give you an idea of where to locate specific functionality in Oracle Identity Manager.

Overview

Oracle Identity Manager is a component of the suite of Oracle Identity and Access Management products. It administers and selectively automates tasks to manage user access privileges across a company’s resources throughout the identity management life cycle. Specifically, Oracle Identity Manager handles tasks for creating user access privileges, modifying these privileges dynamically (based on changes to user and business requirements), and removing user access privileges. As a result, Oracle Identity Manager handles user identity information across multiple identity data stores to maintain data accuracy.

Features and benefits of Oracle Identity Manager include identity and role administration (user and group management, self-service functionalities for users, and delegated administration), provisioning (approval and request management, and configurable workflow models), policy-based entitlements, reconciliation, and attestation support (for audit, regulatory, and compliance purposes).

Back to Topic List

Scenario

Linda works as a network administrator for Mydo Main Corporation. She is responsible for performing identity and access management tasks on users within the company. One such task is customizing the Administrative and User Console for the Oracle Identity Manager environment installed and configured for Mydo Main. By doing so, she can tailor this console to meet her company's requirements.

One type of customization to perform with the Administrative and User Console is modifying its look and feel (that is, branding it).

There are different ways Linda can brand the Administrative and User Console, including:

In this OBE, Linda uses the methods listed in this section to brand the Administrative and User Console for Mydo Main Corporation.

Back to Topic List

Prerequisites

Before starting this tutorial, you should:

1.

Complete the OBE titled Installing, Configuring, and Launching Oracle Identity Manager.

2.

Complete the OBE titled Preparing to Customize the Administrative and User Console.

Back to Topic List

Customizing the Overall Layout of a Web Page

In the OBE titled Preparing to Customize the Administrative and User Console, Linda configured the Oracle Identity Manager environment for Mydo Main Corporation to customize the Administrative and User Console. Linda is ready to modify the look and feel of this console (that is, brand it). One way to brand this console is by customizing the overall layout of its Web pages. 

In this section, Linda is to customize the general layout of a Web page so that the product logo of Oracle Identity Manager appears at the right side of the header banner. To perform this action, she must access the xlDefaultAdmin.properties file. Then, she needs to swap the reference to the product logo (that is, global.image.clientlogo) with the reference for a spacer (or a graphic that occupies a designated amount of horizontal space in the header banner, thereby “pushing” the product logo to the right). The reference for this spacer is global.image.xelleratelogo.

To customize the overall layout of a Web page, perform the following steps:

1.

Using a text editor, open the xlDefaultAdmin.properties file (found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\WEB-INF\classes folder).

 

2.

Locate the reference to the product logo ( global.image.clientlogo).

 

3.

Change the value of the global.image.clientlogo reference (from /images/client_logo.gif to /images/xellerate-trans-grey.gif).

 

4.

Locate the reference for a spacer (or a graphic that occupies a designated amount of horizontal space in the header banner, thereby “pushing” the product logo to the right). The reference for this spacer is global.image.xelleratelogo.

5.

Change the value of the global.image.xelleratelogo reference (from /images/xellerate-trans-grey.gif to /images/client_logo.gif).

 

6.

Save and close the xlDefaultAdmin.properties file. 

 

7.

Restart Oracle Identity Manager Server, and the Administrative and User Console. The Home page of the console appears. The product logo appears at the right side of the header banner.

Note: For more information about starting and stopping Oracle Identity Manager, refer to the OBE titled Installing, Configuring, and Launching Oracle Identity Manager.

Linda customized the general layout of a Web page so that the product logo of Oracle Identity Manager appears at the right side of the header banner.

In the next section of this OBE, Linda learns another way to brand the Administrative and User Console. She is to add a logo to the header banner of this console.

Back to Topic List

Adding a Logo to the Administrative and User Console

In the previous section of this OBE, Linda customized the overall layout of a Web page so that the product logo of Oracle Identity Manager appears at the right side of the header banner.

Linda is ready to brand the Administrative and User Console in a different way. For this OBE, she is to add a logo to the header banner of this console. This logo represents the company logo for Mydo Main Corporation. The reference for this logo is oracle_id_mgt_clr.gif.

To perform this action, she must access the xlDefaultAdmin.properties file . Then, she must assign the logo to the property that represents the spacer (that is, global.image.clientlogo).

To add a logo to the Administrative and User Console, perform the following steps:

1.

Shut down Oracle Identity Manager Server, and the Administrative and User Console.

 

2.

Copy the oracle_id_mgt_clr.gif file, which represents the company logo, from the C:\stage\External Files directory to the C:\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\ xlWebApp\images directory.

 

3.

Using a text editor, open the xlDefaultAdmin.properties file (found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\WEB-INF\classes folder).

 

4.

Locate the global.image.clientlogo property.

 

5.

Set the value of this property to be equivalent to the full path and name of the image file that contains the company logo (that is, /images/oracle_id_mgt_clr.gif).

 

6.

Save and close the xlDefaultAdmin.properties file. 

 

7.

Restart Oracle Identity Manager Server, and the Administrative and User Console. The company logo appears in the Home page of this console.

Linda added a logo to the header banner of the Administrative and User Console. In the next section of this OBE, Linda learns another way to brand this console. She is to change copyright-related information in the footer banner of the console.

Back to Topic List

Changing Copyright-Related Information i n the Administrative and User Console

In the previous section of this OBE, Linda added a logo to the header banner of the Administrative and User Console. Linda is ready to brand this console in a different way. For this OBE, she is to change the copyright-related information that appears in the footer banner of the console.

To perform this action, she must access the  xlWebAdmin.properties, xlWebAdmin_en.properties, and xlWebAdmin_en_US.properties files. These files contain text and labels that appear in the Administrative and User Console.

Then, she must assign new values to the global.message.copyright and global.message.termOfUse properties. These properties, located in the GLOBAL messages section of the xlWebAdmin.properties, xlWebAdmin_en.properties, and xlWebAdmin_en_US.properties files, represent copyright-related information in the footer banner of the console.

To change copyright-related information in the footer banner of the Administrative and User Console, perform the following steps:

1.

Shut down Oracle Identity Manager Server, and the Administrative and User Console.

 

2.

Using a text editor, open the xlWebAdmin.properties file (found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\WEB-INF\classes folder).

 

3.

Locate the GLOBAL messages section.

 

4.

Assign new values to the global.message.copyright and global.message.termOfUse properties, as follows:

Property Old Value New Value
global.message.copyright Copyright © 2008, Oracle Corporation. Copyright © 2008, Mydo Main Corporation.
global.message.termOfUse Oracle Identity Manager 9.1.0 Mydo Main User Administration Manager

 

5.

Save and close the xlWebAdmin.properties file. 

6.

Repeat steps 2-5 for the xlWebAdmin_en.properties and xlWebAdmin_en_US.properties files (also found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\WEB-INF\classes folder). 

7.

Restart Oracle Identity Manager Server, and the Administrative and User Console. The copyright-related information in the footer banner of the Administrative and User Console reflects the changes made to the   xlWebAdmin.properties, xlWebAdmin_en.properties, and xlWebAdmin_en_US.properties files.

Linda changed copyright-related information in the footer banner of the Administrative and User Console. In the next section of this OBE, Linda learns another way to brand this console. She is to customize the colors, font, and alignment of text in the console.

Back to Topic List

Customizing the Colors, Font, and Alignment of Text in the Administrative and User Console

In the previous section of this OBE, Linda changed the copyright-related information in the footer banner of the Administrative and User Console. Linda is ready to brand this console in a different way. For this OBE, she is to customize the color, font face, and alignment of this copyright-related information.

To perform this action, she must access the Xellerate.css file. This file is a style sheet that controls the properties of the text that appears in the Administrative and User Console (such as the color, font, and alignment of the text). Because Linda is modifying the text in the footer banner of the console, she must access the .Footer section of the Xellerate.css file.

To customize the colors, font, and alignment of text in the Administrative and User Console, perform the following steps:

1.

Shut down Oracle Identity Manager Server, and the Administrative and User Console.

 

2.

Using a text editor, open the Xellerate.css file (found in the C:\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\css folder).

 

3.

Locate the .Footer section.

 

4.

Modify the copyright-related information in the footer banner of the Administrative and User Console, as follows:

Attribute Old Value New Value
Color FFFFFF FFFF00
Font Face arial times
Alignment right left

Note: FFFFFF is the hexadecimal code for a white-colored font, and FFFF00 is the corresponding code for a font that appears in yellow.

 

5.

Save and close the Xellerate.css file. 

6.

Restart Oracle Identity Manager Server, and the Administrative and User Console. The copyright-related information in the footer banner of this console is modified, and reflects the changes made to the Xellerate.css file.

Linda customized the color, font, and alignment of copyright-related information in the footer banner of the Administrative and User Console. In this OBE, she learned how to brand this console.

In the OBE titled Changing the Functionality of the Administrative and User Console, Linda learns another level of customization to perform with this console. Specifically, she is to change the functionality of the Administrative and User Console without modifying Oracle Identity Manager code.

Back to Topic List

Summary

In this lesson, you learned how to:

 Customize the overall layout of a Web page
 Add a logo to the Administrative and User Console
 Change copyright-related information in the Administrative and User Console
 Customize the colors, font, and alignment of text in the Administrative and User Console

Back to Topic List

Related Information

 To ask a question about this OBE tutorial, post a query on the OBE Discussion Forum.

Back to Topic List

 Place the cursor over this icon to hide all screenshots.

 

Left Curve
Popular Downloads
Right Curve
Untitled Document