Skip to main content

Configuration de la messagerie pour les notifications

Pour permettre aux utilisateurs de répondre facilement et rapidement aux activités sur GitHub Enterprise Server, vous pouvez configurer your GitHub Enterprise Server instance afin d’envoyer des notifications par e-mail pour les problèmes, les demandes de tirage et les commentaires de commit.

Configuration de SMTP pour votre entreprise

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur dans le coin supérieur droit de n’importe quelle page.

    Capture d’écran de l’icône représentant une fusée qui donne accès aux paramètres d’administration du site

  2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.

    Capture d’écran du lien « Administrateur du site » 1. Dans la barre latérale gauche, cliquez sur Management Console . Onglet Management Console dans la barre latérale gauche

  3. En haut de la page, cliquez sur Paramètres. Onglet Paramètres

  4. Dans la barre latérale de gauche, cliquez sur E-mail. Onglet E-mail

  5. Sélectionnez Activer l’e-mail. Si l’e-mail sortant et entrant s’en trouvent activés, pour que l’e-mail sortant fonctionne, vous devez aussi configurer vos paramètres DNS, comme décrit ci-dessous dans « Configuration des paramètres DNS et de pare-feu pour autoriser les e-mails entrants ». Activer l’e-mail sortant

  6. Tapez les paramètres de votre serveur SMTP.

    • Dans le champ Adresse du serveur, tapez l’adresse de votre serveur SMTP.
    • Dans le champ Port, tapez le port utilisé par votre serveur SMTP pour l’envoi d’e-mail.
    • Dans le champ Domaine, tapez le nom de domaine que votre serveur SMTP enverra avec une réponse HELO, le cas échéant.
    • Sélectionnez la liste déroulante Authentification, puis choisissez le type de chiffrement utilisé par votre serveur SMTP.
    • Dans le champ Adresse e-mail sans réponse, tapez l’adresse e-mail à utiliser dans les champs De et À pour tous les e-mails de notification.
  7. Si vous souhaitez ignorer tous les e-mails entrants qui sont adressés à l’adresse e-mail sans réponse, sélectionnez Ignorer les e-mails adressés à l’adresse e-mail sans réponse. Case à cocher pour ignorer les e-mails adressés à l’adresse e-mail sans réponse

  8. Sous Support, choisissez un type de lien pour offrir un support supplémentaire à vos utilisateurs.

    • E-mail : Adresse e-mail interne.
    • URL : Lien vers un site de support interne. Vous devez inclure http:// ou https://. E-mail ou URL du support
  9. Testez la remise d’e-mail.

Test de la remise d’e-mail

  1. En haut de la section E-mail, cliquez sur Tester les paramètres d’e-mail. Tester les paramètres d’e-mail

  2. Dans le champ Envoyer un e-mail de test à, tapez l’adresse à laquelle envoyer l’e-mail de test. Tester l’adresse e-mail

  3. Cliquez sur Envoyer l’e-mail de test. Envoyer un e-mail de test

    Conseil : Si des erreurs SMTP se produisent pendant l’envoi d’un e-mail de test (par exemple, un échec de remise immédiate ou une erreur de configuration du courrier sortant), elles apparaissent dans la boîte de dialogue Paramètres de l’e-mail de test.

  4. Si l’e-mail de test échoue, corrigez vos paramètres d’e-mail.

  5. Si l’e-mail de test aboutit, au bas de la page, cliquez sur Enregistrer les paramètres. Bouton Enregistrer les paramètres 1. Attendez la fin de l’exécution de la configuration.

    Configuration de votre instance

Configuration des paramètres DNS et de pare-feu pour autoriser les e-mails entrants

Si vous souhaitez autoriser les réponses par e-mail aux notifications, vous devez configurer vos paramètres DNS.

  1. Vérifiez que le port 25 de l’instance est accessible à votre serveur SMTP.
  2. Créez un enregistrement A qui pointe vers reply.[hostname]. Selon la configuration de votre fournisseur DNS et de l’hôte de votre instance, vous pourrez peut-être créer un enregistrement A unique qui pointe vers *.[hostname].
  3. Créez un enregistrement MX qui pointe vers reply.[hostname] de sorte que les e-mails adressés à ce domaine soient routés vers l’instance.
  4. Créez un enregistrement MX qui fait pointer noreply.[hostname] vers [hostname] de sorte que les réponses à l’adresse cc dans les e-mails de notification soient routés vers l’instance. Pour plus d’informations, consultez « Configuration des notifications ».

Résolution des problèmes de remise d’e-mail

Créer un bundle de support

Si vous ne pouvez pas déterminer l’origine du problème à la lecture du message d’erreur affiché, vous pouvez télécharger un bundle de support contenant l’intégralité de la conversation SMTP entre votre serveur de messagerie et GitHub Enterprise Server. Une fois que vous avez téléchargé et extrait le bundle, examinez l’ensemble du journal de conversation SMTP et les erreurs associées dans les entrées de enterprise-manage-logs/unicorn.log.

Vous devriez trouver dans le journal unicorn une transaction comparable à celle-ci :

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"

Voici ce que ce journal révèle de l’appliance :

  • Elle a ouvert une connexion avec le serveur SMTP (Connection opened: smtp.yourdomain.com:587).
  • Elle a réussi à établir une connexion et a choisi d’utiliser TLS (TLS connection started).
  • Le type d’authentification login a été utilisé (<- "AUTH LOGIN\r\n").
  • Le serveur SMTP a rejeté l’authentification comme étant non valide (-> "535-5.7.1 Username and Password not accepted.).

Vérifier les journaux de your GitHub Enterprise Server instance

Si vous avez besoin de vérifier que votre e-mail entrant fonctionne, vous pouvez examiner deux fichiers journaux sur votre instance : /var/log/mail.log et /var/log/mail-replies/metroplex.log.

/var/log/mail.log vérifie que les messages parviennent à votre serveur. Voici un exemple de réponse par e-mail ayant abouti :

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]

Notez que le client commence par se connecter, puis la file d’attente devient active. Ensuite, le message est remis, le client est supprimé de la file d’attente, puis la session se déconnecte.

/var/log/mail-replies/metroplex.log indique si les e-mails entrants sont traités pour être ajoutés aux problèmes et aux demandes de tirage comme réponses. Voici un exemple de message ayant abouti :

[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

Vous remarquerez que metroplex l’intercepte le message entrant, le traite, puis déplace le fichier vers /data/user/incoming-mail/success.

Vérifier vos paramètres DNS

Afin de traiter correctement les e-mails entrants, vous devez configurer un enregistrement A valide (ou CNAME) ainsi qu’un enregistrement MX. Pour plus d’informations, consultez « Configuration des paramètres DNS et de pare-feu pour autoriser les e-mails entrants ».

Vérifier les paramètres du pare-feu ou du groupe de sécurité AWS

Si your GitHub Enterprise Server instance se trouve derrière un pare-feu ou est servi via un groupe de sécurité AWS, vérifiez que le port 25 est ouvert à tous les serveurs de messagerie qui envoient des e-mails à reply@reply.[hostname].

Contacter le support technique

Si vous ne parvenez toujours pas à résoudre le problème, contactez GitHub Enterprise Support. Joignez le fichier de sortie de http(s)://[hostname]/setup/diagnostics à votre e-mail pour nous aider à résoudre votre problème.