.. index:: JWT Claims, Authentication; JWT Claims
.. _jwt-claims:

JWT Claims
==========

For an overview of the authentication process, refer to :ref:`authentication`.
This table serves as a quick reference for custom claims present in the JWT token returned following cognito authentication.

+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|                    Claim    |                                                                                                 Description                                                           |
+=============================+=======================================================================================================================================================================+
| ``custom:hostname``         | The hostname that will be used for Graphene API requests over gRPC.                                                                                                   |
+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``custom:bucket``           | The globally unique S3 bucket name for this account. Prefixed with ``s3://`` it becomes a globally unique bucket URI.                                                 |
+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ``custom:identity_pool_id`` | The cognito identity pool ID required as part of authentication with AWS S3.                                                                                          |
+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------+