# Configurando o provedor de e-mail

O Qlik NPrinting pode distribuir seus relatórios anexando-os a mensagens de e-mail.

O NPrinting oferece suporte a SMTP ou Microsoft 365 provedores de e-mail.

## Melhores práticas

Quando você configura um provedor de e-mail para distribuir relatórios do Qlik NPrinting via e-mail, considere as seguintes melhores práticas para configuração e solução de problemas:

* Verifique o limite de tamanho de anexo do provedor de e-mail e modifique-o ou desative-o se possível. Os relatórios do Qlik NPrinting podem ser consideravelmente grandes em tamanho e às vezes podem exceder o limite de tamanho de anexos definido pelo provedor de e-mail.

  Nota informativaAlguns provedores do SMTP impõem limites de tamanho nos anexos de e-mail. O tamanho máximo permitido varia entre os provedores. Se o tamanho de um arquivo anexado exceder o limite, o e-mail não será entregue. Um aviso é adicionado nos logs.
* Alguns provedores de e-mail limitam o número de e-mails que um usuário pode enviar durante um determinado período de tempo. Se um usuário enviar mais e-mails do que o limite definido, os e-mails que excederem o limite não serão entregues. Modifique ou desabilite essa configuração quando possível.
* Verifique a configuração anti-spam do provedor de e-mail e verifique se os e-mails podem ser enviados com sucesso a todos os usuários do Qlik NPrinting. Se o provedor de e-mail só permitir o envio de e-mails para uma lista de permissões de usuários, certifique-se de que todos os usuários Qlik NPrinting necessários estejam registrados na lista de permissões.
* Adicione o IP do servidor do Qlik NPrinting e o endereço do remetente padrão do Qlik NPrinting à lista de permissões do provedor de e-mail, se necessário.
* Se o provedor de e-mail só permite a entrega de e-mails dentro de uma organização, conceda aos Qlik NPrinting usuários o direito de enviar e-mails para fora da organização, se necessário.
* Se você deseja configurar endereços de remetentes personalizados, as configurações do seu provedor de e-mail devem permitir que os usuários enviem e-mails usando endereços de e-mail diferentes daqueles que lhes foram atribuídos.
* Ao usar um cluster de provedor de e-mail, certifique-se de que a autenticação seja distribuída corretamente do proxy do SMTP para todos os servidores que fazem parte do cluster.
* Ao encontrar problemas com a entrega de e-mail, verifique os arquivos de log do Qlik NPrinting scheduler service e os arquivos de log do provedor de e-mail com a ajuda do seu administrador do provedor de e-mail.

## SMTP Configurações de e-mail

Primeiro, é necessário definir parâmetros de SMTP, incluindo endereço do servidor de e-mail de saída e número da porta. Pode ser necessário definir os parâmetros de nome de usuário e de senha, se o servidor exigir autenticação.

Faça o seguinte:

1. No menu superior, clique em Admin e selecione Configurações.

2. Clique em E-mail.

3. Digite um nome e uma descrição para as configurações de e-mail.

4. Clique SMTP.

5. Digite o endereço do servidor de e-mail SMTP de saída na caixa de texto Endereço.

6. Digite o número da porta.

7. Marque a caixa de seleção para:

   * Usar TLS (transport layer security), caso seu servidor SMTP exija o uso do Transport Layer Security. As portas padrão são 25 e 587.

   * Usar SSL (Secure Sockets Layer) caso seu servidor SMTP exija que a sessão inteira seja criptografada usando SSL. A porta padrão é 465.

   * Desabilitar validação de certificados: Se você não quiser validar certificados.

8. Especifique o Nome de usuário e a Senha exigidos para a autenticação.

9. Configure o endereço de E-mail de remetente padrão para uso ao enviar mensagens de e-mail.

10. Insira um Endereço de e-mail de teste e clique em Enviar e-mail de teste para verificar se a configuração SMTP funciona. Um e-mail com um carimbo de data/hora é enviado ao endereço especificado para confirmar.

11. Clique Atualizar.

## Microsoft 365 Configurações de e-mail

Ao configurar Microsoft 365 como provedor de e-mail para Qlik NPrinting, você precisa fornecer ID do locatário, ID do cliente e segredo do cliente. Esses detalhes fazem parte do processo de autenticação OAuth 2.0, garantindo a comunicação segura entre seu aplicativo e o Microsoft 365.

Nota informativa

Se você estiver usando a conexão de serviço SMTP do Microsoft 365, revise os limites específicos para uma única caixa de correio em [Limites de aceleração específicos do serviço Microsoft Graph](https://learn.microsoft.com/en-us/graph/throttling-limits#outlook-service-limits) em "limites de serviço do Outlook".

Faça o seguinte:

1. No menu superior, clique em Admin e selecione Configurações.

2. Clique em E-mail.

3. Digite um nome e uma descrição para as configurações de e-mail.

4. Selecionar Microsoft 365.

5. Para ID do Locatário, insira o identificador exclusivo atribuído ao seu Microsoft 365 locatário.

6. Insira o ID do Cliente e o segredo do Cliente para o registro do seu aplicativo do Active Directory. Estes são usados para autenticação com o serviço de e-mail.

7. Insira o endereço de e-mail do remetente.

   Este deve ser um UserPrincipalName (UPN) para uma conta de usuário do Microsoft Entra ID. O endereço de e-mail que os destinatários verão no campo De do e-mail será o endereço de e-mail completo do usuário.

   Nota informativa

   Você pode restringir o remetente a caixas de correio específicas. Para obter mais informações, consulte [Limitar permissões de aplicativo a caixas de correio específicas do Exchange Online](https://learn.microsoft.com/en-gb/graph/auth-limit-mailbox-access).

8. Clique Salvar para ativar o provedor de e-mail.

   Nota informativaSe você tiver um provedor previamente ativo, ele será desativado.

9. Insira o endereço de e-mail onde você deseja receber uma mensagem de teste e clique em Enviar e-mail de teste.

   Se a configuração estiver correta, você deve receber um e-mail com um carimbo de data/hora para confirmar.

### Obtendo o ID do locatário, o ID do cliente e o segredo do cliente

Para encontrar o ID do locatário, faça login no centro de administração do Microsoft Entra e vá para Identidade > Visão geral. O ID do Locatário é exibido na guia Propriedades.

Para obter o ID do cliente e o segredo do cliente, você precisa criar um novo registro de aplicativo no Microsoft Entra ID. Depois que o aplicativo for criado, faça o seguinte:

1. Vá para a página de visão geral do aplicativo e copie o ID do Aplicativo (cliente).

2. Vá para Certificados e segredos > Segredos do cliente e selecione Novo segredo do cliente. Copie o segredo e armazene-o em segurança.

Você também precisa adicionar permissão do Microsoft Graph para enviar e-mails.

1. Vá para permissões da API e clique em Adicionar uma permissão.

2. Em APIs da Microsoft, clique em Microsoft Graph e selecione Permissões de aplicativo.

3. Adicione a permissão Mail.Send.

Para obter mais informações, consulte os seguintes artigos do Microsoft Learn:

* [Como encontrar seu ID de locatário do Microsoft Entra](https://learn.microsoft.com/en-us/entra/fundamentals/how-to-find-tenant)

* [Guia de Início Rápido: Registrar um aplicativo com a plataforma de identidade da Microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app)

* [Início Rápido: Configurar um aplicativo cliente para acessar uma API da Web > Permissão de aplicativo para o Microsoft Graph](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-configure-app-access-web-apis#application-permission-to-microsoft-graph)