Elemento <network> (configuración de red)
Configura las opciones de red para un servidor del Protocolo simple de transferencia de correo (SMTP) 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 del cliente que se va a usar en la solicitud de protocolo SMTP inicial para conectarse al servidor de correo SMTP. El valor predeterminado es el nombre localhost 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 va a usar para las transacciones SMTP. Este atributo no tiene ningún valor predeterminado. |
password |
Especifica la contraseña que se va a 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 va a usar para conectarse al servidor de correo SMTP. El valor predeterminado es 25. |
targetName |
Especifica el nombre del proveedor de servicios (SPN) que se va a usar para la autenticación al usar la protección extendida para transacciones SMTP. Este atributo no tiene ningún valor predeterminado. |
userName |
Especifica el nombre de usuario que se va a 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 transferencia de correo (SMTP). |
Comentarios
Algunos servidores SMTP requieren que se autentique en el servidor antes del uso. Si quiere autenticarse con las credenciales de red predeterminadas en el host, establezca el atributo defaultCredentials en true. La propiedad SmtpNetworkElement.DefaultCredentials se puede usar para obtener el valor actual del atributo defaultCredentials de los archivos de configuración 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 los valores userName y password al servidor sin cifrar. Cualquier persona que supervise el tráfico de red puede ver sus credenciales y usarlas para conectarse al servidor. Debe considerar la posibilidad de usar 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 predeterminadas de credenciales de red se excluyen mutuamente; si establece defaultCredentials en true y especifica un nombre de usuario y una contraseña, se utiliza la credencial de red predeterminar y se omiten los datos de autenticación básica.
En el caso de la autenticación básica, si especifica userName, también debe especificar password para autenticarse en el servidor de correo.
La propiedad SmtpNetworkElement.UserName se puede usar para obtener el valor actual del atributo userName de los archivos de configuración aplicables. La propiedad SmtpNetworkElement.Password se puede usar para obtener el valor actual del atributo password de los archivos de configuración aplicables. Por lo general, un atributo password no se escribiría en los archivos de configuración por motivos de seguridad.
El atributo clientDomain cambia el nombre de dominio del cliente que se usa en la solicitud del protocolo SMTP inicial a un servidor SMTP. El atributo clientDomain se puede establecer en el nombre de dominio completo de la máquina local en lugar del nombre de localhost que se usa de manera predeterminada. Esto proporciona un mayor cumplimiento con los estándares del protocolo SMTP. El valor predeterminado es el nombre localhost del equipo local que envía la solicitud. La propiedad SmtpNetworkElement.ClientDomain se puede usar para obtener el valor actual del atributo clientDomain de los archivos de configuración aplicables.
El atributo targetName se usa para la autenticación al usar la protección ampliada. El valor predeterminado tiene el formato "SMTPSVC/<host>", en el que <host> es el nombre de host del servidor de correo SMTP. La propiedad SmtpNetworkElement.TargetName se puede usar para obtener el valor actual del atributo targetName de los archivos de configuración aplicables.
El atributo enableSsl especifica si se usa SSL para acceder a un servidor de correo SMTP. La clase System.Net.Mail.SmtpClient solo admite la extensión de servicio SMTP para SMTP seguro sobre la Seguridad de la capa de transporte, según lo definido en RFC 3207. En este modo, la sesión SMTP comienza en un canal sin cifrar y, luego, el cliente emite un comando STARTTLS al servidor para cambiar a una comunicación segura mediante SSL. Para más información, consulte el documento RFC 3207, publicado por el Grupo de trabajo de ingeniería de Internet (IETF).
Un método de conexión alternativo es donde se establece una sesión SSL por adelantado antes de que se envíen comandos de protocolo. Este método de conexión se denomina a veces SMTPS y, de manera predeterminada, usa el puerto 465. Actualmente, no se admite este método de conexión alternativo mediante SSL.
La propiedad SmtpNetworkElement.EnableSsl se puede usar para obtener el valor actual del atributo enableSsl de los archivos de configuración aplicables.
Ejemplo
En el ejemplo siguiente, se especifican 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>
