Esta implementação não substitui a antiga integração POP3, SMT eIMAP para outros serviços de e-mail. Pode inclusive estar parametrizada para ser usada ao mesmo tempo com estas integrações.
Configuração
Os passos a seguir devem ser realizados na ordem em que estão apresentados:
Infraestrutura
Parametrização Azure
Dentro da plataforma Microsoft Azure:
Crie ou escolha um e-mail para ser utilizado pelo sistema nestas integrações. Não é necessário ser uma conta de e-mail específica, mas o usuário tem que ter ciência de que a leitura e envio de e-mails pelo sistema pode modificar e poluir esta caixa de correio. Então, deve criar regras e pastas para limpeza e organização das mensagens, a fim de que o trabalho de um não interfira no trabalho do outro;
Crie ou escolha um aplicativo no Azure Active Directory desta conta de e-mail, será utilizado para
envio e leitura de e-mails.
Defina as seguintes permissões:
Defina o acesso ao aplicativo para a conta de e-mail que será utilizada:
Permita os fluxos de cliente público para o aplicativo:
APP ID: Guarde este ID para as futuras configurações.
Pastas para leitura de e-mail: Se o usuário deseja definir pastas e regras de filtragem para a leitura da caixa de e-mail, crie-as neste momento. Nesta primeira versão do projeto Graph Mail só é realizada a varredura para identificar as pastas no momento em que é iniciado;
Service Management
WildFly 1.1.2
Usuário ActiveMQ
Defina um usuário para acesso às filas ActiveMQ executando o comando abaixo e parametrizando uma senha segura para a opção “-p” de acordo com seu ambiente:
sh add-user.sh -a -u jmsuser -p 1 -g guest
Filas ActiveMQ
No arquivo de configuração do WilfFly (standalone.xml, por exemplo) devem ser definidas as filas de leitura e envio de e-mail. Adicione as tags com seus devidos nomes de fila dentro da tag principal: <subsystem xmlns="urn:jboss:domain:messaging-activemq:3.0">
Para que o projeto Service Management suba os listeners, que irão escutar as filas da leitura de e-mail, é necessário definir a property na tag <system-properties> do standalone.xml, onde se pode colocar mais de um nome de lista
para ser ouvida, se separar por vírgula:
Pasta para compartilhamento de imagens e arquivos anexos
Deve-se criar uma pasta e definir permissões de escrita e leitura no servidor das aplicações, para o mapeamento de volume dos containers docker, que irão subir as aplicações. Assim permitem o compartilhamento de arquivos entre elas. Esta pasta será utilizada nos arquivos compose e no parâmetro 479.
Parametrização do Graph Mail
Docker
No arquivo docker-compose.yml do projeto Graph Mail deve-se definir o correto local do arquivo config.properties e da pasta definida para compartilhamento de imagens e anexos.