How to integrate GMail (google mail) in SignDoc Standard

Issue

This knowledgebase article shows an example configuration integrating the email functionality with google mail.

Solution

In order to connect Signdoc Standard with GMail (google mail), following configuration has to be performed in the service_configuration.properties file.

Following example shows the mail configuration using SMTPS (SMTP secure), which is more secure than using SMTP with STARTTLS sequence:

mail.smtp.ssl.enable=true
mail.smtp.auth=true
mail.smtp.port=465
mail.smtp.host=smtp.googlemail.com
mail.smtp.user=<google mail address>
mail.smtp.password=<google password or app password>

all other mail specific (default) configuration in the configuration file needs to be commented out with # sign (e.g. #mail.smtp.host=localhost)

Execute service_up.cmd configuration to apply the configuration.
If mail sending doesn´t work activate debug logging for mail sending following this article:
How to troubleshoot problems in Email sending in Signdoc Standard

As Google has strong security features, sending mail most likely will fail with error:

javax.mail.AuthenticationFailedException: 535-5.7.8 Username and Password not accepted. Learn more at
535 5.7.8  https://support.google.com/mail/?p=BadCredentials n14sm26625138wmi.1 - gsmtp

In GMail security settings you need to configure
- to allow insecure apps,
- or you activate 2 factor authentication and you apply an "App-Password" which only is used for the particular application (Signdoc Standard).
Further Details to this topic can be found on here --> https://support.google.com/mail/?p=BadCredentials

Level of Complexity 

Easy

Applies to  

References

Add any references to other internal or external articles