Token de acesso

Essa página apresenta os passos de como gerar o token do Identity e quais as maneiras recomendadas para fazer isso:

Obtendo seu ID e secret

1. Acesse a página de tokens do Identity;
2. Caso você não possua nenhum token, gere um.
3. Recupere o clientId e o clientSecret de um dos tokens gerados.
   • Não armazene estes campos diretamente na sua aplicação mobile/web. Esses valores não devem sair de seu backend.

P.S.: Você pode repetir esse procedimento para gerar acessos combinando diferentes funções e SDKs.

Gerando seu token

Maneira recomendada

Os passos a seguir descrevem como você pode gerar um token que é válido somente para uma pessoa específica. Essa é a maneira recomendada de gerar e distribuir os tokens pois limita um possível ataque a uma única conta de um usuário.

1. Em algum ponto do seu fluxo, crie um JWT com a seguinte estrutura:
   • Lembre de trocar os campos {clientId}, {personId} e {expiresAt}
   • Todos esses campos são fortemente recomendados, mas você pode ver quais são obrigatórios no final dessa página

Header:

{
  "alg": "HS256",
  "typ": "JWT"
}

Payload:

{
  "iss": "{clientId}",
  "exp": {expiresAt},
  "personId": "{personId}"
}

2. Assine o token usando seu clientSecret;
3. Envie este token para sua aplicação.

Maneira não segura, recomendada somente para homologação

1. Acesse o site jwt.io;
2. Mantenha o campo Header como está;
3. Troque o payload para o seguinte, substituindo {clientId} pelo seu clientId:

{
  "iss": "{clientId}"
}

4. Troque your-256-bit-secret pelo seu clientSecret;
5. Clique em Share JWT para copiar o token gerado para a área de transferência;
6. Use esse token em sua aplicação mobile.

Parâmetros do Payload JWT

Parâmetro	Obrigatório?	Descrição
iss	Sim	Seu clientId
exp	Não	Tempo de expiração (segundos desde a Era Unix)
personId	Não	O CPF para o qual o token será válido