Microsoft 365 OAuth2

⚠️ Configuração avançada. Para Microsoft 365 recomendamos o tipo Microsoft 365 Connect: basta entrar com a caixa e autorizar.

O Microsoft 365 OAuth2 só é aconselhado a quem tem informático interno e pretende ter a configuração do lado da sua organização (por exemplo, por regras internas de segurança).

🔁 Atenção: o segredo da aplicação (client secret) expira no máximo ao fim de 24 meses. Quando expira, o envio de e-mails pára até ser criado um segredo novo e atualizado no GC. Marque a data de validade na agenda.

1. Registar a aplicação no Azure

Com uma conta de administrador, em entra.microsoft.com › Registos de aplicações / App registrations › Novo registo / New registration:

  1. Nome: por exemplo, “GC”.
  2. Tipos de conta suportados: Apenas contas neste diretório organizacional (Single tenant).
  3. URI de redirecionamento: plataforma Web, com o Redirect Uri que o GC mostra na conta (ver passo 2). Pode acrescentá-lo depois em Autenticação / Authentication.
  4. Clique em Registar. Na Descrição geral / Overview, guarde o ID da aplicação (cliente) e o ID do diretório (inquilino).
  5. Permissões de API / API permissions › Adicionar uma permissão › Microsoft Graph › Permissões delegadas: SMTP.Send, IMAP.AccessAsUser.All e offline_access.
  6. Certificados e segredos / Certificates & secrets › Novo segredo do cliente: escolha a validade (máximo 24 meses) e copie o Valor (só é mostrado uma vez).
  7. No centro de administração do Exchange, confirme que a caixa tem o SMTP autenticado ligado (Recipients › Mailboxes › a caixa › Manage email apps settings › Authenticated SMTP). Em organizações recentes também tem de estar permitido ao nível da organização (Settings › Mail flow).

2. Configurar no GC

Aceda a Administração >> Email >> Contas de Envio, clique em Adicionar e escolha o tipo Microsoft 365 OAuth2.

  1. Preencha Utilizador (o endereço da caixa), E-Mail: De, Nome, Tenant Id, Client Id e Client Secret (o Valor do segredo), e grave.
  2. O GC mostra o Redirect Uri a registar no Azure (passo 1.3).
  3. Clique em Consentimento, entre com a caixa e autorize.
  4. Clique em Testar.

📥 Ler as respostas

Com Ler e responder às respostas ligado, o GC lê a caixa por IMAP e procura as respostas só na Caixa de Entrada. Para isso, a aplicação no Azure tem de ter a permissão IMAP.AccessAsUser.All (passo 1.5) e a caixa tem de ter o IMAP ligado (Recipients › Mailboxes › a caixa › Manage email apps settings › IMAP).

Se o Testar enviar mas não conseguir ler, recomendamos mudar a conta para Microsoft 365 Connect: procura as respostas em todas as pastas e não tem segredo a renovar.

🔁 Renovar o segredo antes de expirar

  1. No Azure, na mesma aplicação, crie um novo segredo do cliente e copie o Valor.
  2. No GC, na conta de envio, substitua o Client Secret e grave (não é preciso novo consentimento).
  3. Clique em Testar e, se correu bem, apague o segredo antigo no Azure.

Para deixar de ter de renovar segredos, mude a conta para Microsoft 365 Connect.