E-Mail für Benachrichtigungen konfigurieren

In diesem Handbuch

• SMTP konfigurieren
• DNS- und Firewalleinstellungen zum Zulassen eingehender E-Mails konfigurieren
• E-Mail-Zustellung testen
• Fehlerbehebung bei der E-Mail-Zustellung

SMTP konfigurieren

1. In the upper-right corner of any page, click .

   

2. In the left sidebar, click Managementkonsole.

   

3. Klicken Sie im oberen Bereich der Seite auf Settings (Einstellungen).

   

4. Klicken Sie auf der linken Seitenleiste auf Email (E-Mail).

   

5. Wählen Sie Enable email (E-Mail aktivieren) aus. Dadurch werden aus- und eingehende E-Mails aktiviert. Damit eingehende E-Mails funktionieren, müssen Sie jedoch auch Ihre DNS-Einstellungen konfigurieren, wie dies im Folgenden unter „DNS- und Firewalleinstellungen zum Zulassen eingehender E-Mails konfigurieren“ beschrieben ist.

   

6. Tragen Sie die Einstellungen für Ihren E-Mail-Server ein:

   • Geben Sie im Feld Server address (Serveradresse) die Adresse Ihres SMTP-Servers ein.
   • Geben Sie im Feld Port den Port ein, der von Ihrem SMTP-Server zum Senden von E-Mails verwendet wird.
   • Geben Sie im Feld Domain den Domain-Namen ein, der ggf. von Ihrem SMTP-Server mit einer HELO-Antwort gesendet wird.
   • Wählen Sie im Dropdownmenü Authentication (Authentifizierung) den von Ihrem SMTP-Server verwendeten Verschlüsselungstyp aus.
   • Geben Sie im Feld No-reply email address („no-reply“-E-Mail-Adresse) die E-Mail-Adresse ein, die für alle Benachrichtigungs-E-Mails in den Feldern „From“ (Von) und „To“ (An) verwendet werden soll.

   Note: If you select the Send from author checkbox in a repository’s Services email webhook, outbound email for that repository will send from the author and not from the no-reply email address. Weitere Informationen finden Sie unter „Informationen zu E-Mail-Service-Benachrichtigungen für Pushes an Ihr Repository“.

7. Wenn Sie alle eingehenden E-Mails verwerfen möchten, die an die „no-reply“-E-Mail-Adresse adressiert sind, sollten Sie Discard email addressed to the no-reply email address (An die „no-reply“-E-Mail-Adresse adressierte E-Mails verwerfen) aktivieren.

   

8. Wählen Sie unter Support (Unterstützung) einen Linktyp aus, um Ihren Benutzern zusätzliche Unterstützung zu bieten:

   • Email (E-Mail): Eine interne E-Mail-Adresse.
   • URL: Ein Link zu einer internen Supportwebsite. Sie müssen http:// oder https:// verwenden.
     

9. Testen Sie die E-Mail-Zustellung.

DNS- und Firewalleinstellungen zum Zulassen eingehender E-Mails konfigurieren

Wenn Sie E-Mail-Antworten auf Benachrichtigungen zulassen möchten, müssen Sie Ihre DNS-Einstellungen konfigurieren.

1. Stellen Sie sicher, dass Port 25 auf der Instanz für Ihren SMTP-Server erreichbar ist.
2. Erstellen Sie einen Datensatz, der auf reply.[hostname] verweist. In Abhängigkeit Ihres DNS-Providers und Ihrer Instanz-Host-Konfiguration können Sie ggf. stattdessen einen einzelnen A-Datensatz erstellen, der auf *.[hostname] verweist.
3. Erstellen Sie einen MX-Datensatz, der auf reply.[hostname] verweist, sodass an diese Domain gesendete E-Mails zur Instanz weitergeleitet werden.
4. Erstellen Sie einen MX-Datensatz, wodurch noreply.[hostname] auf [hostname] verweist, damit an die in Benachrichtigungs-E-Mails enthaltene cc-Adresse gesendete Antworten an die Instanz weitergeleitet werden. Weitere Informationen finden Sie unter „Informationen zu E-Mail-Benachrichtigungen“.

In Ihrer DNS-Konfigurationseinrichtung können Sie nun testen, ob die Einrichtung funktioniert.

E-Mail-Zustellung testen

1. Klicken Sie im oberen Bereich des Abschnitts Email (E-Mail) auf Test email settings (Einstellungen für Test-E-Mail).

   

2. Geben Sie im Feld Send test email to (Test-E-Mail senden an) eine Adresse ein, an welche die Test-E-Mail gesendet werden soll.

   

3. Klicken Sie auf Send test email (Test-E-Mail senden).

   

   Tipp: Wenn beim Senden einer Test-E-Mail SMTP-Fehler auftreten, werden diese im Dialogfeld „Test email settings“ (Einstellungen für Test-E-Mail) angezeigt.

4. Wenn die Test-E-Mail nicht zugestellt werden kann, führen Sie eine Fehlerbehebung bei Ihren E-Mail-Einstellungen durch.

5. Wenn die Test-E-Mail erfolgreich war, klicken Sie im unteren Bereich der Seite auf Save settings (Einstellungen speichern).

   

6. Warten Sie auf den Abschluss der Konfigurationsausführung.

   

Fehlerbehebung bei der E-Mail-Zustellung

Support-Bundle erstellen

Wenn Sie anhand der angezeigten Fehlermeldung nicht ermitteln können, was falsch ist, können Sie ein Support-Bundle herunterladen, das die gesamte SMTP-Kommunikation zwischen Ihrem E-Mail-Server und GitHub Enterprise Server enthält. Überprüfen Sie nach dem Herunterladen und Extrahieren des Bundles die Einträge in enterprise-manage-logs/unicorn.log für das gesamte SMTP-Kommunikationsprotokoll und auf die zugehörigen Fehler.

Das Unicorn-Protokoll sollte in etwa folgende Transaktion anzeigen:

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"

Dieses Protokoll zeigt, dass die Appliance

• eine Verbindung mit dem SMTP-Server hergestellt hat (Connection opened: smtp.yourdomain.com:587),
• eine erfolgreiche Verbindung hergestellt hat und dazu TLS (TLS connection started) ausgewählt hat,
• der Authentifizierungstyp login durchgeführt wurde (<- "AUTH LOGIN\r\n"),
• der SMTP-Server die Authentifizierung als ungültig (-> "535-5.7.1 Username and Password not accepted.) abgelehnt hat.

Ihre GitHub Enterprise Server-Instanz-Protokolle überprüfen

If you need to verify that your inbound email is functioning, there are two logfiles that you can examine on your instance: To verify that /var/log/mail.log and /var/log/mail-replies/metroplex.log.

/var/log/mail.log verifiziert, dass die Nachrichten Ihren Server erreichen. Im Folgenden finden Sie ein Beispiel einer erfolgreichen E-Mail-Antwort:

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]

Beachten Sie, dass der Client zunächst eine Verbindung herstellt und anschließend die Warteschlange aktiv wird. Anschließend wird die Nachricht zugestellt, der Client aus der Warteschlange entfernt und die Sitzung getrennt.

/var/log/mail-replies/metroplex.log zeigt an, ob eingehende E-Mails verarbeitet werden, um Issues und Pull Requests als Antworten hinzuzufügen. Im Folgenden finden Sie ein Beispiel einer erfolgreichen Nachricht:

[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

Sie werden feststellen, dass metroplex die eingehende Nachricht empfängt, sie verarbeitet und die Datei anschließend an /data/user/incoming-mail/success sendet.

Ihre DNS-Einstellungen verifizieren

Damit eingehende E-Mails ordnungsgemäß verarbeitet werden, müssen Sie eine gültigen A-Datensatz (oder CNAME) und einen MX-Datensatz konfigurieren. Weitere Informationen finden Sie unter „DNS- und Firewalleinstellungen zum Zulassen eingehender E-Mails konfigurieren“.

Einstellungen der Firewall oder der AWS-Sicherheitsgruppe überprüfen

Wenn sich Ihre GitHub Enterprise Server-Instanz hinter einer Firewall befindet oder durch eine AWS-Sicherheitsgruppe betrieben wird, muss Port 25 auf allen E-Mail-Servern geöffnet sein, auf denen E-Mails an reply@reply.[hostname] gesendet werden.

Support kontaktieren

Kontaktieren Sie GitHub Enterprise-Support oder GitHub Premium-Support, falls Sie das Problem weiterhin nicht beheben können. Hängen Sie die Ausgabedatei von http(s)://[hostname]/setup/diagnostics an Ihre E-Mail an, um uns bei der Fehlerbehebung zu unterstützen.