Configuring GMail for Outgoing Mail (SMTP)

Configuring GMail for Outgoing Mail (SMTP)

Follow the instructions from Configuring JIRA to Send SMTP Mail :

1. Download OpenSSL:
   Linux : http://www.openssl.org/
   Windows : http://gnuwin32.sourceforge.net/packages/openssl.htm
2. Import the SSL certificate from Gmail:
   For Windows : double-click the openssl file from the directory that gets installed. Run

    s_client -connect smtp.gmail.com:465
   

   For Linux : run:

    openssl s_client -connect smtp.gmail.com:465
   
   
   

3. From the output, you want only the alphanumeric string between the lines which say 'BEGIN CERTIFICATE' and 'END CERTIFICATE' (inclusive ). Copy the results into a file called gmail.cert using your favorite text editor.

          

1. Exit the openssl prompt, and return to your Java installation's bin directory. Import the cert into your keystore:

   "A keystore is created whenever you use a -genkey, -import, or -identitydb command to add data to a keystore that doesn't yet exist. More specifically, if you specify, in the -keystore option, a keystore that doesn't yet exist, that keystore will be created. If you don't specify a -keystore option, the default keystore is a file named .keystore in your home directory. If that file does not yet exist, it will be created." From Sun´s Documentation on Keytool

   For Windows :

   keytool -import
   
    -alias smtp.gmail.com -keystore $JAVA_HOME/jre/lib/security/cacerts -file C:/path/to/gmail.cert
   

   Fore Linux :(use the keytool under $JAVA_HOME )

   sudo keytool -import
   
    -alias smtp.gmail.com -keystore $JAVA_HOME/jre/lib/security/cacerts -file /path/to/gmail.cert
   
   
   

   The default keystore password is 'changeit'. 如果导入失败，可以尝试换-keystore 后面的路径，或者将cacerts删掉后再导入（删除可能会影响其他cert）

2. Move ( not copy! ) the activation and mail jar files from the /WEB-INF/lib folder to the /common/lib (Tomcat 5.5) or /lib (Tomcat 6) folder.
3. Add Gmail as a JNDI Resource in /conf/server.xml in-between JIRA's <Context>...</Context> ( after line 49 ). Change your username and password:

   <Resource name="mail/GmailSmtpServer"
   
   
   auth="Container"
   
   
   type="javax.mail.Session"
   
   
   mail.smtp.host="smtp.gmail.com"
   
   
   mail.smtp.port="465"
   
   
   mail.smtp.auth="true"
   
   
   mail.smtp.user="myusername@gmail.com"
   
   
   password="mypassword"
   
   
   mail.smtp.starttls.enable="true"
   
   
   mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"
   
   
   />
   

4. Add -Djavax.net.ssl.trustStore=$JAVA_HOME/jre/lib/security/cacerts to JAVA_OPTS(, or JAVA_OPTS="-Djavax.net.ssl.trustStore=$JAVA_HOME/jre/lib/security/cacerts $JAVA_OPTS" to the top of bin/setenv.sh)
   
5. Configure the SMTP server in JIRA's interface, use the JNDI setting. The proper value (if using the default example), is:

   java:comp/env/mail/GmailSmtpServer
   

6. restart jira