Configuración del correo

La aplicación a veces envía correos a los usuarios, por ejemplo cuando se han suscrito a un documento o carpeta.

Precaución

Por defecto, el correo de Tomcat está configurado asumiendo que su servidor tiene un servicio de correo enlazado a localhost.

Estos son los valores por defecto:

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 usarí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 editarlo, 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 usar estos atributos:

• spring.mail.user=“”

Peligro

Tenga cuidado con spring.mail.test-connection porque cuando está habilitado, si falla la prueba de conexión al servidor de correo, OpenKM no arrancará:

• spring.mail.test-connection=true

Precaución

Si tiene problemas durante el arranque de Tomcat, puede probar a usar 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, puede que solo la dirección configurada en spring.mail.smtp.user pueda enviar mensajes. Esto es, el usuario que aparece en la cabecera de correo “From”.

Comprobación 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 de correo sin necesidad de reiniciar OpenKM, lo cual lleva tiempo y deja la aplicación 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 de correo de ese fichero. Esta utilidad tiene varios parámetros que se usarán para enviar el correo de prueba:

• -f, –from: origen usado para enviar el correo de prueba (obligatorio)
• -t, –to: destino usado para enviar el correo de prueba (obligatorio)
• -a, –attachment: un fichero opcional para enviar como adjunto

Puede ejecutar la utilidad de esta forma:

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