Configuración del correo

La aplicación envía correos electrónicos a los usuarios en algunas ocasiones, por ejemplo cuando los usuarios se han suscrito a un documento o a una carpeta.

Precaución

Por defecto, el correo de Tomcat está configurado suponiendo que su servidor dispone de un servicio de correo enlazado en su localhost.

Estos son los valores predeterminados:

spring.mail.host=localhost
spring.mail.port=25
spring.mail.username=
spring.mail.password=
spring.mail.from=noreply@openkm.com
spring.mail.properties.mail.smtp.auth=false
spring.mail.properties.mail.smtp.starttls.enable=false

Cambiar la configuración del correo

Obtenga los datos de su cuenta de correo (los mismos que utilizaría para configurar un cliente de correo estándar, como Outlook o Thunderbird).

Edite el fichero $TOMCAT_HOME/openkm.properties:

vim /home/openkm/tomcat-8.5.69/openkm.properties

Tras la edición, el fichero openkm.properties debería tener un aspecto similar a este:

spring.mail.host=localhost
spring.mail.port=25
spring.mail.username=
spring.mail.password=
spring.mail.from=noreply@openkm.com
spring.mail.properties.mail.smtp.auth=false
spring.mail.properties.mail.smtp.starttls.enable=false

Ejemplo con Gmail

spring.mail.host=smtp.gmail.com
spring.mail.port=587
spring.mail.username=<username>
spring.mail.password=<password>
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.ssl.trust=smtp.gmail.com
spring.mail.properties.mail.debug=true

Office 365

spring.mail.host=smtp.office365.com
spring.mail.username=<username>
spring.mail.password=<password>
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.ssl.trust=smtp.office365.com
spring.mail.properties.mail.debug=true

Servidor de correo con configuración SSL antigua

spring.mail.host=mail.myserver.com
spring.mail.port=465
spring.mail.username=<username>
spring.mail.password=<password>
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.ssl.enable=true
spring.mail.properties.mail.debug=true

Información adicional

Consejo

Opcionalmente, puede utilizar estos atributos:

• spring.mail.user=“”

Peligro

Tenga cuidado con spring.mail.test-connection, ya que, cuando está habilitado, si la prueba de conexión con el servidor de correo falla, OpenKM no se iniciará:

• spring.mail.test-connection=true

Precaución

Si tiene problemas durante el inicio de Tomcat, puede probar a utilizar el atributo spring.mail.smtp.quitwait=“false”.

Nota

Puede encontrar una lista completa de todos los parámetros disponibles en sun.mail.smtp package Javadoc y javax.mail package Javadoc.

Precaución

Tenga en cuenta que, dependiendo de la configuración del servidor SMTP, solo la dirección configurada en spring.mail.smtp.user puede estar autorizada a enviar mensajes; es decir, el usuario que aparece en la cabecera de correo “From”.

Prueba de la configuración

A veces configurar el correo puede ser complejo y propenso a errores, porque hay muchos parámetros de configuración y muchos servidores de correo distintos. Para facilitar esta configuración, hemos desarrollado una utilidad llamada OKMMailChecker que le ayuda a probar la configuración del correo sin necesidad de reiniciar OpenKM, lo cual lleva tiempo y lo deja no disponible para los usuarios durante estas pruebas.

Uso

Esta utilidad puede descargarse desde https://download.openkm.com y debe colocarse en el directorio de OpenKM, donde se encuentra el fichero openkm.properties. En efecto, esta utilidad leerá la configuración del correo de dicho fichero. La utilidad dispone de varios parámetros que se utilizarán para enviar el correo de prueba:

• -f, –from: Dirección de origen utilizada para enviar el correo de prueba (obligatorio)
• -t, –to: Dirección de destino utilizada para enviar el correo de prueba (obligatorio)
• -a, –attachment: Un fichero opcional que se enviará como adjunto

Puede ejecutar la utilidad de esta manera:

$ java -jar OKMMailChecker.jar -f origin@openkm.com -t destination@openkm.com -a SampleFile.txt