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
| Token | Para que serve | Validade típica |
|---|---|---|
| Access token | Chamar uma API com os escopos concedidos | Minutos a poucas horas |
| Refresh token | Obter um novo access token sem novo login | Dias a meses, conforme a política |
| ID token | Informar ao aplicativo quem é o usuário (OpenID Connect) | Curta |
| Token de API pessoal | Chave criada pelo usuário para scripts e integrações | Longa; 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:
| Credencial | Depois do bloqueio no provedor de identidade | O que fecha o acesso |
|---|---|---|
| Access token | Pode valer até expirar (no Entra ID, cerca de uma hora por padrão) | Esperar a expiração ou o software checar a conta |
| Refresh token | Em geral para de gerar novos tokens; a revogação das sessões garante | Revogar as sessões no provedor de identidade |
| Sessão criada pelo software | Pode continuar aberta | Encerrar a sessão ou desativar a conta no software |
| Token de API pessoal | Depende do software; em muitos continua válido | Revogar 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 identidadeMaterial informativo. Não substitui orientação jurídica.