Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Esta versão do GitHub Enterprise será descontinuada em 2023-03-15. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Configurar notificações de e-mail

Para facilitar a resposta rápida dos usuários à atividade em GitHub Enterprise Server, você pode configurar o your GitHub Enterprise Server instance para enviar notificações por email para comentários sobre problemas, solicitações de pull e commits.

Configurar SMTP para sua empresa

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Management Console . Guia Management Console na barra lateral esquerda

  3. Na parte superior da página, clique em Configurações. Guia Configurações

  4. Na barra lateral esquerda, clique em Email. Guia Email

  5. Selecione Habilitar email. Isso habilitará os emails de saída e de entrada. No entanto, para que os emails de entrada funcionem, defina também as configurações de DNS, conforme descrito em "Como definir as configurações de DNS e de firewall para permitir emails de entrada". Habilitar email de saída

  6. Digite as configurações para o seu servidor SMTP.

    • No campo Endereço do servidor, digite o endereço do servidor SMTP.
    • No campo Porta, digite a porta que o servidor SMTP usa para enviar emails.
    • No campo Domínio, digite o nome de domínio que o servidor SMTP enviará com a resposta HELO, se houver.
    • Selecione o menu suspenso Autenticação e escolha o tipo de criptografia usado pelo servidor SMTP.
    • No campo Endereço de email no-reply, digite o endereço de email a ser usado nos campos De e Para em todos os emails de notificação.
  7. Caso deseje descartar todos os emails recebidos destinados ao endereço no-reply, selecione Descartar emails recebidos no endereço de email no-reply. Caixa de seleção usada para descartar emails destinados ao endereço de email no-reply

  8. Em Suporte, escolha um tipo de link para oferecer suporte adicional aos usuários.

    • Email: um endereço de email interno.
    • URL: um link para um site de suporte interno. Inclua http:// ou https://. Email ou URL de suporte
  9. Teste da entrega de emails.

Testar a entrega de e-mails

  1. Na parte superior da seção Email, clique em Configurações de email de teste. Configurações de email de teste

  2. No campo Enviar email de teste para, digite um endereço que receberá o email de teste. Testar endereço de email

  3. Clique em Enviar email de teste. Enviar email de teste

    Dica: se ocorrerem erros de SMTP durante o envio de um email de teste, como falha de entrega imediatas ou erro de configuração de email de saída, você os verá na caixa de diálogo Configurações de email de teste.

  4. Se o email de teste falhar, resolva os problemas das configurações de email.

  5. Quando o email de teste for concluído com sucesso, clique em Salvar configurações na parte inferior da página. Botão Salvar configurações 1. Aguarde a conclusão da execução de suas configurações.

    Configurar a instância

Configurar DNS e firewall para o recebimento de e-mails

Se quiser permitir o recebimento de respostas para os e-mails de notificação, você deverá definir suas configurações DNS.

  1. A porta 25 da instância deve estar acessível para o seu servidor SMTP.
  2. Crie um registro A que aponta para reply.[hostname]. Dependendo do provedor DNS e da configuração do host da instância, você poderá criar um registro A individual que aponta para *.[hostname].
  3. Crie um registro MX que aponta para reply.[hostname], de modo que os emails desse domínio sejam roteados para a instância.
  4. Crie um registro MX que aponta noreply.[hostname] para [hostname], de modo que as respostas ao endereço cc em emails de notificação sejam roteadas para a instância. Para obter mais informações, confira "Como configurar notificações".

Resolver problemas na entrega de e-mails

Criar um pacote de suporte

Se não for possível determinar o que há de errado na mensagem de erro exibida, baixe um pacote de suporte que contém toda a conversa SMTP entre o servidor de email e o GitHub Enterprise Server. Depois de baixar e extrair o pacote, verifique as entradas em enterprise-manage-logs/unicorn.log em busca do log de toda a conversa SMTP e dos erros relacionados.

O log unicorn mostrará uma transação semelhante a esta:

This is a test email generated from https://10.0.0.68/setup/settings
Connection opened: smtp.yourdomain.com:587
-> "220 smtp.yourdomain.com ESMTP nt3sm2942435pbc.14\r\n"
<- "EHLO yourdomain.com\r\n"
-> "250-smtp.yourdomain.com at your service, [1.2.3.4]\r\n"
-> "250-SIZE 35882577\r\n"
-> "250-8BITMIME\r\n"
-> "250-STARTTLS\r\n"
-> "250-ENHANCEDSTATUSCODES\r\n"
-> "250 PIPELINING\r\n"
<- "STARTTLS\r\n"
-> "220 2.0.0 Ready to start TLS\r\n"
TLS connection started
<- "EHLO yourdomain.com\r\n"
-> "250-smtp.yourdomain.com at your service, [1.2.3.4]\r\n"
-> "250-SIZE 35882577\r\n"
-> "250-8BITMIME\r\n"
-> "250-AUTH LOGIN PLAIN XOAUTH\r\n"
-> "250-ENHANCEDSTATUSCODES\r\n"
-> "250 PIPELINING\r\n"
<- "AUTH LOGIN\r\n"
-> "334 VXNlcm5hbWU6\r\n"
<- "dGhpc2lzbXlAYWRkcmVzcy5jb20=\r\n"
-> "334 UGFzc3dvcmQ6\r\n"
<- "aXRyZWFsbHl3YXM=\r\n"
-> "535-5.7.1 Username and Password not accepted. Learn more at\r\n"
-> "535 5.7.1 http://support.yourdomain.com/smtp/auth-not-accepted nt3sm2942435pbc.14\r\n"

Esse log mostra que o appliance:

  • Abriu uma conexão com o servidor SMTP (Connection opened: smtp.yourdomain.com:587).
  • Fez uma conexão com sucesso e optou por usar o TLS (TLS connection started).
  • Foi realizado o tipo de autenticação login (<- "AUTH LOGIN\r\n").
  • O servidor SMTP rejeitou a autenticação como inválida (-> "535-5.7.1 Username and Password not accepted.).

Verificar os logs do your GitHub Enterprise Server instance

Caso precise verificar o funcionamento dos emails de entrada, há dois arquivos de log que você pode verificar na instância: /var/log/mail.log e /var/log/mail-replies/metroplex.log.

/var/log/mail.log verifica se as mensagens estão chegando ao servidor. Veja um exemplo de resposta de e-mail com êxito:

Oct 30 00:47:18 54-171-144-1 postfix/smtpd[13210]: connect from st11p06mm-asmtp002.mac.com[17.172.124.250]
Oct 30 00:47:19 54-171-144-1 postfix/smtpd[13210]: 51DC9163323: client=st11p06mm-asmtp002.mac.com[17.172.124.250]
Oct 30 00:47:19 54-171-144-1 postfix/cleanup[13216]: 51DC9163323: message-id=<b2b9c260-4aaa-4a93-acbb-0b2ddda68579@me.com>
Oct 30 00:47:19 54-171-144-1 postfix/qmgr[17250]: 51DC9163323: from=<tcook@icloud.com>, size=5048, nrcpt=1 (queue active)
Oct 30 00:47:19 54-171-144-1 postfix/virtual[13217]: 51DC9163323: to=<reply+i-1-1801beb4df676a79250d1e61e54ab763822c207d-5@reply.ghe.tjl2.co.ie>, relay=virtual, delay=0.12, delays=0.11/0/0/0, dsn=2.0.0, status=sent (delivered to maildir)
Oct 30 00:47:19 54-171-144-1 postfix/qmgr[17250]: 51DC9163323: removed
Oct 30 00:47:19 54-171-144-1 postfix/smtpd[13210]: disconnect from st11p06mm-asmtp002.mac.com[17.172.124.250]

Observe que o cliente se conecta e depois a fila fica ativa. Em seguida, a mensagem é entregue, o cliente é removido da fila e a sessão é desconectada.

/var/log/mail-replies/metroplex.log mostra se os emails de entrada estão sendo processados para serem adicionados a problemas e solicitações de pull como respostas. Veja um exemplo de mensagem com êxito:

[2014-10-30T00:47:23.306 INFO (5284) #] metroplex: processing <b2b9c260-4aaa-4a93-acbb-0b2ddda68579@me.com>
[2014-10-30T00:47:23.333 DEBUG (5284) #] Matched /data/user/mail/reply/new/1414630039.Vfc00I12000eM445784.ghe-tjl2-co-ie
[2014-10-30T00:47:23.334 DEBUG (5284) #] Moving /data/user/mail/reply/new/1414630039.Vfc00I12000eM445784.ghe-tjl2-co-ie => /data/user/incoming-mail/success

Você observará que metroplex captura a mensagem de entrada, processa-a e move o arquivo para /data/user/incoming-mail/success.

Verificar as configurações DNS

Para processar corretamente os e-mails de entrada, você deve configurar um registro A válido (ou CNAME) e um registro MX. Para obter mais informações, confira "Como definir as configurações de DNS e de firewall para permitir emails de entrada".

Verificar as configurações de firewall ou grupo de segurança do AWS

Se a your GitHub Enterprise Server instance estiver protegida por um firewall ou estiver sendo fornecida por meio de um grupo de segurança da AWS, verifique se a porta 25 está aberta para todos os servidores de email que enviam mensagens para reply@reply.[hostname].

Contate o suporte

Se você ainda não conseguir resolver o problema, entre em contato com o GitHub Enterprise Support. Anexe o arquivo de saída do http(s)://[hostname]/setup/diagnostics ao email para nos ajudar a solucionar o problema.