---
title: Login Reason Value Map
description: When Login Reason Parameter Name is set, this property specifies alternative strings to use for the supported values. For example:
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.login.reason.remapper
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.login.reason.remapper.html
---

# Login Reason Value Map

When [Login Reason Parameter Name](org.forgerock.agents.login.reason.parameter.name.html) is set, this property specifies alternative strings to use for the supported values. For example:

Consider the example where Login Reason Parameter Name is set to `auth_reason`, and this property is set as follows:

`org.forgerock.agents.login.reason.map[NO_TOKEN]=notoken`

`org.forgerock.agents.login.reason.map[TOKEN_EXPIRED]=expired`

`org.forgerock.agents.login.reason.map[EXCEPTION]=exception`

The agent redirects authentication to the following URL:

`https://custom.example.com:8443/…​./login_endpoint?…​&auth_reason=notoken&…​`

|                          |                                                                                                                                                                                                                          |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Property name            | `org.forgerock.agents.login.reason.remapper`                                                                                                                                                                             |
| Aliases                  | `org.forgerock.agents.login.reason.remapper`   Introduced in Java Agent 5.7`org.forgerock.agents.login.reason.map`   Introduced in Java Agent 5.7   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 7 |
| Function                 | Login                                                                                                                                                                                                                    |
| Type                     | Map- Keys: failed login reason code

- Values: masked value                                                                                                                                                              |
| Bootstrap property       | No                                                                                                                                                                                                                       |
| Required property        | No                                                                                                                                                                                                                       |
| Restart required         | No                                                                                                                                                                                                                       |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                 |
| AM console               | Tab: `Miscellaneous (from AM 7)`Title: `Login Reason Value Map`                                                                                                                                                          |