---
title: ForgeRockClientHandler
description: Configure ForgeRockClientHandler, a default PingGateway heap object that chains ClientHandler with TransactionIdOutboundFilter for audit support
component: pinggateway
version: 2026
page_id: pinggateway:reference:ForgeRockClientHandler
canonical_url: https://docs.pingidentity.com/pinggateway/2026/reference/ForgeRockClientHandler.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: 2026-06-01T16:50:04Z
section_ids:
  ForgeRockClientHandler-example: Example
  ForgeRockClientHandler-moreinfo: More information
---

# ForgeRockClientHandler

A Handler available by default on the heap that chains a default [ClientHandler](ClientHandler.html) with a [TransactionIdOutboundFilter](TransactionIdOutboundFilter.html).

This Handler supports [audit services](AuditService.html) by initiating and propagating audit information from PingGateway to the audit framework.

The following default ForgeRockClientHandler is available as a default object on the heap. Reference it by the name ForgeRockClientHandler.

```json
{
     "name": "ForgeRockClientHandler",
     "type": "Chain",
     "config": {
         "filters": [ "TransactionIdOutboundFilter" ],
         "handler": "ClientHandler"
     }
}
```

## Example

For an example that uses ForgeRockClientHandler to log interactions between PingGateway and AM, see [Decorating PingGateway's interactions with AM](../configure/decorators.html#decorators-ig-am).

## More information

[org.forgerock.openig.heap.Keys](../_attachments/apidocs/org/forgerock/openig/heap/Keys.html)