Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Configuración de archivos

El servicio de mailer provisto por JBoss se configura a través del archivo

...

A continuación se incluye un ejemplo de dicho archivo

Code Block
xml
xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE server>
<!-- $Id: mail-service.xml 31716 2005-06-01 06:20:43Z starksm $ -->

<server>

  <!-- ==================================================================== -->
  <!-- Mail Connection Factory                                              -->
  <!-- ==================================================================== -->

  <mbean code="org.jboss.mail.MailService" name="jboss:service=Mail">
    <attribute name="JNDIName">java:/Mail</attribute>
    <attribute name="User">nobody</attribute>
    <attribute name="Password">password</attribute>
    <attribute name="Configuration">
       <!-- Test -->
       <configuration>
          <!-- Change to your mail server prototocol -->
          <property name="mail.store.protocol" value="pop3"/>
          <property name="mail.transport.protocol" value="smtp"/>

          <!-- Change to the user who will receive mail  -->
          <property name="mail.user" value="nobody"/>

          <!-- Change to the mail server  -->
          <property name="mail.pop3.host" value="pop3.nosuchhost.nosuchdomain.com"/>

          <!-- Change to the SMTP gateway server -->
          <property name="mail.smtp.host" value="smtp.nosuchhost.nosuchdomain.com"/>

          <!-- Change to the address mail will be from  -->
          <property name="mail.from" value="nobody@nosuchhost.nosuchdomain.com"/>

          <!-- Enable debugging output from the javamail classes -->
          <property name="mail.debug" value="false"/>
       </configuration>
       <depends>jboss:service=Naming</depends>
    </attribute>
  </mbean>
</server>

...

  • Usuario y Password
  • Nombre o dirección IP del servidor SMTP (servidor de correo)
  • Cuenta de correo que se utilizará como remitente de los correos enviados por O3

Usuario y Password

El nombre de usuario y password para acceder al servidor de mail se configura en la siguiente sección

Code Block
xml
xml

<attribute name="User">nobody</attribute>
<attribute name="Password">password</attribute>

...

De esta forma el XML quedaría similar a esto:

Code Block
xml
xml

<attribute name="User">o3server</attribute>
<attribute name="Password">mi_password</attribute>

Nombre o IP del servidor de correo

El nombre o IP del servidor de correo se indica en la sección siguiente:

Code Block
xml
xml

<!-- Change to the SMTP gateway server -->
<property name="mail.smtp.host" value="smtp.nosuchhost.nosuchdomain.com"/>

...

Tip
titleRecomendación

Hacer un telnet al puerto 25 de la IP/DNS del servidor de correos de modo de estar seguros que se encuentra accesible.

Windows (desde cmd)
telnet
open ip puerto

Cuenta remitente

Finalmente resta indicar una cuenta de correo válida en el servidor de correos que se utilizará como remitente para los mails enviados.

Esta cuenta se indica en la sigiuente sección:

Code Block
xml
xml

<!-- Change to the address mail will be from  -->
<property name="mail.from" value="nobody@nosuchhost.nosuchdomain.com"/>

En el ejemplo esta sección quedaría de la siguiente forma:

Code Block
xml
xml

<!-- Change to the address mail will be from  -->
<property name="mail.from" value="o3server@mi_dominio.com"/>
Info
titleReinicio del server

No es necesario reiniciar el jboss para que estos cambios tengan efecto

Configuración con autentificación de usuario

En el caso de necesitar autentificación de usuario, especialmente si necesitamos enviar a direcciones de correo electrónicas que no son del mismo dominio que el servidor de correos, se deberán agregar dos líneas antes de </configuration>

Code Block
xml
xml
 
          <property name="mail.smtp.starttls.enable" value="true" />
          <property name="mail.smtp.auth" value="true"/>

Configuración para los mails de actualización de cubos cuando requiere autentificación de usuario

Ver siguiente HowTo:  Envio de mail con servidor SMTP que requiere TLS 

Configuración para enviar vía SMTP Seguro

Cuando debamos utilizar un servidor de correos via SMTP Seguro con autentificación deberemos realizar algunos cambios en el archivo mail-service.xml (se utiliza un ejemplo utilizando el servidor SMTP Seguro de gmail.com).

Code Block
xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Id: mail-service.xml 62349 2007-04-15 16:48:15Z dimitris@jboss.org $ -->
<server>

  <!-- ==================================================================== -->
  <!-- Mail Connection Factory                                              -->
  <!-- ==================================================================== -->

  <mbean code="org.jboss.mail.MailService"
         name="jboss:service=Mail">
    <attribute name="JNDIName">java:/Mail</attribute>
    <attribute name="User">USUARIO</attribute>
    <attribute name="Password">PASSWORD</attribute>
    <attribute name="Configuration">
      <!-- A test configuration -->
      <configuration>
        <!-- Change to your mail server prototocol -->
        <property name="mail.store.protocol" value="pop3"/>
        <property name="mail.transport.protocol" value="smtp"/>

        <!-- Change to the user who will receive mail  -->
        <property name="mail.user" value="USUARIO@gmail.com"/>

        <!-- Change to the mail server  -->
        <property name="mail.pop3.host" value="pop.gmail.com"/>

        <!-- Change to the SMTP gateway server -->
        <property name="mail.smtp.host" value="smtp.gmail.com"/>
        <property name="mail.smtp.starttls.enable" value="true" />
        <property name="mail.smtp.socketFactory.class" value="javax.net.ssl.SSLSocketFactory" />


        <!-- The mail server port -->
        <property name="mail.smtp.port" value="465"/>
        <property name="mail.smtp.socketFactory.port" value="465" />

        <!-- Change to the address mail will be from  -->

        <property name="mail.from" value="USUARIO@gmail.com"/>
        <property name="mail.smtp.user" value="USUARIO@gmail.com"/>
        <property name="mail.smtp.password" value="PASSWORD"/>
        <property name="mail.smtp.auth" value="true"/>

        <!-- Enable debugging output from the javamail classes -->
        <property name="mail.debug" value="false"/>
      </configuration>
    </attribute>
    <depends>jboss:service=Naming</depends>
  </mbean>

</server>