Notifications from Comments/ @mentions Are Not Being Received

Author: Chris Breaux

Date: April 5, 2024

Audience: Everyone

Environmental details: Self-Hosted

Summary: In some customer environments, there can be an issue where emails generated from @mentions or comments are not being received.

Solution: In this case, an admin will need to add the application cert to the 'trusted' certs / keystore

Cause:
The root cause is that the in-lining of images in HTML emails (such as stream notification emails) is triggering a TLS connection from Jama to itself, which is failing. Even if the content of the comment does not contain images, icons and user avatars are added to @mention stream notification emails. The connection to retrieve these images is failing because the TLS certificate used by Jama isn't trusted by the Jama application itself.

Additional Information/Metadata:

nested exception is:
 javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
 at org.springframework.mail.javamail.JavaMailSenderImpl.doSend(JavaMailSenderImpl.java:491)
 at org.springframework.mail.javamail.JavaMailSenderImpl.send(JavaMailSenderImpl.java:361)
 at org.springframework.mail.javamail.JavaMailSenderImpl.send(JavaMailSenderImpl.java:356)
 ...

Please feel free to leave feedback in the comments below.