Até o fim de dezembro de 2026, o comportamento do Basic Auth no SMTP AUTH do Exchange Online permanece como está; valide OAuth, submissão SMTP e recebimento como etapas separadas. Esta recomendação vale para testes do seu próprio aplicativo em um tenant Microsoft 365 autorizado, não para presumir que uma autenticação bem-sucedida prova a entrega.

Este guia é para desenvolvedores independentes que testam notificações ou mensagens de cadastro do próprio produto. Também serve para aplicações e QA que estão validando o envio OAuth ou revendo o fluxo de testes SMTP.

Última atualização: 27 de outubro de 2026. Conferimos a política na publicação mais recente da equipe Exchange da Microsoft sobre o cronograma do Basic Auth e comparamos os detalhes técnicos com a documentação Microsoft Learn sobre OAuth para SMTP e configurações do SMTP AUTH.

Antes do teste: compare o ambiente e a evidência que você precisa

Comece definindo qual conta envia a mensagem e qual resultado o teste deve provar. Um tenant Microsoft 365 com Exchange Online não é a mesma coisa que uma conta pessoal Outlook.com. As configurações administrativas e o contexto de autenticação diferem; não use uma experiência com uma conta pessoal para concluir que as configurações do tenant estão corretas.

Escolha primeiro o alvo de validação:

  • Autenticação OAuth: o aplicativo obteve um token adequado e o apresentou no fluxo de autenticação SMTP?
  • Submissão: a conexão autenticada enviou a mensagem e o servidor aceitou a solicitação?
  • Recebimento: o endereço de teste recebeu a mensagem correspondente à execução?

Essas perguntas descrevem resultados diferentes. Uma chamada do aplicativo pode terminar sem erro local e ainda falhar na conexão SMTP. O servidor pode aceitar a submissão sem que a mensagem apareça na caixa de entrada do destinatário. Filtros, quarentena, regras de transporte ou problemas no endereço podem interferir depois da aceitação.

O que fazer se a autenticação OAuth passou, mas o e-mail de teste não chegou? Não repita a configuração do token como se ela provasse entrega. Verifique se o aplicativo iniciou a submissão, examine a resposta do servidor e procure a mensagem no endereço controlado, incluindo spam ou quarentena. A sequência das evidências mostra em que ponto investigar.

Também registre se o teste usa SMTP AUTH ou outro método de envio. A documentação Microsoft descreve SMTP AUTH no Exchange Online e suas configurações; não misture isso com a configuração de uma integração que usa outra API ou outro protocolo. A Microsoft explica opções de envio por aplicação na página sobre configuração de SMTP para um aplicativo ou dispositivo.

Preparação: confira permissões e o escopo das configurações

Antes de executar o envio, confirme como o aplicativo está autorizado. O fluxo varia conforme o modelo de autorização. Permissões delegadas e permissões de aplicação não são intercambiáveis, e o consentimento necessário depende das permissões solicitadas e da política da organização. Consulte a documentação de permissões e consentimento da plataforma de identidade Microsoft e confronte-a com o cenário SMTP documentado pela Microsoft.

Na prática, confirme estes itens com a pessoa que administra o tenant:

  • A aplicação registrada é a que o ambiente de teste realmente usa.
  • O fluxo de autorização escolhido corresponde ao tipo de aplicação e ao contexto de envio.
  • As permissões solicitadas permitem o uso pretendido, e o consentimento exigido foi concedido.
  • A caixa postal de envio e o tenant pertencem ao ambiente autorizado.
  • O uso de SMTP AUTH está permitido tanto no escopo organizacional quanto no da caixa postal, quando aplicável.

A Microsoft documenta controles de SMTP AUTH no nível da organização e da caixa postal. Uma configuração habilitada em um escopo não elimina a possibilidade de uma política ou configuração no outro impedir o teste. Confira os dois níveis na documentação de configuração do SMTP AUTH no Exchange Online.

Isso também evita uma conclusão enganosa: SMTP AUTH habilitado não significa que o Basic Auth continuará disponível indefinidamente. SMTP AUTH é o recurso de submissão autenticada; OAuth e Basic Auth são métodos de autenticação diferentes. A política de descontinuação do Basic Auth não deve ser interpretada como uma afirmação de que o protocolo SMTP AUTH desaparecerá na mesma data.

Como parte da higiene dos dados, use destinatários controlados e conteúdo de teste sem dados pessoais reais. Não coloque informações de clientes, funcionários ou credenciais em mensagens de teste. Para estruturar esse cuidado no ambiente de desenvolvimento, veja as práticas para proteger dados de teste.

Autorização: separe a política do tenant do resultado do aplicativo

Antes de solicitar um token, anote o modo de autorização que seu aplicativo usa e confira a documentação específica desse fluxo. Não copie permissões de um exemplo de outro tipo de aplicação sem verificar se elas correspondem ao uso real. A Microsoft descreve como autenticar aplicações IMAP, POP e SMTP com OAuth; use as instruções dessa documentação para confirmar o escopo aplicável ao seu caso.

Mantenha também os registros de forma segura. Guarde o identificador da execução, o horário, o ambiente, a conta remetente e o resultado da solicitação, mas não registre o token completo nem credenciais em texto aberto. Se precisar compartilhar logs com QA ou suporte, remova segredos e dados pessoais antes.

Uma distinção útil durante a triagem:

  • Falha ao obter ou usar o token: investigue autorização, permissões, consentimento, identidade da aplicação e validade do token.
  • Token obtido, mas autenticação SMTP recusada: confira se o token é adequado ao SMTP AUTH e se o método e as configurações do tenant correspondem ao fluxo.
  • Autenticação aceita: avance para verificar a submissão; não marque o teste de e-mail como entregue.

O sinal de sucesso de uma etapa deve permanecer vinculado à etapa. Uma resposta positiva de autenticação não é um comprovante de mensagem enviada, assim como um registro de chamada iniciada não é um comprovante de recebimento.

Autenticação: confirme que o token foi usado na conexão SMTP

Execute o aplicativo no mesmo ambiente e com a mesma configuração que você pretende validar. Confirme que ele obteve um token para o cenário SMTP documentado, abriu a conexão esperada e usou OAuth na autenticação. Se o processo ainda recorre a usuário e senha, isso não demonstra que OAuth está funcionando.

Registre o resultado observável da autenticação: a execução identificável, a conta usada, a resposta relevante do cliente ou servidor e o horário. Não copie tokens para relatórios, capturas de tela, tickets ou exemplos de código. Quando há várias contas ou ambientes, identifique-os sem expor segredos, para que uma autenticação bem-sucedida em desenvolvimento não seja atribuída por engano à configuração de produção.

Como distinguir uma falha OAuth de uma falha na submissão SMTP? Observe em que fase o fluxo parou. Se o token não foi obtido ou a autenticação da conexão foi rejeitada, a falha está antes do envio. Se o servidor autenticou a conexão, mas recusou a solicitação de envio, investigue a submissão e as configurações da caixa postal ou do tenant. Se o servidor aceitou a submissão, mas o destinatário não vê a mensagem, passe à verificação de recebimento e de processamento posterior.

Esse recorte evita que a equipe altere permissões quando o problema está no destinatário, ou que troque o endereço de teste quando a conexão nem chegou a autenticar.

Submissão: procure uma resposta do servidor, não apenas sucesso no aplicativo

Dispare uma mensagem controlada a partir do próprio produto. Use um identificador exclusivo no assunto ou no corpo, sem incluir dados pessoais. Assim, a equipe consegue relacionar a mensagem observada com a execução certa, mesmo quando há vários testes em andamento.

Registre, em conjunto:

  1. O identificador da execução e o ambiente.
  2. A conta remetente e o destinatário controlado.
  3. O resultado da autenticação.
  4. A resposta obtida durante a submissão SMTP.
  5. O resultado da inspeção do endereço destinatário.

Se o aplicativo informar “envio iniciado”, procure a evidência de que a solicitação chegou ao servidor. Se o servidor recusar a submissão, salve a resposta e o contexto relevante para a análise. Não trate uma resposta positiva de autenticação como se fosse aceitação da mensagem.

Se o SMTP AUTH aceitou a mensagem, como confirmar o recebimento real? Confira o endereço controlado e procure a mensagem pelo identificador exclusivo. Verifique também spam e quarentena, caso tenha acesso. Confirme que o remetente, o conteúdo e o momento correspondem à execução. A aceitação pelo servidor é evidência de submissão, não prova de que a mensagem ficou visível na caixa de entrada.

Recebimento: valide o endereço e o conteúdo da execução

Use um destinatário que a equipe possa inspecionar e controlar. Confirme que a caixa ou endereço não está sendo compartilhado com testes alheios, e não dependa de uma mensagem antiga que tenha assunto parecido. No resultado, registre se a mensagem foi encontrada, em qual pasta e se o conteúdo corresponde ao identificador da execução.

Quando a mensagem contém um link de validação ou uma notificação acionável, confira se o conteúdo está legível e se o link esperado está presente. Isso demonstra que a mensagem recebida naquela execução contém o material necessário ao fluxo. Não comprova, por si só, que todas as caixas de entrada externas ou o ambiente de produção terão o mesmo resultado.

Uma checagem de recebimento é uma observação limitada ao destinatário, à configuração e ao momento do teste. Ela não é uma garantia de entrega universal. Para reduzir confusão entre atraso e falha, a equipe pode adotar um endereço controlado e registrar o tempo de observação junto com o resultado. As orientações sobre como investigar atrasos na chegada de e-mails ajudam a documentar essa verificação sem transformar uma única observação em promessa de desempenho.

Revisão: compare as etapas e atualize o teste de Basic Auth

Segundo o cronograma publicado pela equipe Exchange da Microsoft em 27 de janeiro de 2026, o comportamento do Basic Auth para SMTP AUTH no Exchange Online permanece inalterado até o fim de dezembro de 2026. Depois desse período, a Microsoft prevê que tenants existentes terão o Basic Auth desativado por padrão, com possibilidade de habilitação pelo administrador; novos tenants não terão esse método disponível por padrão. A Microsoft planeja anunciar a data final de remoção no segundo semestre de 2027. Consulte o anúncio oficial com o cronograma atualizado antes de alterar seus testes: cronogramas anteriores ou resumos de terceiros não substituem a publicação oficial mais recente.

Para equipes que ainda têm testes baseados em Basic Auth, isso significa que a aprovação atual não valida a estratégia futura. Mantenha um teste OAuth separado, documente dependências e revise a configuração quando a Microsoft atualizar a política. Não desative mecanismos de segurança nem habilite autenticação legada apenas para fazer uma execução passar sem autorização administrativa.

A tabela abaixo serve para decidir qual evidência coletar antes de marcar uma etapa como aprovada:

Etapa O que comprova O que não comprova Próxima ação se falhar
OAuth O fluxo de autenticação do aplicativo foi aceito Que a mensagem foi submetida ou recebida Conferir token, permissões, consentimento e configuração SMTP
Submissão SMTP O servidor respondeu à solicitação de envio Que o destinatário recebeu ou viu a mensagem Revisar resposta, caixa postal, tenant e destinatário
Recebimento controlado O endereço de teste encontrou a mensagem daquela execução Entrega em produção ou em todos os serviços de e-mail Registrar pasta, conteúdo e ambiente; repetir em condições controladas

E use esta comparação para escolher o método de teste conforme o objetivo, sem misturar validação funcional com simulação:

Abordagem Vantagem Limite Quando usar
Endereço de teste controlado Permite verificar mensagem, conteúdo e link no destino O resultado representa apenas aquele ambiente e destinatário Validar o fluxo de ponta a ponta do produto
Captura ou interceptação no ambiente de teste Evita enviar mensagens reais durante testes automatizados Não demonstra recebimento por um serviço externo Testar geração e conteúdo sem validar a entrega externa
Registro de submissão do aplicativo Facilita diagnosticar chamadas e respostas do fluxo SMTP Não confirma que a caixa destinatária recebeu a mensagem Investigar falhas antes da etapa de recebimento

O que muda para ambientes de teste com Basic Auth? Até o fim de dezembro de 2026, a publicação citada informa que o comportamento permanece inalterado; depois, os padrões para tenants existentes e novos mudam conforme o cronograma oficial. Portanto, não remova um teste OAuth nem considere o Basic Auth uma opção permanente. Revalide o cronograma antes de cada mudança de política ou de configuração.

No fechamento da execução, dê um estado independente a cada fase: autenticação aprovada ou pendente; submissão aprovada ou pendente; recebimento observado ou não confirmado. Esse relatório é mais útil do que um único “e-mail enviado”, pois mostra se a equipe precisa revisar identidade, configuração SMTP ou a caixa destinatária.

Se você precisa confirmar o recebimento de mensagens do seu próprio produto, um endereço controlado é uma das opções de teste. O fwdtemp pode ser considerado nesse cenário, sem substituir a verificação do ambiente de produção nem garantir entrega. Para avaliar o uso de um endereço separado em desenvolvimento, consulte as orientações de escolha de endereço para cadastro e testes e aplique o mesmo critério: registre o que foi observado, sem confundir autenticação, submissão e recebimento.

Comece pelo recebimento temporário

Crie um e-mail descartável para receber códigos e avisos online; quando precisar manter o contato, mude para o encaminhamento de e-mails.

Abrir caixa de entrada temporária