Biblioteca de identidade

Protocolos · Token de acesso

O que é token de acesso.
Access token, refresh token e ID token: o que cada um prova e quanto tempo vale.

O token de acesso é a "pulseira" que um aplicativo mostra para uma API. Veja os tipos de token, o formato JWT e por que um token esquecido é um acesso que continua ativo.

Funciona com Microsoft Entra ID e Google Workspace

Principais conclusões

  • Um token de acesso (access token) é uma credencial emitida por um servidor de autorização que permite a um aplicativo chamar uma API, dentro de escopos definidos.
  • Access tokens costumam durar pouco (minutos ou horas). O refresh token, que serve para pedir novos access tokens, pode durar dias ou meses.
  • O ID token, do OpenID Connect, é feito para o software que pediu o login saber quem é o usuário; para chamar a API usa-se o access token.
  • Desativar o usuário nem sempre invalida tokens já emitidos na hora. No Microsoft Entra ID, por exemplo, o access token dura cerca de uma hora por padrão.

Tipos de token

TokenPara que serveValidade típica
Access tokenChamar uma API com os escopos concedidosMinutos a poucas horas
Refresh tokenObter um novo access token sem novo loginDias a meses, conforme a política
ID tokenInformar ao aplicativo quem é o usuário (OpenID Connect)Curta
Token de API pessoalChave criada pelo usuário para scripts e integraçõesLonga; em alguns softwares, sem expiração

O formato JWT

Muitos tokens usam o formato JWT (JSON Web Token): três partes em Base64url separadas por pontos (na forma assinada). O cabeçalho diz o algoritmo, o corpo traz as informações (claims), como emissor, usuário e expiração, e a assinatura prova que o token não foi alterado.

Em geral o JWT é só assinado (JWS), não criptografado: quem tem o token lê o conteúdo. Existe a variante criptografada (JWE), menos usada. Por isso tokens não devem carregar dados sensíveis e precisam trafegar só em HTTPS.

Escopos: o tamanho do acesso

O escopo define o que o token permite, como "ler calendário" ou "enviar e-mail em nome do usuário". É aqui que o menor privilégio se aplica às integrações: pedir só o escopo necessário e revisar os aplicativos que pediram escopos amplos.

Revogação e saída de colaboradores

  • Desativar a conta impede novos logins, mas um access token já emitido pode valer até expirar. No Entra ID, o padrão é de cerca de uma hora.
  • Refresh tokens e sessões precisam ser revogados no desligamento, conforme os recursos de cada provedor. A sessão criada pelo próprio software nem sempre cai junto.
  • Tokens de API pessoais e credenciais de integração criadas pela pessoa podem continuar funcionando enquanto a conta naquele software seguir ativa.

Por isso a saída precisa chegar à conta em cada software, não só ao provedor de identidade.

O que acontece com cada token no desligamento

Bloquear a pessoa no provedor de identidade não derruba tudo ao mesmo tempo:

CredencialDepois do bloqueio no provedor de identidadeO que fecha o acesso
Access tokenPode valer até expirar (no Entra ID, cerca de uma hora por padrão)Esperar a expiração ou o software checar a conta
Refresh tokenEm geral para de gerar novos tokens; a revogação das sessões garanteRevogar as sessões no provedor de identidade
Sessão criada pelo softwarePode continuar abertaEncerrar a sessão ou desativar a conta no software
Token de API pessoalDepende do software; em muitos continua válidoRevogar o token e desativar a conta no software

Boas práticas com tokens

  • Pedir só os escopos necessários e revisar os aplicativos que pediram escopos amplos.
  • Preferir tokens com validade definida aos que não expiram.
  • Dar a cada integração um dono definido e evitar que ela dependa da conta pessoal de alguém.
  • Guardar tokens em cofre de segredos, nunca em código, planilha ou chat.

Onde a governança entra

O token vale enquanto a conta no software vale. Fazer a saída chegar a cada software é trabalho de governança.

A governança de identidade (IGA) da Niuco mantém o inventário de quem tem acesso a quê nos softwares conectados e o cruza com a folha de pagamento: quem entrou, mudou de cargo ou saiu. As campanhas de revisão de acessos levam a lista ao gestor, registram cada decisão e guardam a evidência para o auditor. A Niuco não substitui o SSO nem o diretório: ela trabalha junto com o Microsoft Entra ID e o Google Workspace.

Conheça a governança de identidade

Material informativo. Não substitui orientação jurídica.

Perguntas frequentes sobre token de acesso

Se a sua dúvida não estiver aqui, fale com um especialista — a conversa leva 30 minutos.

É uma credencial emitida por um servidor de autorização que permite a um aplicativo chamar uma API em nome de um usuário ou de um software, dentro de permissões limitadas (escopos).

O access token é usado para chamar a API e dura pouco. O refresh token serve para pedir novos access tokens sem novo login e dura mais.

JSON Web Token: um formato de token com cabeçalho, conteúdo (claims) e assinatura. Em geral é só assinado, não criptografado, então o conteúdo pode ser lido por quem tem o token.

Impede novos logins, mas tokens já emitidos podem valer até expirar. Por isso a saída de um colaborador inclui revogar sessões e refresh tokens e desativar a conta em cada software.

Token esquecido é acesso ativo.

Fale com um especialista sobre saída de colaboradores e contas que ficam para trás.

Fale com um especialista