Elemento <network> (configuración de red)

Configura las opciones de red para un servidor smtp (Protocolo simple de transporte de correo) externo.

<configuration>
  <system.net>
    <mailSettings>
      <smtp>
        <network>

Sintaxis

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

Atributos y elementos

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

Atributos

Atributo Descripción
clientDomain Especifica el nombre de dominio de cliente que se usará en la solicitud de protocolo SMTP inicial para conectarse al servidor de correo SMTP. El valor predeterminado es el nombre del host local del equipo local que envía la solicitud.
defaultCredentials Especifica si se deben usar las credenciales de usuario predeterminadas para acceder al servidor de correo SMTP para las transacciones SMTP. El valor predeterminado es false.
enableSsl Especifica si se usa SSL para acceder a un servidor de correo SMTP. El valor predeterminado es false.
host Especifica el nombre de host del servidor de correo SMTP que se usará para las transacciones SMTP. Este atributo no tiene ningún valor predeterminado.
password Especifica la contraseña que se usará para la autenticación en el servidor de correo SMTP. Este atributo no tiene ningún valor predeterminado.
port Especifica el número de puerto que se usará para conectarse al servidor de correo SMTP. El valor predeterminado es 25.
targetName Especifica el nombre del proveedor de servicios (SPN) que se usará para la autenticación al usar la protección ampliada para las transacciones SMTP. Este atributo no tiene ningún valor predeterminado.
userName Especifica el nombre de usuario que se usará para la autenticación en el servidor de correo SMTP. Este atributo no tiene ningún valor predeterminado.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
Elemento <smtp> (configuración de red) Configura las opciones de envío de correo del Protocolo simple de transporte de correo (SMTP).

Comentarios

Algunos servidores SMTP requieren que se autentique en el servidor antes de usarlo. Si desea autenticarse con las credenciales de red predeterminadas en el host, establezca defaultCredentials el atributo en true . La SmtpNetworkElement.DefaultCredentials propiedad se puede usar para obtener el valor actual del atributo de los archivos de configuración defaultCredentials aplicables.

También puede usar la autenticación básica (un nombre de usuario y una contraseña) para autenticarse en el servidor SMTP. Para usar esta opción, debe especificar un nombre de usuario y una contraseña válidos para el servidor SMTP especificado.

Nota

La autenticación básica envía userName los valores y al servidor sin password cifrar. Cualquier persona que supervisa el tráfico de red puede ver sus credenciales y usarlas para conectarse al servidor. Debe considerar el uso de un mecanismo de autenticación más seguro, como Kerberos o NT LAN Manager (NTLM). Si defaultCredentials es , se usará Kerberos o true NTLM si el servidor admite estos protocolos.

Las opciones de autenticación básica y credenciales de red predeterminadas son mutuamente excluyentes. si establece en y especifica un nombre de usuario y una contraseña, se usa la credencial de red predeterminada y se omiten los datos de defaultCredentials true autenticación básica.

Para la autenticación básica si especifica un , también debe especificar un userName para password autenticarse usted mismo en el servidor de correo.

La SmtpNetworkElement.UserName propiedad se puede usar para obtener el valor actual del atributo de los archivos de configuración userName aplicables. La SmtpNetworkElement.Password propiedad se puede usar para obtener el valor actual del atributo de los archivos de configuración password aplicables. Normalmente, password un atributo no se especificaría en los archivos de configuración por motivos de seguridad.

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

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

El enableSsl atributo especifica si se usa SSL para acceder a un servidor de correo SMTP. La clase solo admite la extensión de servicio SMTP para SMTP seguro sobre la seguridad de la capa de transporte, tal como System.Net.Mail.SmtpClient se define en RFC 3207. En este modo, la sesión SMTP comienza en un canal sin cifrar y, a continuación, el cliente emite un comando STARTTLS al servidor para cambiar a una comunicación segura mediante SSL. Consulte RFC 3207 publicado por internet Engineering Task Force (IETF) para obtener más información.

Un método de conexión alternativo es donde se establece una sesión SSL por adelantado antes de enviar los comandos de protocolo. Este método de conexión se denomina a veces SMTPS y, de forma predeterminada, usa el puerto 465. Este método de conexión alternativo que usa SSL no se admite actualmente.

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

Ejemplo

En el ejemplo siguiente se especifican los parámetros SMTP adecuados para enviar correo electrónico con 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>  

Consulta también