Administración del soporte de aplicaciones Jira

Defina o edite el servidor de correo SMTP

1. Elija Administración ( ) > Sistema.
2. Seleccione Correo > Correo saliente para abrir la página Servidor de correo SMTP.
   Si no se ha definido ningún servidor de correo SMTP, se mostrará un botón Configurar nuevo servidor de correo SMTP en la página. Si ya se ha definido uno, los detalles del servidor de correo SMTP se mostrarán en la página, junto con un conjunto de enlaces de operación a la derecha.

3. Haga clic en el botón Configurar nuevo servidor de correo SMTP para definir un nuevo servidor de correo SMTP, o en el enlace Editar a la derecha para editar el servidor de correo SMTP existente, que abrirá la página Agregar/Actualizar Servidor de correo SMTP.

4. Complete la sección superior de esta página de la siguiente manera:

   Nombre	Especifique un nombre arbitrario para identificar esta configuración de servidor de correo SMTP.
   Descripción	(Opcional) Especifique una descripción arbitraria que describa el servidor de correo SMTP. Esta descripción aparece debajo del Nombre del servidor de correo SMTP en la página Configuración del servidor de correo SMTP.
   De la dirección	Especifique la dirección de correo electrónico utilizada en el campo «dirección del remitente» (o «de») de los mensajes de notificación enviados por Jira, a menos que se anule en la configuración de un proyecto. Solo especifique una dirección de correo electrónico para este campo (por ejemplo, [email protected]). Jira usará este valor para construir el encabezado ‘from’ completo basado en el usuario actual ("Joe Bloggs (Jira) <[email protected]>"). Para cambiar el encabezado ‘desde’, vaya a Administración > Sistema > Configuración general y (en Configuración), edite el campo Correo electrónico desde.
   Prefijo de correo electrónico	Especificar el asunto de los correos electrónicos enviados desde este servidor usará esta cadena como prefijo. Esto es útil para que los usuarios puedan filtrar las notificaciones de correo electrónico de Jira en función de este prefijo.

   Captura de pantalla: Agregar (o Actualizar) Servidor de correo SMTP

   

Especifique un nombre de host o una ubicación JNDI para su servidor de correo SMTP

La segunda parte de la página Agregar/Actualizar Servidor de correo SMTP especifica los Detalles del servidor del servidor de correo SMTP al que Jira enviará el correo. Hay dos maneras de hacer esto. O bien:

• especifique los detalles del host SMTP de su servidor de correo SMTP;
  o:
• especifique la ubicación JNDI de un objeto javax.mail.Session — es decir, use JNDI para buscar un servidor de correo SMTP que haya preconfigurado en su servidor de aplicaciones. Esto tiene las siguientes ventajas:
  • Mejor seguridad: los detalles de correo no están disponibles para los administradores de Jira a través de la interfaz de administración de Jira y no se almacenan en archivos de copia de seguridad de Jira.
  • Más opciones de SMTP: por ejemplo, puede cambiar a RSET en lugar de NOOP para probar conexiones configurando la propiedad mail.smtp.userset.
  • Gestión centralizada: los detalles de correo se configuran en el mismo lugar que los detalles de la base de datos y se pueden configurar a través de las herramientas de administración del servidor de aplicaciones.

Especifique los detalles del host SMTP

La mayoría de las personas configuran el servidor de correo SMTP de Jira especificando los detalles del host SMTP de este servidor de correo directamente en Jira.

1. En la sección Host SMTP de la página Agregar/Actualizar Servidor de correo SMTP (arriba), complete los siguientes campos de formulario:

   Proveedor de servicios (no disponible al actualizar un servidor de correo SMTP existente)	Elija entre usar su propio servidor de correo SMTP (es decir, Personalizado), o bien Gmail (es decir, Correo de Google Apps / Gmail) o Yahoo! (es decir, Yahoo! Mail Plus) como proveedor de servicios para su servidor de correo SMTP. Si elige Gmail o Yahoo! opciones y, a continuación, volver a Personalizado, algunos de los campos clave de esta sección se rellenarán automáticamente con la configuración del servidor de correo SMTP correspondiente para estos proveedores de servicios.
   Protocolo	Elija entre si su servidor de correo SMTP es estándar (es decir, SMTP ) o seguro (es decir, SECURE_SMTP).
   Nombre de Host	Especifique el nombre de host o la dirección IP de su servidor de correo SMTP. Eg. smtp.yourcompany.com
   Puerto SMTP	(Opcional) El número de puerto SMTP, generalmente 25 para SMTP o 465 para SMTP, cualquiera de los cuales se asume si este campo se deja en blanco.
   Tiempo de espera	(Opcional) Especifique el período de espera en milisegundos, que se tratará como 10000 si este campo se deja en blanco. Si especifica 0 o un valor negativo, Jira esperará indefinidamente a que el servidor SMTP responda.
   TLS	(Opcional) Seleccione esta casilla de verificación si su host SMTP utiliza el protocolo de Seguridad de la capa de transporte (TLS).
   Nombre de usuario	(Opcional) Si su host SMTP requiere autenticación, especifique el nombre de usuario de estas credenciales de autenticación aquí. (La mayoría de los servidores de la empresa requieren autenticación para transmitir correo a usuarios no locales.)
   Contraseña	(Opcional) De nuevo, si su host SMTP requiere autenticación, especifique la contraseña asociada con el nombre de usuario especificado anteriormente. Al editar un servidor de correo SMTP existente, seleccione la casilla de verificación Cambiar contraseña para acceder y cambiar este campo.

   Tenga en cuenta:

   • Si el script de inicio de su servidor utiliza las propiedades del sistema -Dmail (por ejemplo, mail.smtp.host o mail.smtp.port), anularán la configuración que especifique en el formulario anterior. Además, si es necesario, puede especificar manualmente el nombre de host que Jira informa a sí mismo como servidor SMTP configurando -Dmail.smtp.localhost

   • El SMTP debe admitir el tipo de contenido de varias partes. Sin este correo no se podrá enviar.
2. (Opcional) Haga clic en el botón Probar conexión para comprobar que Jira puede comunicarse con el servidor de correo SMTP que acaba de configurar.
3. Haga clic en el botón Agregar (o Actualizar) para guardar la configuración del servidor de correo SMTP de Jira.

Especifique una ‘ubicación JNDI’

Como alternativa a especificar los detalles del host SMTP directamente en Jira, puede configurarlos en su servidor de aplicaciones y, a continuación, buscar una sesión de correo preconfigurada a través de JNDI.

En la sección Ubicación JNDI de la página Agregar/Actualizar Servidor de correo SMTP (arriba), especifique la ubicación de un objeto javax.mail.Session para usar al enviar correo electrónico, en el campo Ubicación JNDI. Esto comenzará con el prefijo java:comp/env/

Configurar una ubicación JNDI

La ubicación JNDI que especifique en Jira dependerá del servidor de aplicaciones y la configuración de Jira. Las ubicaciones JNDI suelen configurarse en el servidor de aplicaciones que ejecuta Jira. Por lo tanto, Jira tendrá que reiniciarse después de configurar una ubicación JNDI para que esa configuración esté disponible en Jira.

Por ejemplo, en Tomcat 6 (el servidor de aplicaciones incluido con distribuciones «recomendadas» de Jira), su ubicación JNDI sería java:comp/env/mail/JiraMailServer y agregaría la siguiente sección al conf/server.xml de su directorio de instalación de aplicaciones Jira, dentro del nodo <Context/> :

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="mail.yourcompany.com" mail.smtp.port="25" mail.transport.protocol="smtp" mail.smtp.auth="true" mail.smtp.user="jirauser" password="mypassword" /> ...</Context>

O si no requiere autenticación (por ejemplo, si está enviando a través de localhost, o solo internamente dentro de la empresa):

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="localhost" mail.smtp.port="25" mail.transport.protocol="smtp" /> ...</Context>

Si ejecuta Jira en un servidor de aplicaciones que no sea Apache Tomcat (que no es una configuración de Jira compatible), debe aplicarse a ese servidor de aplicaciones una metodología similar para configurar una ubicación JNDI en su servidor de correo SMTP.

Si tiene problemas para conectarse, agregue un parámetro mail.debug="true" al elemento <Resource/> (arriba), que le permitirá ver los detalles de ‘depuración’ de nivel SMTP al probar la conexión.

Mover las clases JavaMail

También deberá asegurarse de que las clases JavaMail (normalmente en los archivos de la biblioteca JAR) estén presentes en la ruta de clases de su servidor de aplicaciones y que no entren en conflicto con los archivos de la biblioteca JAR de Jira. Esto es necesario porque el servidor de aplicaciones en sí (no Jira) está estableciendo la conexión SMTP y, como tal, el servidor de aplicaciones no puede ver los archivos de la biblioteca JAR en el cargador de clases de Jira.

Algunos sistemas operativos pueden agrupar las clases JavaMail con servidores de aplicaciones (por ejemplo, Tomcat en Red Hat Enterprise Linux). Esto puede entrar en conflicto con la copia de Jira de las clases JavaMail, lo que resulta en errores como:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

o:

java.lang.IllegalArgumentException: Mail server at location is not of required type javax.mail.Session.

Servidores de aplicaciones más ligeros como Apache Tomcat (incluido el incorporado en las distribuciones «recomendadas» de Jira), no siempre vienen con JavaMail.

Para evitar conflictos, compruebe el directorio lib/ de su servidor de aplicaciones:

• Si el servidor de aplicaciones ya contiene mail-1.4.1.jar y activation-1.1.1.jar, simplemente elimine mail-1.4.1.jar y activation-1.1.1.jar del subdirectorio <jira-application-dir>/WEB-INF/lib/ del directorio de instalación de aplicaciones de Jira.
• Si el servidor de aplicaciones no contiene mail-1.4.1.jar y activation-1.1.1.jar, mueva el subdirectorio mail-1.4.1.jar y activation-1.1.1.jar del subdirectorio <jira-application-dir>/WEB-INF/lib/ del directorio de instalación de aplicaciones de Jira al subdirectorio lib/ del directorio de instalación de Jira (para distribuciones «recomendadas» de Jira) o al subdirectorio lib/ del servidor de aplicaciones que ejecuta Jira.

SMTP sobre SSL

Puede cifrar las comunicaciones de correo electrónico entre Jira y su servidor de correo a través de SSL, siempre que su servidor de correo sea compatible con SSL.

En primer lugar, deberá importar el certificado del servidor SMTP a un almacén de claves Java. El proceso se describe en la página Configuración de una conexión SSL con Active Directory.

Nota importante: Sin importar el certificado, Jira no podrá comunicarse con su servidor de correo.

En segundo lugar, edite las propiedades de conexión de su servidor de correo y especifique starttlsy SSLSocketFactory. Desde {$Jira_INSTALL}/conf/server.xml (este ejemplo utiliza el servidor de Gmail):

<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="[email protected]" password="mypassword" mail.smtp.starttls.enable="true" mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"/>

Solución de problemas

Un consejo útil para depurar problemas relacionados con el correo en Jira es establecer la propiedad -Dmail.debug=true al iniciar. Esto hará que los detalles de nivel de protocolo de las interacciones de correo electrónico de Jira se registren. Además, subir el nivel de registro de JIRA mostrará cuándo se está ejecutando el servicio y cómo se procesan los correos.

Problemas comunes

• Si Jira no parece estar creando o enviando correos electrónicos o creando problemas y comentarios desde el correo electrónico, su instalación de Jira podría estar experimentando errores de memoria externa. Por favor, revise sus archivos de registro en busca de errores de memoria. Si hay errores de OutOfMemory, reinicie Jira e investigue los errores.
• Si encuentra que algunos correos electrónicos entrantes simplemente desaparecen, verifique que no haya iniciado accidentalmente una segunda copia de Jira (p. ej. en un entorno de ensayo) que descarga y elimina mensajes de correo electrónico. Consulte la página Restauración de datos para ver los indicadores que debe configurar para evitar que se procese el correo.
• Si recibe errores de ‘Retransmisión de correo’, asegúrese de haber especificado el Nombre de usuario y la contraseña en la sección Host SMTP de la página de configuración del Servidor de correo SMTP de Jira.

Obtener ayuda

Si no puede resolver un problema usted mismo, cree un caso de soporte en el proyecto ‘Jira’ y le ayudaremos.