Fehleranalyse zum E-Mail Versand

Sollte der Versand einer Test-E-Mail in Timemaster unter dem Menü “System” und “E-Mail Einstellungen” nicht erfolgreich abgeschlossen werden, so kann folgende Anleitung für eine genauere Fehlerdiagnose genutzt werden.

Test-Zugangsdaten

Sofern kein erfolgreicher E-Mail Versand eingerichtet werden kann, stellt Timemaster nachfolgend Zugangsdaten zur Fehlerdiagnose zur Verfügung.

Achtung: Diese Zugangsdaten sind ausschließlich für Testzwecke und dürfen nicht produktiv vom Kunden verwendet werden.

Logindaten Test-Mailversand

Für die tiefgreifende Fehlerdiagnose kann unter dem Programmpfad:

C:ProgramDataTimemasterTimemaster WEBBackendApplication Logs

der Log des Timemaster WEB Backends eingesehen werden. Innerhalb des Logs werden auch E-Mail Versandfehler aufgeführt, diese sind nachfolgend näher beschrieben.

Fehlermeldung: “Systemmail Name”: Ist nicht relevant

Interner Exchange-Server

Ursache: Bei einem Kunden musste der Timemaster-Server in die Liste der berechtigten Server in dem Empfangsconnector für anonymes Relay eingetragen werden, damit der interne Exchange-Server verwendet werden konnte.

Im Frontend: Testmail wird augenscheinlich korrekt verschickt
Testmail kommt nicht an

Ursache: „Systemmail Adresse“ falsch (Die Konfiguration ist ansonsten korrekt)
Es gibt keine Einträge im Backend-Log. 

Im Frontend: Code 109

Ursache: Beim Versand einer Test-Mail wurde noch kein Empfänger eingetragen.

Verwendet wird die Mail-Adresse von dem gerade angemeldeten Benutzer. Die Konfiguration erfolgt unter “Stammdaten” im Bereich “Login” und “Benutzer”.

Im Frontend: Code 507

Ursache: Die Zugangsdaten für den Email-Versand sind nicht korrekt.
(Benutzername oder Passwort)

2021-05-05 12:00:47,375 [213] ERROR
EQ3.TMWeb.TMWebApi.App_Start.TMWebExceptionLogger – unhandled exception occurred (Request=POST
https://www.timemaster.cloud/1131Backend/api/configuration/mail/send,
IsAuthenticated=True, User=admin, IsTopLevel=False)
EQ3.TMWeb.TMWebException.Mail.AuthenticationFailedException —>
MailKit.Security.AuthenticationException: 535: Incorrect authentication data —
> MailKit.Net.Smtp.SmtpCommandException: Incorrect authentication data
— End of inner exception stack trace —
at MailKit.Net.Smtp.SmtpClient.<AuthenticateAsync>d__69.MoveNext()

Im Frontend: Code 506

Ursache: Zertifikat-Fehler

Das von Timemaster verwendete Framework “MailKit” unterbindet das Senden über Mailserver, wenn das Zertifikat ungültig ist!
Beispiel: Es wird Exchange.firma.lan verwendet, das Zertifikat des Servers ist jedoch auf *.firma.de ausgestellt, der Server wird aber über den vorigen Namen
angesprochen, was nicht funktioniert. Um per SMTP-Protokoll auf den Mail-Server zugreifen zu können, muss auf die Cluster-Adresse zugegriffen werden. In dem Beispiel muss bei Mail-Server „exchange.firma.de“ eingetragen werden.
Folgende sonstige mögliche Gründe kann es geben:

1. Der Server verwendet ein selbstsigniertes Zertifikat, das nicht überprüft werden kann.
2. Dem lokalen System fehlt ein Root- oder Intermediate-Zertifikat, das zur
Überprüfung des Serverzertifikats erforderlich ist.
3. Ein CRL-Server der Zertifizierungsstelle für eines oder mehrere der Zertifikate in der Kette ist vorübergehend nicht verfügbar.
4. Das vom Server vorgelegte Zertifikat ist abgelaufen oder ungültig.
Es ist auch möglich, dass die vom Client und Server unterstützten SSL / TLS Protokolle nicht übereinstimmen.

202x-yy-zz 11:12:13,160 [123] ERROR
EQ3.TMWeb.TMWebApi.App_Start.TMWebExceptionLogger – unhandled exception
occurred (Request=POST
https://xxxxx.yyy.zz/TimemasterBackend/api/configuration/mail/send,
IsAuthenticated=True, User=admin,
IsTopLevel=False)EQ3.TMWeb.TMWebException.Mail.SmtpConfiguration
Exception —
> MailKit.Security.SslHandshakeException: An error occurred while attempting
to establish an SSL or TLS connection.

This usually means that the SSL certificate presented by the server is not trusted by the
system for one or more of the following reasons:
1. The server is using a self-signed certificate which cannot be verified.
2. The local system is missing a Root or Intermediate certificate needed to verify the
server’s certificate.
3. A Certificate Authority CRL server for one or more of the certificates in the chain is
temporarily unavailable.
4. The certificate presented by the server is expired or invalid.

Im Frontend: Code 506

Ursache: Die Verwendung eines externen Mailservers wurde unterbunden

202x-yy-zz 11:12:13,160 [123] ERROR
EQ3.TMWeb.TMWebApi.App_Start.TMWebExceptionLogger – unhandled exception occurred (Request=POST
https://xxxxx.yyy.zz/TimemasterBackend/api/configuration/mail/send,
IsAuthenticated=True, User=admin, IsTopLevel=False)
EQ3.TMWeb.TMWebException.Mail.SmtpConfigurationException —>
System.TimeoutException: Timeout für den Vorgang wurde überschritten.
bei MailKit.Net.SocketUtils.<ConnectAsync>d__1.MoveNext()
— Ende der Stapelüberwachung vom vorhergehenden Ort, an dem die Ausnahme ausgelöst wurde —beiSystem.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()

Im Frontend: Code 506

Ursache: Port “25” wurde anstatt “587” verwendet

202x-yy-zz 11:12:13,160 [123] ERROR
EQ3.TMWeb.TMWebApi.App_Start.TMWebExceptionLogger – unhandled exception
occurred (Request=POST https://xxxxx.yyy.zz/TimemasterBackend
/api/configuration/mail/send, IsAuthenticated=True, User=admin, IsTopLevel=False)
EQ3.TMWeb.TMWebException.Mail.SmtpConfigurationException —>
System.TimeoutException: The operation has timed out.
at MailKit.Net.SocketUtils.<ConnectAsync>d__1.MoveNext()
— End of stack trace from previous location where exception was thrown —
at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
at
System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAnd
DebuggerNotificati
on(Task task)
at MailKit.MailService.<ConnectSocket>d__48.MoveNext()

Im Frontend: Code 506

Ursache: Button “Zugangsdaten nutzen” ist ausgeschaltet

202x-yy-zz 11:12:13,160 [123] ERROR
EQ3.TMWeb.TMWebApi.App_Start.TMWebExceptionLogger – unhandled exception
occurred (Request=POST https://xxxxx.yyy.zz/TimemasterBackend
/api/configuration/mail/send, IsAuthenticated=True, User=admin, IsTopLevel=False)
EQ3.TMWeb.TMWebException.Mail.SmtpConfigurationException —>
MailKit.Net.Smtp.SmtpCommandException: relay not permitted
at MailKit.Net.Smtp.SmtpClient.OnRecipientNotAccepted(MimeMessage message,
MailboxAddress mailbox, SmtpResponse response)
at MailKit.Net.Smtp.SmtpClient.ProcessRcptToResponse(MimeMessage message,
MailboxAddress mailbox, SmtpResponse response)
atMailKit.Net.Smtp.SmtpClient.<FlushCommandQueueAsync>d__62.MoveNext()

Im Frontend: Code 506

Ursache: Der SMTP-Server existiert nicht

202x-yy-zz 11:12:13,160 [123] ERROR
EQ3.TMWeb.TMWebApi.App_Start.TMWebExceptionLogger – unhandled exception
occurred (Request=POST https://xxxxx.yyy.zz/TimemasterBackend
/api/configuration/mail/send, IsAuthenticated=True, User=admin, IsTopLevel=False)
EQ3.TMWeb.TMWebException.Mail.SmtpConfigurationException —>
System.Net.Sockets.SocketException: No such host is known
at System.Net.Dns.HostResolutionEndHelper(IAsyncResult asyncResult)
at System.Net.Dns.EndGetHostAddresses(IAsyncResult asyncResult)
at System.Threading.Tasks.TaskFactory`1.FromAsyncCoreLogic(IAsyncResult iar,
Func`2 endFunction, Action`1 endAction, Task`1 promise, Boolean
requiresSynchronization)