Entendendo o AADSTS700082 e os erros de refresh token expirado no OAuth da Microsoft

By Mirko Peters · 2026-04-20

Quando você encontra o erro AADSTS700082, a Microsoft está informando que o seu refresh token expirou, geralmente porque ficou parado por tempo demais sem uso. Isso acontece no sistema OAuth da Microsoft o tempo todo e causa problemas para desenvolvedores e usuários que trabalham com tudo, do Azure AD ao Microsoft 365 e ao Power Platform.

Automatically translated with AI from the original post. Read the English original

Cover: Stop OAuth Consent Attacks in Microsoft Entra ID

Em resumo, um refresh token é o que mantém a sua sessão ativa sem que você precise fazer login de novo e de novo. Quando ele expira, a maioria dos aplicativos perde a capacidade de obter um novo access token, e o acesso é bloqueado. O código de erro AADSTS700082 é a forma como a plataforma de identidade da Microsoft sinaliza esse bloqueio. Entender por que isso acontece e como as sessões OAuth são gerenciadas é o primeiro passo para restaurar o acesso sem complicações e evitar dores de cabeça no futuro.

O que causa o erro AADSTS700082: refresh token expirado por inatividade

O código de erro AADSTS700082 aparece quando o sistema OAuth da Microsoft conclui que o seu refresh token ficou obsoleto, geralmente porque não é usado há algum tempo. Não estamos falando do access token comum (que expira bem mais rápido), mas do refresh token de vida mais longa, projetado para manter você conectado nos bastidores.

Na Microsoft Identity Platform, cada refresh token tem uma vida útil máxima e um tempo limite de inatividade. Se o seu aplicativo ou usuário não usar o token para obter um novo access token dentro de determinado período (frequentemente 90 dias ou menos, dependendo das políticas), a Microsoft o marcará como expirado. Ao tentar usar esse token, você recebe o erro AADSTS700082 “the refresh token has expired due to inactivity”.

Isso pode acontecer tanto em sessões de navegador em aplicações de página única (SPAs) quanto em aplicativos nativos. A ideia básica? Se não há atividade, o token é tratado como uma assinatura de academia que ninguém usa: depois de um tempo, você deixa de ser bem-vindo até fazer a renovação. Tempos limite de sessão, regras rígidas de inatividade ou atualizações em segundo plano mal tratadas costumam levar a esse erro, frustrando tanto os usuários quanto a equipe de TI que tenta manter a autenticação funcionando sem interrupções. Conhecer a política da Microsoft ajuda você a identificar por que o erro aparece e a começar a corrigi-lo.

Causas principais da expiração de tokens na Microsoft Identity Platform

Refresh tokens expirados não acontecem por acaso: a Microsoft Identity Platform tem vários gatilhos claros embutidos no sistema. Entender o que está em jogo ajuda você a descobrir rapidamente se está diante de um limite de política, um alerta de segurança ou alguma ação administrativa.

Há mais de um fator capaz de derrubar a sua sessão. Às vezes é simplesmente a inatividade, mas em outros casos é sinal de mudanças mais profundas, como redefinição de senha, novos requisitos de MFA, revogação feita pelo administrador ou ajustes nas políticas de acesso condicional. Cada situação deixa um rastro próprio que pode orientar a sua investigação e a resposta.

Nas seções a seguir, você verá detalhes sobre as cinco principais causas de expiração de tokens. Isso vai dar clareza prática, seja você desenvolvedor, quem dá suporte a usuários ou quem protege o ambiente. Se o objetivo é apenas manter as coisas funcionando ou se você busca segurança máxima, entender o "porquê" torna a recuperação bem mais fácil.

Expiração por inatividade e políticas de vida fixa para SPAs

Expiração por inatividade: se um refresh token não for usado durante um período definido (normalmente 90 dias, mas pode ser menos com determinadas políticas), a Microsoft o marcará como expirado, independentemente de quanto tempo dure a vida útil total do token. Este é o cenário clássico de "refresh token expirado por inatividade".
Tempo de vida absoluto do token: todo refresh token também tem uma duração máxima, que não pode ser estendida apenas pela atividade. Quando esse prazo termina, geralmente um ano por padrão, o token deixa de ser válido, sem exceções.
Regras para SPAs (Single-Page Application): para SPAs, as políticas da Microsoft costumam impor vidas úteis de refresh token mais restritas e curtas, principalmente pelo risco maior associado ao armazenamento no navegador. Estratégias de renovação silenciosa não funcionam para sempre: em algum momento, os usuários serão obrigados a fazer login novamente.

Eventos de segurança de credenciais e alterações de conta que afetam os tokens

Redefinições de senha: Quando um usuário altera a senha, principalmente em ambientes híbridos ou sincronizados, todos os tokens de atualização atuais normalmente são invalidados por segurança.
Registro ou redefinição de MFA: Adicionar ou redefinir métodos de autenticação multifator dispara a expiração de todos os tokens de atualização, forçando todos a se autenticarem novamente.
Atividade de登录 suspeita: Se a Microsoft detectar logons arriscados em uma conta, a segurança pode expirar automaticamente os tokens para limitar os danos de uma possível violação.
Alterações no consentimento de OAuth: Mudanças no consentimento do OAuth podem tornar inúteis, de imediato, até os tokens de atualização legítimos. Veja como os ataques aproveitam isso em OAuth Consent Attack Explained.
Desativação ou exclusão de conta: Se a conta do usuário no Azure AD for desativada ou excluída, todos os tokens param de funcionar imediatamente, sem aviso e sem exceções.

Revogação pelo administrador e alterações de consentimento pelo usuário

Revogação de consentimento de aplicativo pelo administrador: Quando um administrador retira permissões concedidas ou executa uma remoção em massa de consentimentos, todo token de atualização vinculado a esses aplicativos é imediatamente marcado como inválido. Na próxima vez que qualquer usuário ou serviço tentar usá-los, receberá a temida mensagem de token expirado.
Retirada de consentimento pelo usuário: Se um usuário revogar o acesso de um aplicativo acessando "Meus Aplicativos" ou o portal de segurança da conta, quaisquer tokens emitidos para esse aplicativo deixam de funcionar imediatamente. Nada será renovado até que o consentimento seja concedido novamente.
Governança automatizada ou prevenção contra vazamento de dados: Ambientes corporativos podem executar tarefas regulares de governança ou responder a comportamentos suspeitos revogando à força consentimentos de aplicativos em grande escala (especialmente no Power Platform), invalidando sessões de dezenas ou centenas de usuários de uma só vez.
Aplicação de políticas de conectores: Em ambientes gerenciados do Power Platform, mudanças em políticas de conectores ou de dados podem tirar tokens de atualização de circulação, especialmente se novos limites de conformidade ou isolamento forem aplicados durante a noite.

Efeitos das políticas de Acesso Condicional e MFA na validade dos tokens

Atualizações de políticas de Acesso Condicional: Quando a TI implanta uma nova regra de acesso condicional ou altera as existentes, todos os tokens emitidos antes da mudança podem ser invalidados. Isso é especialmente comum após a ativação de novos bloqueios geográficos ou requisitos de conformidade de dispositivos.
Requisitos de MFA/autenticação em etapas adicionais: Se os requisitos de MFA forem aumentados, usuários com tokens "antigos" (anteriores à atualização) frequentemente serão obrigados a entrar novamente na próxima renovação.
Implantações amplas de políticas: A introdução em massa de políticas de acesso condicional mais abrangentes ou com prazo determinado (como discutido em Conditional Access Policy Trust Issues) provoca expiração de tokens em larga escala, em nome da segurança.
Alterações de conformidade/integridade do dispositivo: Se o estado de conformidade de um dispositivo mudar (por exemplo, quando o Intune o marca como não conforme), os tokens de atualização usados nesse dispositivo são invalidados automaticamente.

Como corrigir o erro de token de atualização expirado

Dar de cara com o erro AADSTS700082 pode parecer um beco sem saída, mas não é um problema definitivo. Corrigir um token de atualização expirado, especialmente em ambientes corporativos da Microsoft, envolve combinar um diagnóstico rápido com a compreensão de quando é preciso autenticar novamente do zero.

Esta seção apresenta suas opções. Às vezes, uma limpeza ou uma verificação dos dados da sessão resolve o problema. Em outros casos, será preciso que o usuário ou o próprio aplicativo inicie um novo fluxo OAuth e conceda o consentimento novamente.

Vamos detalhar os passos exatos de solução de problemas para identificar onde algo deu errado, desde problemas no armazenamento local até mudanças de política em toda a organização, e manter você longe de atalhos que podem sair pela culatra. Se você gerencia usuários ou apenas tenta integrar sistemas, encontrará orientações claras para uma recuperação tranquila nas próximas duas seções.

Solução de problemas e correções para tokens de atualização expirados

Limpe o armazenamento local de tokens: comece removendo caches locais ou o armazenamento do navegador onde o refresh token expirado ainda possa estar guardado. Isso elimina a chance de o aplicativo reutilizar um token que já não é válido.
Revise as políticas de duração de tokens: verifique as durações configuradas para refresh tokens e os períodos de inatividade no seu Azure AD. Ajuste essas políticas (dentro das diretrizes de segurança) para estender a validade futura dos tokens se estiverem restritivas demais.
Verifique revogações feitas por administradores ou pela segurança: analise ações administrativas recentes, como remoções de consentimento, desprovisionamento de usuários ou alterações de política em toda a organização, que possam ter invalidado todos os tokens. Somente um novo consentimento ou uma correção feita pela TI recuperará essas sessões.
Identifique alterações de credenciais ou de segurança: confirme se a senha do usuário não foi alterada e se as configurações de MFA não foram atualizadas, pois qualquer uma dessas mudanças invalida imediatamente todos os refresh tokens atuais.
Evite a substituição manual de tokens: não tente usar o token de outro usuário nem copiar tokens entre locatários. Isso raramente resolve o problema e pode sair pela culatra, com alertas de segurança da Microsoft.
Monitore problemas de inatividade: configure verificações de integridade de tokens em automações ou ferramentas de monitoramento para receber alertas antes que um grande número de tokens ultrapasse o limite de expiração por inatividade, especialmente em ambientes SaaS com vários usuários ou vários locatários.

Como reautorizar aplicativos e restaurar os detalhes da sessão

Peça que os usuários se autentiquem novamente: oriente os usuários a fazer login de forma interativa. Isso inicia o fluxo OAuth completo, gera novos tokens e restaura o acesso aos recursos protegidos.
Solicite a renovação do consentimento: se o consentimento foi revogado, os usuários precisarão conceder as permissões novamente. Para aplicativos organizacionais, pode ser necessário o consentimento de administrador.
Restaure o estado da sessão com elegância: projete seu aplicativo para detectar tokens expirados de forma adequada e redirecionar os usuários para a página de login com mensagens claras, evitando erros confusos do tipo "token expirado".
Valide a conformidade com as políticas: antes de pedir uma nova autenticação, confirme que os requisitos de Acesso Condicional, de conformidade do dispositivo e de MFA estão atendidos, para evitar loops infinitos e frustração do usuário.

Como prevenir problemas futuros de expiração de tokens em ambientes Microsoft

Se você está cansado de correr atrás de tokens expirados, é melhor agir de forma proativa. Ninguém gosta de interrupções inesperadas causadas por um refresh token esquecido que expira, especialmente em um projeto crítico de Microsoft 365, Azure ou Power Platform.

Esta seção aborda estratégias que ajudam você a se antecipar ao problema, seja usando ferramentas de automação de tokens de terceiros, criando fluxos de autenticação mais inteligentes no seu código personalizado ou configurando monitoramento que detecte riscos de sessão antes mesmo que os usuários percebam.

Ao gerenciar tanto a parte técnica quanto a parte das pessoas no OAuth, as organizações podem se proteger contra perda de produtividade e evitar chamadas urgentes ao suporte. As seções a seguir detalham a integração sem intervenção manual, boas práticas mais profundas para autenticação de APIs e o valor de deixar a automação resolver o que antes consumia horas de trabalho. Domine esses pontos, e seus aplicativos e seus usuários vão agradecer.

Renovação automática de tokens com Nango e plataformas de integração para 2026

Ciclo de vida de tokens gerenciado: plataformas como o Nango monitoram, renovam e rotacionam tokens OAuth automaticamente, eliminando a necessidade de lógica de repetição personalizada ou de tratamento manual.
Alertas de erro e expiração: essas plataformas de integração costumam oferecer alertas e painéis quando um refresh token está próximo de expirar, permitindo que você aja antes que ocorram interrupções.
Escalabilidade e segurança: usar uma ferramenta criada especificamente para orquestração de tokens significa armazenamento seguro, menor risco para os desenvolvedores e escalabilidade mais fácil em ambientes SaaS com vários locatários ou em ambientes corporativos.
Preparação para o futuro: as melhores plataformas acompanham as mudanças no fluxo de autenticação da Microsoft por você, para que você não seja pego de surpresa por uma atualização de política em 2026 ou depois.

Autenticação de API robusta: boas práticas avançadas no tratamento de tokens

Implemente a renovação silenciosa de tokens: sempre que possível, use fluxos de renovação em segundo plano ("silenciosos") para que os usuários raramente vejam telas de login, a não ser que seja absolutamente necessário.
Centralize o tratamento de erros: detecte e intercepte programaticamente erros de expiração de token, exibindo mensagens úteis que pedem nova autenticação, em vez de falhas silenciosas ou mensagens enigmáticas.
Fluxos de autenticação de contingência: Ofereça aos usuários experiências de reautenticação alternativas e com a marca da sua empresa, especialmente em cenários multilocatário ou SaaS, para que a renovação de tokens nunca interrompa o fluxo de trabalho deles.
Monitore e teste a validade dos tokens: Integre verificações regulares de integridade dos tokens tanto ao seu pipeline de CI/CD quanto aos painéis operacionais, para evitar eventos de expiração em massa.
Documente e treine: Garanta que os administradores de TI e os desenvolvedores conheçam o playbook. Não deixe o OAuth como um segredo restrito a poucos. Guias do usuário e runbooks podem salvar o dia quando as políticas mudarem ou os serviços forem atualizados.

Como encontrar ajuda e documentação sobre erros de OAuth na comunidade da Microsoft

Solucionar erros de token não é algo que você deva fazer isoladamente. O ecossistema da Microsoft é enorme, mas, se você souber onde procurar, há uma grande quantidade de recursos disponíveis, como documentação oficial, fóruns da comunidade e publicações atualizadas, prontos para ajudar você a resolver o AADSTS700082 e tudo relacionado ao OAuth.

Seja para acompanhar a mais recente mudança de política, uma análise aprofundada de cenários ou relatos de profissionais que já resolveram exatamente o mesmo problema de renovação de token, o suporte da comunidade agrega muito valor. Fóruns e discussões em destaque quase sempre trazem soluções reais que talvez você não encontre apenas na documentação da Microsoft.

Nas seções a seguir, você vai descobrir como aproveitar o melhor conteúdo de suporte: navegar por discussões em alta, filtrar anúncios novos e usar categorias ou arquivos para uma solução de problemas mais eficiente. Seja pesquisando para você mesmo ou elaborando um processo para a sua equipe, dominar essas fontes garante que você esteja sempre em dia com as melhores práticas de autenticação.

Navegando por fóruns, anúncios e conteúdos em destaque sobre OAuth da Microsoft

Analise as discussões em destaque: Os fóruns costumam sinalizar tópicos populares e problemas recentes marcados como "resolvidos", o que é ideal para encontrar soluções atualizadas para erros de expiração de token, especialmente o AADSTS700082.
Leia os anúncios oficiais: Novas implantações de políticas OAuth e mudanças de tempo de vida aparecem primeiro em postagens fixadas nos fóruns e nas seções oficiais de anúncios do Azure ou do Microsoft 365.
Use a pesquisa por palavras-chave com critério: Pesquise usando códigos de erro precisos ("AADSTS700082 refresh token expired") e nomes de produtos para encontrar postagens diretamente relacionadas ao seu problema.
Interaja com especialistas: Participe das discussões para fazer perguntas de esclarecimento ou acompanhar correções parciais. MVPs e engenheiros da Microsoft costumam responder para ajudar a resolver cenários complexos.

Usando o sumário, categorias e links para encontrar suporte técnico

Navegue por categoria: Os sites de suporte e documentação da Microsoft organizam o material de solução de problemas por produto (Azure AD, Power Platform) e tipo de erro, o que torna a busca direcionada simples.
Use o sumário para navegação rápida: Localize o sumário de uma página de documentação (geralmente à esquerda ou no topo) para ir direto às seções sobre autenticação, sessão ou detalhes de códigos de erro.
Aproveite os links de arquivo e de metainformação: Atualizações antigas de políticas e guias aprofundados de solução de problemas costumam ficar arquivados. Pesquise esses materiais para encontrar correções anteriores relevantes para a sua configuração.
Salve nos favoritos os principais artigos de suporte: Mantenha à mão os links diretos para os documentos de erro OAuth mais úteis da Microsoft, para responder rapidamente às dúvidas da sua equipe ou dos usuários.
Mantenha-se atualizado: Revise regularmente as Notas do Editor, os resumos de metainformação e as postagens de sumário para nunca perder mudanças importantes no playbook de identidade da Microsoft, que evolui rapidamente.