phpmailer_gmail_oauth2

Este módulo pretende ser um plugin que funciona com o módulo PHPMailer SMTP, fornecendo autenticação ao Gmail do Google Workspace via OAuth2. É inspirado em phpmailer_oauth2, escrito por Ian McLean (imclean). Se eu não tivesse encontrado o módulo de Ian, é improvável que tivesse tentado trabalhar em um para o Google Gmail.

IMPORTANTE: Este módulo requer o módulo Google league/oauth2-google, disponível em https://oauth2-client.thephpleague.com/providers/league/. Ele deve ser instalado no diretório do seu fornecedor.

Antes de utilizar este módulo, é necessário configurar um Client ID e Client Secret no Google. Veja como fazer isso a partir de abril de 2024 e configurar este módulo:

1. Faça login em sua conta do Google Workspace.

2. Acesse https://console.cloud.google.com/.

3. No canto superior esquerdo da página, ao lado de "Google Cloud", deverá haver um menu suspenso de projetos. Clique nele.

4. Se você não tiver projetos listados na caixa de diálogo 'Selecionar um recurso', crie um e selecione-o como seu projeto atual.

5. Clique em ‘APIs e Serviços’, um botão grande em algum lugar no centro da página.

6. Clique em Credenciais no menu que aparece no lado esquerdo da página.

7. Clique em CRIAR CREDENCIAIS e selecione 'ID do cliente OAuth'.

8. Selecione 'Aplicativo Web' para Tipo de Aplicativo.

9. Dê um nome às suas credenciais e anote o ID do cliente e o segredo do cliente. Você precisará inserir esses valores em (11) abaixo.

10. Depois de instalar este módulo, você pode encontrar o 'URI de redirecionamento autorizado' para o seu site acessando Configuração-> Sistema-> PHPMailer Gmail OAuth2 (/admin/config/system/phpmailer-gmail-oauth2). Abra essa página em uma janela separada do navegador e você encontrará o URI de redirecionamento exigido pelo Google próximo ao topo da página. Copie o URI e insira-o na caixa 'URIs de redirecionamento autorizados' na página do Google. Pressione Salvar.

11. De volta à página do Drupal, insira seu endereço de e-mail do Google, ID do cliente e segredo do cliente e pressione o botão ‘Salvar configuração’.

12. Depois de salvar suas credenciais do Google, um botão ‘Obter token de atualização’ aparecerá. Pressione esse botão para redirecionar do seu site para o Google e siga as instruções do Google.
    Quando terminar, o Google deverá emitir um token de atualização e redirecionar de volta para a página Drupal que você acabou de sair. Se tudo funcionou, você terá seu Refresh Token e estará pronto para enviar e-mail.

13. Se você encontrar problemas ao redirecionar para o Google ao pressionar o botão 'Obter token de atualização', pode ser necessário adicionar o seguinte ao seu arquivo settings.php:

    $ settings [ ' trusted_host_patterns ' ] = [ ' ^accounts.google.com$ ' ];

 If you have other trusted_host_patterns, add '^accounts.google.com$' to the array.

Alguns outros itens de configuração:

1. Não se esqueça de ir ao módulo Mail para selecionar 'PHPMailer SMTP' como seu formatador e remetente de email (/admin/config/system/mailsystem).

2. Se você tiver outros módulos, como o Commerce 2, que enviam e-mails, pode ser necessário adicioná-los na parte inferior da mesma página em (1) acima.

3. Na página de configurações de transporte SMTP do PHPMailer, selecione 'Gmail OAuth2' como seu método de autenticação SMTP (/admin/config/system/phpmailer-smtp). Defina a porta SMTP como 587 e selecione TLS como protocolo seguro.

Você pode usar o serviço 'Configuração de teste' na página de configurações de transporte SMTP do PHPMailer para verificar se a nova configuração está funcionando enviando um email de teste.