<red> elemento (configuración de red)<network> Element (Network Settings)

Configura las opciones de red para un servidor de Protocolo Simple de transferencia de correo (SMTP) externo.Configures the network options for an external Simple Mail Transport Protocol (SMTP) server.

<configuration><configuration>
<System.NET ><system.net>
<mailSettings ><mailSettings>
<SMTP ><smtp>
<red ><network>

SintaxisSyntax

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

Atributos y elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescripciónDescription
clientDomain Especifica el nombre de dominio de cliente para usar en la solicitud de protocolo SMTP inicial para conectarse al servidor de correo SMTP.Specifies the client domain name to use in the initial SMTP protocol request to connect to the SMTP mail server. El valor predeterminado es el nombre de host local del equipo local envía la solicitud.The default value is the localhost name of the local computer sending the request.
defaultCredentials Especifica si se deben usar las credenciales de usuario predeterminadas para tener acceso al servidor de correo SMTP para las transacciones SMTP.Specifies whether the default user credentials should be used to access the SMTP mail server for SMTP transactions. El valor predeterminado es false.The default value is false.
enableSsl Especifica si se usa SSL para tener acceso a un servidor de correo SMTP.Specifies whether SSL is used to access an SMTP mail server. El valor predeterminado es false.The default value is false.
host Especifica el nombre de host del servidor de correo SMTP que se utilizará para las transacciones SMTP.Specifies the hostname of the SMTP mail server to use for SMTP transactions. Este atributo tiene ningún valor predeterminado.This attribute has no default value.
password Especifica la contraseña que se utilizará para la autenticación en el servidor de correo SMTP.Specifies the password to use for authentication to the SMTP mail server. Este atributo tiene ningún valor predeterminado.This attribute has no default value.
port Especifica el número de puerto para conectarse al servidor de correo SMTP.Specifies the port number to use to connect to the SMTP mail server. El valor predeterminado es 25.The default value is 25.
targetName Especifica el nombre de proveedor de servicio (SPN) que se usará para la autenticación al usar la protección ampliada para las transacciones SMTP.Specifies the Service Provider Name (SPN) to use for authentication when using extended protection for SMTP transactions. Este atributo tiene ningún valor predeterminado.This attribute has no default value.
userName Especifica el nombre de usuario que se usará para la autenticación en el servidor de correo SMTP.Specifies the user name to use for authentication to the SMTP mail server. Este atributo tiene ningún valor predeterminado.This attribute has no default value.

Elementos secundariosChild Elements

Ninguno.None.

Elementos primariosParent Elements

ElementoElement DescripciónDescription
<SMTP > elemento (configuración de red)<smtp> Element (Network Settings) Configura las opciones de envío de correo de Protocolo Simple de transferencia de correo (SMTP).Configures Simple Mail Transport Protocol (SMTP) mail sending options.

ComentariosRemarks

Algunos servidores SMTP requieren autenticarse en el servidor antes de su uso.Some SMTP servers require that you authenticate yourself to the server before use. Si desea autenticarse utilizando las credenciales de red predeterminadas en el host, establezca el defaultCredentials atributo true.If you want to authenticate yourself using the default network credentials on your host, set the defaultCredentials attribute to true. El SmtpNetworkElement.DefaultCredentials propiedad puede usarse para obtener el valor actual de la defaultCredentials atributo desde archivos de configuración aplicables.The SmtpNetworkElement.DefaultCredentials property can be used to get the current value of the defaultCredentials attribute from applicable configuration files.

También puede usar la autenticación básica (nombre de usuario y contraseña) para autenticarse en el servidor SMTP.You can also use basic authentication (a user name and password) to authenticate yourself to the SMTP server. Para usar esta opción, debe especificar un nombre de usuario válido y una contraseña para el servidor SMTP especificado.To use this option, you must specify a valid user name and password for the specified SMTP server.

Nota

La autenticación básica envía el userName y password valores sin cifrar al servidor.Basic authentication sends the userName and password values to the server unencrypted. Cualquiera que controle el tráfico de red puede ver sus credenciales y utilizarlas para conectarse al servidor.Anyone monitoring network traffic can view your credentials and use them to connect to the server. Debe considerar el uso de un mecanismo de autenticación más seguro, por ejemplo, Kerberos o NT LAN Manager (NTLM). Si defaultCredentials es true, Kerberos o NTLM se utilizará si el servidor admite estos protocolos.You should consider using a more secure authentication mechanism, such as Kerberos or NT LAN Manager (NTLM.) If defaultCredentials is true, Kerberos or NTLM will be used if the server supports these protocols.

Las opciones de credenciales de red predeterminada y la autenticación básicas se excluyen mutuamente; Si establece defaultCredentials a true y especifique un nombre de usuario y una contraseña, se utiliza la credencial de red predeterminada y se omiten los datos de la autenticación básica.The basic authentication and default network credentials options are mutually exclusive; if you set defaultCredentials to true and specify a user name and password, the default network credential is used, and the basic authentication data is ignored.

Para la autenticación básica si especifica un userName, también debe especificar un password a la autenticación para el servidor de correo.For basic authentication if you specify a userName, you should also specify a password to authentication yourself to the mail server.

El SmtpNetworkElement.UserName propiedad puede usarse para obtener el valor actual de la userName atributo desde archivos de configuración aplicables.The SmtpNetworkElement.UserName property can be used to get the current value of the userName attribute from applicable configuration files. El SmtpNetworkElement.Password propiedad puede usarse para obtener el valor actual de la password atributo desde archivos de configuración aplicables.The SmtpNetworkElement.Password property can be used to get the current value of the password attribute from applicable configuration files. Un password atributo no normalmente se especificaría en archivos de configuración por motivos de seguridad.A password attribute would not normally be entered in configuration files for security reasons.

El clientDomain atributo cambia el nombre de dominio del cliente utilizado en la solicitud de protocolo SMTP inicial para un servidor SMTP.The clientDomain attribute changes the client domain name used in the initial SMTP protocol request to an SMTP server. El clientDomain atributo puede establecerse en el nombre de dominio completo del equipo local, en lugar de con el nombre de host local que se usa de forma predeterminada.The clientDomain attribute can be set to the fully-qualified domain name of the local machine, rather than the localhost name that is used by default. Esto proporciona mayor compatibilidad con los estándares de protocolo SMTP.This provides greater compliance with the SMTP protocol standards. El valor predeterminado es el nombre de host local del equipo local envía la solicitud.The default value is the localhost name of the local computer sending the request. El SmtpNetworkElement.ClientDomain propiedad puede usarse para obtener el valor actual de la clientDomain atributo desde archivos de configuración aplicables.The SmtpNetworkElement.ClientDomain property can be used to get the current value of the clientDomain attribute from applicable configuration files.

El targetName atributo se utiliza para la autenticación cuando se usa la protección extendida.The targetName attribute is used for authentication when using extended protection. El valor predeterminado es el formato "SMTPSVC /<host >" donde <host > es el nombre de host del servidor de correo SMTP.The default value is of the form "SMTPSVC/<host>" where <host> is the hostname of the SMTP mail server. El SmtpNetworkElement.TargetName propiedad puede usarse para obtener el valor actual de la targetName atributo desde archivos de configuración aplicables.The SmtpNetworkElement.TargetName property can be used to get the current value of the targetName attribute from applicable configuration files.

El enableSsl atributo especifica si se usa SSL para tener acceso a un servidor de correo SMTP.The enableSsl attribute specifies whether SSL is used to access an SMTP mail server. La System.Net.Mail.SmtpClient clase sólo admite la extensión de servicio SMTP para SMTP seguro a través de la seguridad de la capa de transporte como se define en RFC 3207.The System.Net.Mail.SmtpClient class only supports the SMTP Service Extension for Secure SMTP over Transport Layer Security as defined in RFC 3207. En este modo, la sesión SMTP comienza en un canal no cifrado, a continuación, se emite un comando STARTTLS por el cliente al servidor para cambiar a una comunicación segura mediante SSL.In this mode, the SMTP session begins on an unencrypted channel, then a STARTTLS command is issued by the client to the server to switch to secure communication using SSL. Vea RFC 3207 publicada por Internet Engineering Task Force (IETF) para obtener más información.See RFC 3207 published by the Internet Engineering Task Force (IETF) for more information.

Un método de conexión alternativo es donde se establece por adelantado una sesión SSL antes de cualquier protocolo que se envían comandos.An alternate connection method is where an SSL session is established up front before any protocol commands are sent. Este método de conexión a veces se denomina SMTPS y usa el puerto 465 de forma predeterminada.This connection method is sometimes called SMTPS and by default uses port 465. Este método de conexión alternativo mediante SSL no se admite actualmente.This alternate connection method using SSL is not currently supported.

El SmtpNetworkElement.EnableSsl propiedad puede usarse para obtener el valor actual de la enableSsl atributo desde archivos de configuración aplicables.The SmtpNetworkElement.EnableSsl property can be used to get the current value of the enableSsl attribute from applicable configuration files.

EjemploExample

El ejemplo siguiente especifica los parámetros SMTP adecuados para enviar correo electrónico utilizando las credenciales de red predeterminadas.The following example specifies the appropriate SMTP parameters to send email using the default network credentials.

<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énSee Also

System.Net.Configuration.SmtpNetworkElement
System.Net.Configuration.SmtpSection
System.Net.Mail.SmtpClient
Esquema de la configuración de redNetwork Settings Schema