This chapter explains several customizations you can make to Oracle Authorization Policy Manager, the Oracle Entitlements Server Administration Console. It contains the following sections.
All customizations described in this chapter require modifying data in one or both of the following file archives:
$ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_11.1.1/oracle.security.apm.ear $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.core.view.war
Tip:
Before you begin, it is recommended that you backup these Authorization Policy Manager EAR and WAR files.Any customizations applied to a version of Authorization Policy Manager must be specified again every time a new version is installed. The following procedure specifies, from a high level, how to customize Authorization Policy Manager.
Unzip the EAR, WAR and view WAR files using the following commands:
$ unzip -d $tempDir/ear $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.ear $ unzip -d $tempDir/war $tempDir/ear/oracle.security.apm.war $ unzip -d $tempDir/viewWar $ORACLE_IDM_HOME$/apm/modules/ oracle.security.apm_11.1.1/oracle.security.apm.core.view.war
Modify one or more of the unzipped files as documented in one of the following sections of this chapter.
Rearchive the modified EAR, WAR and view WAR files using the following commands:
$ zip $tempDir/ear/oracle.security.apm.war $tempDir/war/* $ zip $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.ear $tempDir/ear/* $ zip $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.core.view.war $temp/viewWar/*
Redeploy Authorization Policy Manager.
Use the following procedure to customize headers, footers, and the logo.
Unzip the view WAR file.
$ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.core.view.war
Open AuthPolicyMgr.jspx file and apply any or all of the following modifications.
Specify a new branding title (header) by modifying the branding facet.
<f:facet name="branding"> <af:outputText value="My Custom Application Title" noWrap="true" id="ot1"/> </f:facet>
Specify a new footer by modifying the appAbout and appCopyright facets.
<f:facet name="appAbout"> <af:outputText value="My Custom Footer at Right" noWrap="true" id="ot2"/> </f:facet> <f:facet name="appCopyright"> <af:outputText value="My Custom Footer at Left" noWrap="true" id="ot3"/> </f:facet>
Specify a new logo image as follows:
Insert your resource in the metaContainer facet.
<f:facet name="metaContainer">
....
<af:resource type="css">
.MyCustomBrandingLogo {
background-image:url(/apm/images/world_36x20.png);
background-position:center;
background-repeat:no-repeat; display:block;
height:2.5em; width:119px;
}
</af:resource>
...
</f:facet>
Be sure to leave all other content inside the metaContainer facet as is.
Specify the style class name (defined in the previous step) as the attribute value of the pageTemplate tag.
<af:pageTemplate viewId="/templates/IdmShell.jspx"
value="#{bindings.pageTemplateBinding}" id="pt1">
...
<f:attribute name="brandingLogoCls" value="MyCustomBrandingLogo"/>
...
Be sure to leave all other content inside the pageTemplate tag as is.
Rearchive the view WAR file.
$ zip $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.core.view.war $temp/viewWar/*
Redeploy Authorization Policy Manager.
You can develop a new skin to apply to a web application. Use the following procedure to customize the Authorization Policy Manager color scheme. It assumes that you have a new skin available to reference.
Note:
Authorization Policy Manager uses the Oracle Application Development Framework (ADF) and supports ADF skinning. See the Oracle Fusion Middleware Skin Editor User's Guide for Oracle Application Development Framework for more information on ADF skins.Unzip the EAR and WAR files.
$ unzip -d $tempDir/ear $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.ear $ unzip -d $tempDir/war $tempDir/ear/oracle.security.apm.war
Open the Trinidad-config.xml file.
This file is typically located in the decompressed WAR's WEB-INF folder.
Specify the value of the new skin location in the skin-family tag.
<trinidad-config xmlns="http://myfaces.apache.org/trinidad/config"> ... <skin-family>MyCustomSkin</skin-family> ... </trinidad-config>
Rearchive the modified EAR and WAR files using the following commands:
$ zip $tempDir/ear/oracle.security.apm.war $tempDir/war/* $ zip $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.ear $tempDir/ear/*
Redeploy Authorization Policy Manager.
Use the following procedure to customize the login and login error pages.
Unzip the EAR file.
$ unzip -d $tempDir/ear $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.ear
Open the web.xml file.
This file is typically located in the decompressed EAR's WEB-INF folder.
Specify the appropriate values for the form-login-page and form-error-page under the element form-login-config.
<login-config> <form-login-config> <form-login-page>/MyCustomLoginPage.html</form-login-page> <form-error-page> MyCustomLoginErrorPage.html </form-error-page> </form-login-config> </login-config>
Rearchive the modified EAR file using the following commands:
$ zip $ORACLE_IDM_HOME$/apm/modules/oracle.security.apm_ 11.1.1/oracle.security.apm.ear $tempDir/ear/*
Redeploy Authorization Policy Manager.