---
title: Session Attribute Fetch Mode
description: Map the name of an AM session attribute specified in Session Attribute Map as follows:
component: java-agents
version: 2023.11
page_id: java-agents:properties-reference:org.forgerock.agents.session.attribute.fetch.mode
canonical_url: https://docs.pingidentity.com/java-agents/2026/properties-reference/org.forgerock.agents.session.attribute.fetch.mode.html
llms_txt: https://docs.pingidentity.com/java-agents/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
superseded_by: https://docs.pingidentity.com/java-agents/2026/properties-reference/org.forgerock.agents.session.attribute.fetch.mode.html
---

# Session Attribute Fetch Mode

Map the name of an AM session attribute specified in [Session Attribute Map](org.forgerock.agents.session.attribute.map.html) as follows:

* NONE: Do not map

* HTTP_HEADER: Map the to the name of an HTTP session header

* HTTP_COOKIE: Map to the name of an HTTP cookie

* REQUEST_ATTRIBUTE: Map to the name of an HTTP session attribute

When the value is `HTTP_COOKIE`, [Cookie Reset](org.forgerock.agents.cookie.reset.enabled.html) is automatically set to `true`. Before redirecting the client for login, and when the client logs out, the agent resets profile and session attributes cookies, and cookies in the [Reset Cookie List](org.forgerock.agents.cookie.reset.name.list.html).

|                          |                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.session.attribute.fetch.mode`                                                                                                                                                                                                                                                                                                  |
| Aliases                  | `org.forgerock.agents.session.attribute.fetch.mode`   Introduced in Java Agent 5.6`com.sun.identity.agents.config.session.attribute.fetch.mode`   Introduced in Java Agent 5.0   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 6                                                                                                |
| Function                 | Attributes, Cookie reset, Session                                                                                                                                                                                                                                                                                                                    |
| Supported settings       | * NONE

  No AM attributes are mapped.

* HTTP_HEADER

  The named AM attributes are mapped to headers in the outgoing HTTP response.

* REQUEST_ATTRIBUTE

  The named AM attributes are mapped to request attributes in the outgoing HTTP response.

* HTTP_COOKIE

  The named AM attributes are mapped to cookies in the outgoing HTTP response. |
| Default                  | `NONE`                                                                                                                                                                                                                                                                                                                                               |
| Bootstrap property       | No                                                                                                                                                                                                                                                                                                                                                   |
| Required property        | No                                                                                                                                                                                                                                                                                                                                                   |
| Restart required         | No                                                                                                                                                                                                                                                                                                                                                   |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                                                                                                                                             |
| AM console               | Tab: `Application`Title: `Session Attribute Fetch Mode`                                                                                                                                                                                                                                                                                              |
