Agent information other than the agent name is not included in agent responses by default. You can customize agents to include the agent header, providing additional information that can be included in logs.

You must edit the /conf/log4j2.xml file to log the information included in the agent header. See Security audit logging for more information.

For more information about agent headers, see .

Agent Header

The optional vnd-pi-agent header allows the agent to communicate information about itself and its deployment environment to PingAccess. The value of this header is a map of comma-separated key-value pairs.

The agent can specify the custom keys specific to the deployment of the agent or utilize one or more of the well-known keys:
The version of the agent making the request.
The type of agent and/or the type of platform where the agent resides.
The hostname of the server where the agent resides.

The syntax for the vnd-pi-agent value conforms to a dictionary in this specification,, where member-values are constrained to be an sh-string item.

These header examples are considered semantically equivalent.

vnd-pi-agent: v="1.0.0", h="", t="Apache 2.4.41"
vnd-pi-agent: v="1.0.0", h=""
vnd-pi-agent: t="Apache 2.4.41"
vnd-pi-agent: v="1.0.0"
vnd-pi-agent: h=""
vnd-pi-agent: t="Apache 2.4.41"