---
title: Configuring API JSON to extract user information
description: This topic discusses the process to extract user attributes from signed JWT (JSON Web Token).
component: pingintelligence
version: 5.2
page_id: pingintelligence:pingintelligence_integrations:pingintelligence_nginx_plus_configure_api_json
canonical_url: https://docs.pingidentity.com/pingintelligence/5.2/pingintelligence_integrations/pingintelligence_nginx_plus_configure_api_json.html
revdate: April 3, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  next-steps: Next steps
---

# Configuring API JSON to extract user information

This topic discusses the process to extract user attributes from signed JWT (JSON Web Token).

## About this task

To extract the user information from the JSON Web Token (JWT) *(tooltip: \<div class="paragraph">
\<p>An IETF standard container format for a JSON object used for the secure exchange of content, such as identity or entitlement information. You can find the industry standard in \<a href="https\://datatracker.ietf.org/doc/html/rfc7519">RFC 7519\</a>.\</p>
\</div>)* identity mapping:

## Steps

1. Capture the value assigned to `HEADER NAME`.

   This is the name of the header to use when sending the signed JWT to the ASE.

   ![A screen capture of the Username page.](../_images/bzj1621335924364.png)

2. Assign the value of `HEADER NAME` to the `location` key in the `jwt` object of the API JSON file.

   For more information, see [Defining an API using API JSON configuration file in sideband mode](../pingintelligence_reference_guide/pingintelligence_define_api_json_file_sideband.html).

   ```
   "jwt": {
                "location": "h:X-Identity",
               "username": "username",
               "clientid": "client_id"
           }
   ```

## Next steps

Refer to [Creating a JWT identity mapping](https://docs.pingidentity.com/bundle/pingaccess-53/page/etr1564006736769.html) and [Defining an API using API JSON configuration file in sideband mode](../pingintelligence_reference_guide/pingintelligence_define_api_json_file_sideband.html).