---
title: "Detalhes de Autenticação do JWT"
slug: "jwt-authentication-details"
updated: 2026-06-12T10:30:57Z
published: 2026-06-12T10:30:57Z
canonical: "docs.xtremepush.com/jwt-authentication-details"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Detalhes de Autenticação do JWT

Configure um segredo JWT e aprenda os formatos de payload necessários para autenticar usuários no seu jogo

## Use a Autenticação JWT

Para usar um JWT para a autenticação do seu jogo, faça o seguinte:

1. Vá para a aba **Configuração** do seu jogo.
2. No campo **de Autenticação Secreta do JWT** , você pode:
  - Forneça sua própria chave secreta digitando uma chave UTF8 diretamente
  - Gerar uma chave segura clicando no ícone de atualizar.
3. Salve suas configurações.

Essa chave secreta será usada pelo seu sistema para assinar a assinatura do token JWT usando o algoritmo HS256. O Xtremepush usará esse mesmo segredo para verificar a autenticidade do token.

## Formato JWT obrigatório

A carga útil do JWT deve seguir a seguinte estrutura para a identificação adequada do usuário e validação de tokens pelo Xtremepush. A estrutura necessária muda dependendo se seus dados de usuário são gerenciados no Xtremepush ou externamente.

### Dados do Usuário Gerenciados no Xtremepush

Quando os dados do usuário são gerenciados no Xtremepush, a carga útil JWT necessária é estruturada da seguinte forma:

```json
{  
  "account": "34523453",  
  "expiration": "2024-12-18T15:31:00.983Z"  
}
```

- Conta (obrigatória): Deve conter o ID de usuário único do usuário logado para quem o jogo está sendo lançado. O valor desse campo deve ser uma cadeia.
- Expiração (opcional): Se incluída, define o período de validade do token. O valor deve estar no formato ISO 8601.

### Dados do usuário não gerenciados no Xtremepush

Quando os dados do usuário não são gerenciados no Xtremepush, a carga útil JWT necessária é estruturada da seguinte forma:

```json
{  
  "account": "UNIQUE_USER_ID_STRING",  
  "custom attribute": "custom_value",  
  "expiration": "2025-09-15T10:00:00Z",  
}
```

- Conta (obrigatória): Este deve conter o ID de usuário único do usuário logado. O valor deve ser uma cadeia.
- Custom_attribute (obrigatório): Isso representa o atributo personalizado e seu valor correspondente que você criou para seus segmentos de usuário. [Veja antes de criar uma campanha de jogo](/documentation/docs/pt-br/before-you-create-a-game-campaign) para mais informações.
- Expiração (opcional): Define o período de validade do token no formato ISO 8601.