-
Type:
Bug
-
Status: Resolved
-
Priority:
Major
-
Resolution: Fixed
-
Affects Version/s: 6.0.0, 6.0.0.1, 6.0.0.3
-
Component/s: XUI
-
Environment:SYSTEM PROPERTIES
OpenAM Version ForgeRock Access Management 6.0.0.1 Build e149ecbb9b (2018-May-23 20:06)
Server Name http://openam6.example.com:8080/openam
Container Apache Tomcat/8.5.16
Operating System Linux 3.10.0-693.el7.x86_64 amd64
Java Version 1.8.0_171
Browser Version Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.87 Safari/537.36
Server Install Mode Realm
Service Management Configuration Datastore Type Embedded
Java Home /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.171-7.b10.el7.x86_64/jre
Server Names (Configuration->Sites and Servers) [http://openam6.example.com:8080/openam]
Configuration Directory /home/forgerock/openam
User management datastore names under root realm (Datastore plugin type) embedded (LDAPv3ForOpenDS), odsee1 (LDAPv3ForAMDS)
Java Runtime Name OpenJDK Runtime Environment
Java VM Name OpenJDK 64-Bit Server VM
Java VM Version 25.171-b10
Java Arch Data Model 64 bit
System Locale en
Java Classpath /home/forgerock/apache-tomcat-8.5.16/bin/bootstrap.jar /home/forgerock/apache-tomcat-8.5.16/bin/tomcat-juli.jar
Java VM Vendor Oracle Corporation
SYSTEM PROPERTIES OpenAM Version ForgeRock Access Management 6.0.0.1 Build e149ecbb9b (2018-May-23 20:06) Server Name http://openam6.example.com:8080/openam Container Apache Tomcat/8.5.16 Operating System Linux 3.10.0-693.el7.x86_64 amd64 Java Version 1.8.0_171 Browser Version Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.87 Safari/537.36 Server Install Mode Realm Service Management Configuration Datastore Type Embedded Java Home /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.171-7.b10.el7.x86_64/jre Server Names (Configuration->Sites and Servers) [ http://openam6.example.com:8080/openam ] Configuration Directory /home/forgerock/openam User management datastore names under root realm (Datastore plugin type) embedded (LDAPv3ForOpenDS), odsee1 (LDAPv3ForAMDS) Java Runtime Name OpenJDK Runtime Environment Java VM Name OpenJDK 64-Bit Server VM Java VM Version 25.171-b10 Java Arch Data Model 64 bit System Locale en Java Classpath /home/forgerock/apache-tomcat-8.5.16/bin/bootstrap.jar /home/forgerock/apache-tomcat-8.5.16/bin/tomcat-juli.jar Java VM Vendor Oracle Corporation
Reproduction steps
- Git clone the AM external repository:$ git clone ssh://git@stash.forgerock.org:7999/openam/am-external.git
- Check out the relevant branch. For example, 6.0.0$ cd am-external
$ git checkout releases/6.0.0
$ cd openam-ui
Modify the XUI code as follows while using this excerpt from the 5.5 doc as a guide https://backstage.forgerock.com/docs/am/5.5/ui-customization-guide/#d1661e408
3A cd to the directory that the Fonts, images, partials, and other resources are provided in {{src/main/resources/}}for me in a 6.0 env and using the path as am-external this is
/home/forgerock/GitHome/am-external/openam-ui/openam-ui-ria/src/main/resources/themes/dark/partials/login
3B. Add the following to the file _Password.html
<hr />
After modification the _Password.html should look look like this
<!--
Copyright 2015-2017 ForgeRock AS. All Rights Reserved
Use of this code requires a commercial software license with ForgeRock AS.
or with one of its affiliates. All use shall be exclusively subject
to such license between the licensee and ForgeRock AS.
-->
<hr />
<label for="" class="aria-label sr-only separator">
<span></span>
</label>
<input type="password"
id=""
name="callback_"
class="form-control input-lg"
placeholder=""
value=""
data-validator="required"
required
data-validator-event="keyup"
autofocus>
What this will do is create a horizontal line that renders above password fields on login pages, as displayed here
https://backstage.forgerock.com/docs/am/5.5/ui-customization-guide/images/xui-dark-theme-partial.png
Save the file
Next I edited the mappings in /home/forgerock/GitHome/am-external/openam-ui/openam-ui-ria/src/main/js/config/ThemeConfiguration.js to make the dark theme the default theme for all user logins
mappings: [
{ theme: "fr-dark-theme" }
Next ensure that the current directory is openam-ui
for example /home/forgerock/GitHome/am-external/openam-ui/
Set your Maven options:
export MAVEN_OPTS=-Xmx512m
Build the customizations using the following command
mvn clean install
After the build completed I changed directory to the build directory, for ex /home/forgerock/GitHome/am-external/openam-ui/openam-ui-ria/build
copied the entire contents of files and directories in the build directory to $CATALINA_HOME/webapps/openam/XUI
which for me is /home/forgerock/apache-tomcat-8.5.16/webapps/openam/XUI/
cp -r /home/forgerock/GitHome/am-external/openam-ui/openam-ui-ria/build/* /home/forgerock/apache-tomcat-8.5.16/webapps/openam/XUI/
With the server stopped remove the openam.war file in /home/forgerock/apache-tomcat-8.5.16/webapps/openam.war
cd to the directory /home/forgerock/apache-tomcat-8.5.16/webapps/openam/
jar cvf ../openam.war *
cd /home/forgerock/apache-tomcat-8.5.16/webapps/
rm -rf openam
cd to the tomcat work directory, for ex /home/forgerock/apache-tomcat-8.5.16/work/Catalina/localhost
rm -rf openam
start up tomcat with the following command
sh /home/forgerock/apache-tomcat-8.5.16/bin/catalina.sh
clear browser cache/cookies
access openam login page
for example
http://openam6.example.com:8080/openam/XUI/#login/
Observed that the horizontal line that renders above password fields on login pages is not present, as shown in this screenshot
Confirmed that the edits made in the src in _Password.html are present in the openam deployment on tomcat
cat /home/forgerock/apache-tomcat-8.5.16/webapps/openam/XUI/themes/dark/partials/login/_Password.html
<!--
Copyright 2015-2017 ForgeRock AS. All Rights Reserved
Use of this code requires a commercial software license with ForgeRock AS.
or with one of its affiliates. All use shall be exclusively subject
to such license between the licensee and ForgeRock AS.
-->
<hr />
<label for="" class="aria-label sr-only separator">
<span></span>
</label>
<input type="password"
id=""
name="callback_"
class="form-control input-lg"
placeholder=""
value=""
data-validator="required"
required
data-validator-event="keyup"
autofocus>
- relates to
-
OPENAM-13456 AM 6 XUI custom FooterTemplate.html and LoginHeaderTemplate.html not being applied
-
- Resolved
-
-
OPENAM-13457 AM 6 XUI favicon icon not being recognised
-
- Resolved
-