---
title: ClientContext
description: Information about the client sending a request. When IG receives a request, it injects information about the client sending the request into this context.
component: pinggateway
version: 7.2
page_id: pinggateway:reference:ClientContext
canonical_url: https://docs.pingidentity.com/pinggateway/2026/reference/ClientContext.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-02T16:30:54Z
superseded_by: https://docs.pingidentity.com/pinggateway/2026/reference/ClientContext.html
section_ids:
  Client-properties: Properties
  Client-moreinfo: More information
---

# ClientContext

Information about the client sending a request. When IG receives a request, it injects information about the client sending the request into this context.

## Properties

The context is named `client`, and is accessible at `${contexts.client}`. The context has the following properties:

* `"certificates"`: array

  List of X.509 certificates presented by the client. If the client does not present any certificates, IG returns an empty list. Never `null`.

* `"isExternal"`: boolean

  True if the client connection is external.

* `"isSecure"`: boolean

  True if the client connection is secure.

* `"localAddress"`: [string](preface.html#definition-string)

  The IP address of the interface that received the request.

* `"localPort"`: number

  The port of the interface that received the request.

* `"remoteAddress"`: string

  The IP address of the client (or the last proxy) that sent the request.

* `"remotePort"`: number

  The source port of the client (or the last proxy) that sent the request.

* `"remoteUser"`: string

  The login of the user making the request, or `null` if unknown. This is likely to be `null` unless you have deployed IG with a non-default deployment descriptor that secures the IG web application.

* `"userAgent"`: string

  The value of the User-Agent HTTP header in the request if any, otherwise `null`.

## More information

[org.forgerock.services.context.ClientContext](../_attachments/apidocs/org/forgerock/services/context/ClientContext.html)