Collector nodes provide a callback mechanism where input is collected. A typical example is the username collector, which provides a single text-based callback.
The two main collectors of interest when customizing the login process are the Username Collector Node and the Password Collector Node; each of the collector nodes has a corresponding properties file, which contains the
callback.[name] property. This property defines the prompt text.
The collector nodes' property files are located in the auth-nodes-<version>.jar file in the WEB-INF/lib directory of the AM WAR file. You can find these files in the following path within the jar file: org/forgerock/openam/auth/nodes.
The following example demonstrates changing the user name and password prompts:
- Unpack the AM WAR file and extract the auth-nodes-<version>.jar file from the WEB-INF/lib directory.
- Navigate to the org/forgerock/openam/auth/nodes path within the extracted jar.
- Edit the UsernameCollectorNode.properties file to update the callback.username property to the prompt of your choice, for example: callback.username=Your User Name
- Edit the PasswordCollectorNode.properties file to update the callback.password property to the prompt of your choice, for example: callback.password=Your Password
- Repack the auth-nodes-<version>.jar with your changes.
- Add your customization to the AM WAR file:
- Replace the existing jar file in the WEB-INF/lib directory with your customized jar file.
- Repack the AM WAR file and deploy as normal.
- Restart the web application container in which AM runs.
- Test your changes.
The resulting login page looks like this after a restart:
Followed by the Password Collector Node: