<network> (Elemento, Configuración de red)

Configura las opciones de red para un servidor de protocolo simple de transferencia de correo (SMTP) externo.

<network
  clientDomain="string" 
  defaultCredentials="true|false"
  enableSsl="true|false"
  host="string" 
password="string"
  port="integer" 
targetName="string"
userName="string"
/>

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Elementos secundarios

Ninguno.

Elementos primarios

Comentarios

El elemento <network> configura las opciones de red de un servidor SMTP externo.

Algunos servidores SMTP requieren la autenticación del usuario en el servidor antes de su utilización. Si desea autenticarse utilizando las credenciales de red predeterminadas de su host, establezca el atributo defaultCredentials en true. La propiedad SmtpNetworkElement.DefaultCredentials se puede utilizar para obtener el valor actual del atributo defaultCredentials de los archivos de configuración aplicables.

También es posible utilizar la autenticación básica (un nombre de usuario y una contraseña) para autenticarse en el servidor SMTP. Para utilizar esta opción, es necesario especificar una contraseña y un nombre de usuario válido para el servidor SMTP especificado.

Nota

La autenticación básica envía los valores userName y password al servidor no cifrado.Cualquier usuario que supervise el tráfico de red podrá ver sus credenciales y utilizarlas para conectarse al servidor.Se debería considerar la utilización de un mecanismo de autenticación más seguro, como Kerberos o NT LAN Manager (NTLM). Si defaultCredentials es true, se utilizarán Kerberos o NTLM si el servidor admite estos protocolos.

La autenticación básica y las opciones de credenciales de red predeterminadas son mutuamente exclusivas; si se establece defaultCredentials en true y se especifica un nombre de usuario y una contraseña, se utilizará la credencial de red predeterminada y se omitirán los datos de autenticación básicos.

En el caso de la autenticación básica, si especifica userName, también deberá especificar password para autenticarse a sí mismo ante el servidor de correo.

La propiedad SmtpNetworkElement.UserName se puede utilizar para obtener el valor actual del atributo userName de los archivos de configuración aplicables. La propiedad SmtpNetworkElement.Password se puede utilizar para obtener el valor actual del atributo password de los archivos de configuración aplicables. Un atributo password no se escribiría normalmente por razones de seguridad en archivos de configuración.

El atributo clientDomain cambia el nombre de dominio del cliente utilizado en la solicitud de protocolo SMTP inicial para un servidor SMTP. El atributo clientDomain se puede establecer en el nombre de dominio completo del equipo local, en lugar del nombre del host local que se utiliza de forma predeterminada. Esto proporciona mayor cumplimiento de los estándares del protocolo SMTP. El valor predeterminado es el nombre de host local del equipo local que envía la solicitud. La propiedad SmtpNetworkElement.ClientDomain se puede utilizar para obtener el valor actual del atributo clientDomain de los archivos de configuración aplicables.

El atributo targetName se utiliza para la autenticación cuando se utiliza la protección extendida. El valor predeterminado para este SPN tiene el formato "SMTPSVC/<host>" donde <host> es el nombre de host del servidor de correo SMTP. La propiedad SmtpNetworkElement.TargetName se puede utilizar para obtener el valor actual del atributo targetName de los archivos de configuración aplicables.

El atributo enableSsl especifica si se usa SSL para obtener acceso a un servidor de correo SMTP. La clase System.Net.Mail.SmtpClient sólo admite la extensión de servicio SMTP para SMTP seguro sobre Seguridad de la capa de transporte como se define en RFC 3207. En este modo, la sesión de SMTP comienza en un canal no cifrado, a continuación, el cliente ejecuta un comando STARTTLS al servidor para intercambiar para proteger la comunicación mediante SSL. Vea RFC 3207 publicada por Internet Engineering Task Force (IETF) para obtener más información.

Un método de conexión alternativo es donde una sesión de SSL se establece al frente antes de que se envíe cualquier comando de protocolo. Este método de conexión a veces se denomina SMTP/SSL y de forma predeterminada usa el puerto 465. Actualmente no se admite este método de conexión alternativo usando SSL.

La propiedad SmtpNetworkElement.EnableSsl se puede utilizar para obtener el valor actual del atributo enableSsl de los archivos de configuración aplicables.

Ejemplo

El ejemplo de código siguiente especifica los parámetros SMTP adecuados para enviar correo electrónico mediante las credenciales de red predeterminadas.

<configuration>
  <system.net>
    <mailSettings>
      <smtp deliveryMethod="network">
        <network
          clientDomain="www.contoso.com"
          defaultCredentials="true"
          enableSsl="false"
          host="mail.contoso.com"
          port="25"
        />
      </smtp>
    </mailSettings>
  </system.net>
</configuration>

Vea también

Referencia

Esquema de la configuración de red

System.Net.Configuration.SmtpNetworkElement

System.Net.Configuration.SmtpSection

System.Net.Mail.SmtpClient