---
title: SessionInfoFilter
description: Calls the AM endpoint for session information, and makes the data available as a new context to downstream IG filters and handlers. For information, refer to SessionInfoContext.
component: pinggateway
version: 2023.11
page_id: pinggateway:reference:SessionInfoFilter
canonical_url: https://docs.pingidentity.com/pinggateway/2026/reference/SessionInfoFilter.html
llms_txt: https://docs.pingidentity.com/pinggateway/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2025-06-03T11:21:31Z
superseded_by: https://docs.pingidentity.com/pinggateway/2026/reference/SessionInfoFilter.html
section_ids:
  websocket_notifications_for_sessions: WebSocket notifications for sessions
  SessionInfoFilter-usage: Usage
  SessionInfoFilter-properties: Properties
  SessionInfoFilter-example: Examples
  SessionInfoFilter-moreinfo: More information
---

# SessionInfoFilter

Calls the AM endpoint for session information, and makes the data available as a new context to downstream IG filters and handlers. For information, refer to [SessionInfoContext](Contexts.html#SessionInfoContext).

## WebSocket notifications for sessions

When WebSocket notifications are set up for sessions, IG receives a notification from AM when a user logs out of AM, or when the AM session is modified, closed, or times out. IG then evicts entries that are related to the event from the `sessionCache`.

For information about setting up WebSocket notifications, using them to clear the session cache, and including them in the server logs, refer to [WebSocket notifications](../maintenance-guide/tuning.html#amservice-websocket).

## Usage

```json
{
  "name": string,
  "type": "SessionInfoFilter",
  "config": {
    "amService": AmService reference,
    "ssoToken": runtime expression<string>
  }
}
```

## Properties

* `"amService"`: *AmService [reference](preface.html#definition-reference), required*

  The [AmService](AmService.html) object to use for communication with AM.

  The following `sessionProperties`, are retrieved from AM:

  * When `sessionProperties` in AmService is configured, listed session properties with a value.

  * When `sessionProperties` in AmService is not configured, all session properties with a value.

  * Properties with a value that are required by IG but not specified by `sessionProperties` in AmService. For example, when the session cache is enabled, session properties related to the cache are automatically retrieved.

  Properties with a value are returned, properties with a null value are not returned.

* `"ssoToken"`: *runtime expression<[string](preface.html#definition-string)>, optional*

  Location of the AM SSO or CDSSO token.

  This property can take the following values:

  * `${contexts.ssoToken.value}`, when the SingleSignOnFilter is used for authentication

  * `${contexts.ssoToken.value}` or `${contexts.cdsso.token}`, when the CrossDomainSingleSignOnFilter is used for authentication

  * `${request.headers['mySsoToken'][0]}`, where the SSO or CDSSO token is the first value of the `mySsoToken` header in the request.

  Default: `${request.cookies['AmService-ssoTokenHeader'][0].value}`, where `AmService-ssoTokenHeader` is the name of the header or cookie where the AmService expects to find SSO or CDSSO tokens.

## Examples

For an example that uses the SessionInfoFilter, refer to [Retrieve a Username From the sessionInfo Context](../gateway-guide/data-downstream.html#UserProfileFilter-retrieve-username-sessinfo).

## More information

[org.forgerock.openig.openam.SessionInfoFilter](../_attachments/apidocs/org/forgerock/openig/openam/SessionInfoFilter.html)

[org.forgerock.openig.openam.SessionInfoContext](../_attachments/apidocs/org/forgerock/openig/openam/SessionInfoContext.html)

[SessionInfoContext](Contexts.html#SessionInfoContext)

AM's [Authorization guide](https://docs.pingidentity.com/pingam/7.4/am-authorization/preface.html)