<network>, élément (paramètres réseau)

  • Article

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

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

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.

Attributs

Attribut Description
clientDomain Spécifie le nom de domaine client à utiliser dans la demande de protocole SMTP initiale pour se connecter au serveur de courrier SMTP. La valeur par défaut est le nom localhost de l’ordinateur local qui envoie la demande.
defaultCredentials Spécifie si les informations d’identification de l’utilisateur par défaut doivent être utilisées afin d’accéder au serveur de courrier 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 courrier SMTP. La valeur par défaut est false.
host Spécifie le nom d’hôte du serveur de courrier 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 courrier 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 courrier 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 courrier SMTP. Cet attribut n’a aucune valeur par défaut.

Éléments enfants

Aucune.

Éléments parents

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

Notes

Certains serveurs SMTP exigent une authentification auprès du serveur avant toute utilisation. Si vous souhaitez vous authentifier à l’aide des informations d’identification réseau par défaut sur votre hôte, définissez l’attribut defaultCredentials sur true. La propriété SmtpNetworkElement.DefaultCredentials 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é.

Notes

L’authentification de base envoie les valeurs userName et password au serveur sans les chiffrer. Toute personne surveillant le trafic réseau peut voir 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 est true, Kerberos ou NTLM sera utilisé, à condition que le serveur prenne ces protocoles en charge.

Les options d’authentification de base et d’informations d’identification réseau par défaut s’excluent mutuellement ; si vous définissez defaultCredentials sur true 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 un password pour vous authentifier auprès du serveur de courrier.

La propriété SmtpNetworkElement.UserName peut être utilisée pour obtenir la valeur actuelle de l’attribut userName à partir des fichiers de configuration applicables. La propriété SmtpNetworkElement.Password peut être utilisée pour obtenir la valeur actuelle de l’attribut password à partir des fichiers de configuration applicables. Aucun attribut password ne doit normalement être saisi 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 adressée à 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 permet un meilleur respect des normes du protocole SMTP. La valeur par défaut est le nom localhost de l’ordinateur local qui envoie la demande. La propriété SmtpNetworkElement.ClientDomain 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 dans le cadre de l’utilisation de la protection étendue. La valeur par défaut se présente sous la forme « SMTPSVC/<host> », où <host> correspond au nom d’hôte du serveur de courrier SMTP. La propriété SmtpNetworkElement.TargetName 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 courrier SMTP. La classe System.Net.Mail.SmtpClient prend uniquement en charge SMTP Service Extension for Secure SMTP over Transport Layer Security, comme défini dans le RFC 3207. Dans ce mode, la session SMTP commence sur un canal non chiffré, puis une commande STARTTLS est adressée au serveur par le client pour passer en mode de communication sécurisée par SSL. Pour plus d’informations, reportez-vous au RFC 3207 publié par l’Internet Engineering Task Force (IETF).

Une autre méthode de connexion consiste à établir une session SSL avant l’envoi de toute commande de protocole. Cette méthode de connexion est parfois appelée SMTPS et utilise par défaut le port 465. Cette méthode de connexion alternative utilisant SSL n’est actuellement pas prise en charge.

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

Exemple

L’exemple suivant spécifie les paramètres SMTP appropriés pour envoyer des e-mails à 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