<network>-Element (Netzwerkeinstellungen)

Artikel
06/08/2023

Konfiguriert die Netzwerkoptionen für einen externen SMTP-Server (Simple Mail Transport Protocol).

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

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

attribute	Beschreibung
`clientDomain`	Gibt den Clientdomänennamen an, der in der anfänglichen SMTP-Protokollanforderung verwendet werden soll, um eine Verbindung mit dem SMTP-Mailserver herzustellen. Der Standardwert ist der Localhost-Name des lokalen Computers, der die Anforderung sendet.
`defaultCredentials`	Gibt an, ob die Standard-Benutzeranmeldeinformationen verwendet werden sollen, um für SMTP-Transaktionen auf den SMTP-Mailserver zuzugreifen. Der Standardwert ist `false`.
`enableSsl`	Gibt an, ob SSL verwendet wird, um auf einen SMTP-Mailserver zuzugreifen. Der Standardwert ist `false`.
`host`	Gibt den Hostnamen des SMTP-Mailservers an, der für SMTP-Transaktionen verwendet werden soll. Dieses Attribut hat keinen Standardwert.
`password`	Gibt das Kennwort an, das für die Authentifizierung beim SMTP-Mailserver verwendet werden soll. Dieses Attribut hat keinen Standardwert.
`port`	Gibt die Portnummer an, die zum Herstellen einer Verbindung mit dem SMTP-Mailserver verwendet werden soll. Der Standardwert ist 25.
`targetName`	Gibt den Dienstanbieternamen (Service Provider Name, SPN) an, der zur Authentifizierung verwendet werden soll, wenn der erweiterte Schutz für SMTP-Transaktionen verwendet wird. Dieses Attribut hat keinen Standardwert.
`userName`	Gibt den Benutzernamen an, der für die Authentifizierung beim SMTP-Mailserver verwendet werden soll. Dieses Attribut hat keinen Standardwert.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	Beschreibung
<smtp>-Element (Netzwerkeinstellungen)	Konfiguriert SMTP-E-Mail-Sendeoptionen (Simple Mail Transport Protocol).

Bemerkungen

Bei manchen SMTP-Servern ist vor der Verwendung eine Authentifizierung erforderlich. Wenn Sie sich mit den Standard-Netzwerkanmeldeinformationen auf Ihrem Host authentifizieren möchten, legen Sie das defaultCredentials-Attribut auf true fest. Die SmtpNetworkElement.DefaultCredentials-Eigenschaft kann verwendet werden, um den aktuellen Wert des defaultCredentials-Attributs aus den entsprechenden Konfigurationsdateien abzurufen.

Sie können auch die Standardauthentifizierung (Benutzername und Kennwort) verwenden, um sich beim SMTP-Server zu authentifizieren. Dazu müssen ein gültiger Benutzername und ein gültiges Kennwort für den angegebenen SMTP-Server angegeben werden.

Hinweis

Bei der Standardauthentifizierung werden die Werte userName und password unverschlüsselt an den Server gesendet. Jede Person, die den Netzwerkdatenverkehr überwacht, kann Ihre Anmeldeinformationen sehen und zum Herstellen einer Verbindung mit dem Server verwenden. Es empfiehlt sich, einen sichereren Authentifizierungsmechanismus wie Kerberos oder den NT-LAN-Manager (NTLM) zu verwenden. Wenn defaultCredentials auf true festgelegt ist, wird Kerberos oder NTLM verwendet, sofern der Server diese Protokolle unterstützt.

Die Optionen für die Standardauthentifizierung und für die Standard-Netzwerkanmeldeinformationen schließen sich gegenseitig aus. Wenn Sie defaultCredentials auf true festlegen und einen Benutzernamen und ein Kennwort angeben, werden die Standard-Netzwerkanmeldeinformationen verwendet, und die Standardauthentifizierungsdaten werden ignoriert.

Wenn Sie für die Standardauthentifizierung einen Benutzernamen (userName) angeben, müssen Sie auch ein Kennwort (password) angeben, um sich beim Mailserver zu authentifizieren.

Die SmtpNetworkElement.UserName-Eigenschaft kann verwendet werden, um den aktuellen Wert des userName-Attributs aus den entsprechenden Konfigurationsdateien abzurufen. Die SmtpNetworkElement.Password-Eigenschaft kann verwendet werden, um den aktuellen Wert des password-Attributs aus den entsprechenden Konfigurationsdateien abzurufen. Ein password-Attribut wird aus Sicherheitsgründen normalerweise nicht in Konfigurationsdateien eingegeben.

Das clientDomain-Attribut ändert den Clientdomänennamen, der in der ursprünglichen SMTP-Protokollanforderung für einen SMTP-Server verwendet wurde. Das clientDomain-Attribut kann auf den vollqualifizierten Domänennamen des lokalen Computers festgelegt werden (anstelle des standardmäßig verwendeten Localhost-Namens). Dies verbessert die Konformität mit den SMTP-Protokollstandards. Der Standardwert ist der Localhost-Name des lokalen Computers, der die Anforderung sendet. Die SmtpNetworkElement.ClientDomain-Eigenschaft kann verwendet werden, um den aktuellen Wert des clientDomain-Attributs aus den entsprechenden Konfigurationsdateien abzurufen.

Das targetName-Attribut wird zur Authentifizierung bei Verwendung des erweiterten Schutzes verwendet. Der Standardwert hat das Format „SMTPSVC/<Host>“, wobei <Host> der Hostname des SMTP-Mailservers ist. Die SmtpNetworkElement.TargetName-Eigenschaft kann verwendet werden, um den aktuellen Wert des targetName-Attributs aus den entsprechenden Konfigurationsdateien abzurufen.

Das enableSsl-Attribut gibt an, ob SSL verwendet wird, um auf einen SMTP-Mailserver zuzugreifen. Die System.Net.Mail.SmtpClient-Klasse unterstützt nur die SMTP-Diensterweiterung für SMTPS über TLS, wie in RFC 3207 definiert. In diesem Modus beginnt die SMTP-Sitzung in einem unverschlüsselten Kanal. Anschließend wird vom Client ein STARTTLS-Befehl an den Server gesendet, um zur sicheren Kommunikation über SSL zu wechseln. Weitere Informationen finden Sie in der RFC 3207, die von der Internet Engineering Task Force (IETF) veröffentlicht wird.

Bei einer alternativen Verbindungsmethode wird vorab eine SSL-Sitzung eingerichtet, bevor Protokollbefehle gesendet werden. Diese Verbindungsmethode wird manchmal als SMTPS bezeichnet und verwendet standardmäßig den Port 465. Diese alternative Verbindungsmethode mit SSL wird derzeit nicht unterstützt.

Die SmtpNetworkElement.EnableSsl-Eigenschaft kann verwendet werden, um den aktuellen Wert des enableSsl-Attributs aus den entsprechenden Konfigurationsdateien abzurufen.

Beispiel

Im folgenden Codebeispiel werden die entsprechenden SMTP-Parameter angegeben, um E-Mails unter Verwendung der Standard-Netzwerkanmeldeinformationen zu senden:

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

Freigeben über