Partager via

<network> Élément (Paramètres réseau)

Configure les options réseau d’un serveur SMTP (Simple Mail Transport Protocol) externe.

<Configuration>
   <system.net>
     <mailSettings>
       <Smtp>
         <réseau>

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributes

Caractéristique Descriptif
clientDomain Spécifie le nom de domaine client à utiliser dans la demande de protocole SMTP initiale pour se connecter au serveur de messagerie SMTP. La valeur par défaut est le nom localhost de l’ordinateur local envoyant la requête.
defaultCredentials Spécifie si les informations d’identification utilisateur par défaut doivent être utilisées pour accéder au serveur de messagerie SMTP pour les transactions SMTP. La valeur par défaut est false.
enableSsl Spécifie si SSL est utilisé pour accéder à un serveur de messagerie SMTP. La valeur par défaut est false.
host Spécifie le nom d’hôte du serveur de messagerie SMTP à utiliser pour les transactions SMTP. Cet attribut n’a aucune valeur par défaut.
password Spécifie le mot de passe à utiliser pour l’authentification auprès du serveur de messagerie SMTP. Cet attribut n’a aucune valeur par défaut.
port Spécifie le numéro de port à utiliser pour se connecter au serveur de messagerie SMTP. La valeur par défaut est 25.
targetName Spécifie le nom du fournisseur de services (SPN) à utiliser pour l’authentification lors de l’utilisation de la protection étendue pour les transactions SMTP. Cet attribut n’a aucune valeur par défaut.
userName Spécifie le nom d’utilisateur à utiliser pour l’authentification auprès du serveur de messagerie SMTP. Cet attribut n’a aucune valeur par défaut.

Éléments enfants

Aucun.

Éléments parents

Élément Descriptif
<smtp> , élément (paramètres réseau) Configure les options d’envoi de courrier SMTP (Simple Mail Transport Protocol).

Remarques

Certains serveurs SMTP nécessitent que vous vous authentifiez auprès du serveur avant d’utiliser. Si vous souhaitez vous authentifier à l’aide des informations d’identification réseau par défaut sur votre hôte, définissez l’attribut defaultCredentialstruesur . La SmtpNetworkElement.DefaultCredentials propriété peut être utilisée pour obtenir la valeur actuelle de l’attribut defaultCredentials à partir des fichiers de configuration applicables.

Vous pouvez également utiliser l’authentification de base (un nom d’utilisateur et un mot de passe) pour vous authentifier auprès du serveur SMTP. Pour utiliser cette option, vous devez spécifier un nom d’utilisateur et un mot de passe valides pour le serveur SMTP spécifié.

Note

L’authentification de base envoie les valeurs et userName les password valeurs au serveur non chiffré. Toute personne qui surveille le trafic réseau peut afficher vos informations d’identification et les utiliser pour se connecter au serveur. Vous devez envisager d’utiliser un mécanisme d’authentification plus sécurisé, tel que Kerberos ou NT LAN Manager (NTLM.) Si defaultCredentials c’est truele cas, Kerberos ou NTLM sera utilisé si le serveur prend en charge ces protocoles.

Les options d’authentification de base et d’informations d’identification réseau par défaut s’excluent mutuellement ; si vous définissez defaultCredentialstrue et spécifiez un nom d’utilisateur et un mot de passe, les informations d’identification réseau par défaut sont utilisées et les données d’authentification de base sont ignorées.

Pour l’authentification de base si vous spécifiez un userName, vous devez également spécifier une password authentification pour vous-même auprès du serveur de messagerie.

La SmtpNetworkElement.UserName propriété peut être utilisée pour obtenir la valeur actuelle de l’attribut userName à partir des fichiers de configuration applicables. La SmtpNetworkElement.Password propriété peut être utilisée pour obtenir la valeur actuelle de l’attribut password à partir des fichiers de configuration applicables. Un password attribut n’est normalement pas entré dans les fichiers de configuration pour des raisons de sécurité.

L’attribut clientDomain modifie le nom de domaine client utilisé dans la demande de protocole SMTP initiale sur un serveur SMTP. L’attribut clientDomain peut être défini sur le nom de domaine complet de l’ordinateur local, plutôt que le nom localhost utilisé par défaut. Cela offre une plus grande conformité aux normes du protocole SMTP. La valeur par défaut est le nom localhost de l’ordinateur local envoyant la requête. La SmtpNetworkElement.ClientDomain propriété peut être utilisée pour obtenir la valeur actuelle de l’attribut clientDomain à partir des fichiers de configuration applicables.

L’attribut targetName est utilisé pour l’authentification lors de l’utilisation de la protection étendue. La valeur par défaut est de la forme « SMTPSVC/<host> », où <host> est le nom d’hôte du serveur de messagerie SMTP. La SmtpNetworkElement.TargetName propriété peut être utilisée pour obtenir la valeur actuelle de l’attribut targetName à partir des fichiers de configuration applicables.

L’attribut enableSsl spécifie si SSL est utilisé pour accéder à un serveur de messagerie SMTP. La System.Net.Mail.SmtpClient classe prend uniquement en charge l’extension de service SMTP pour le protocole SMTP sécurisé sur transport Layer Security tel que défini dans RFC 3207. Dans ce mode, la session SMTP commence sur un canal non chiffré, puis une commande STARTTLS est émise par le client au serveur pour basculer vers la communication sécurisée à l’aide du protocole SSL. Pour plus d’informations, voir RFC 3207 publié par internet Engineering Task Force (IETF).

Une autre méthode de connexion est l’emplacement où une session SSL est établie avant l’envoi de commandes de protocole. Cette méthode de connexion est parfois appelée SMTPS et utilise par défaut le port 465. Cette autre méthode de connexion utilisant SSL n’est actuellement pas prise en charge.

La SmtpNetworkElement.EnableSsl propriété peut être utilisée pour obtenir la valeur actuelle de l’attribut enableSsl à partir des fichiers de configuration applicables.

Example

L’exemple suivant spécifie les paramètres SMTP appropriés pour envoyer un e-mail à l’aide des informations d’identification réseau par défaut.

<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>

Voir aussi

  • Last updated on