<network> Element (netwerkinstellingen)

Hiermee configureert u de netwerkopties voor een externe SMTP-server (Simple Mail Transport Protocol).

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

Syntaxis

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Attributes

Attribute Description
clientDomain Hiermee geeft u de clientdomeinnaam op die moet worden gebruikt in de eerste SMTP-protocolaanvraag om verbinding te maken met de SMTP-e-mailserver. De standaardwaarde is de localhost-naam van de lokale computer die de aanvraag verzendt.
defaultCredentials Hiermee geeft u op of de standaardgebruikersreferenties moeten worden gebruikt voor toegang tot de SMTP-e-mailserver voor SMTP-transacties. De standaardwaarde is false.
enableSsl Hiermee geeft u op of SSL wordt gebruikt voor toegang tot een SMTP-e-mailserver. De standaardwaarde is false.
host Hiermee geeft u de hostnaam op van de SMTP-e-mailserver die moet worden gebruikt voor SMTP-transacties. Dit kenmerk heeft geen standaardwaarde.
password Hiermee geeft u het wachtwoord op dat moet worden gebruikt voor verificatie bij de SMTP-e-mailserver. Dit kenmerk heeft geen standaardwaarde.
port Hiermee geeft u het poortnummer op dat moet worden gebruikt om verbinding te maken met de SMTP-e-mailserver. De standaardwaarde is 25.
targetName Hiermee geeft u de SPN (Service Provider Name) die moet worden gebruikt voor verificatie bij het gebruik van uitgebreide beveiliging voor SMTP-transacties. Dit kenmerk heeft geen standaardwaarde.
userName Hiermee geeft u de gebruikersnaam op die moet worden gebruikt voor verificatie bij de SMTP-e-mailserver. Dit kenmerk heeft geen standaardwaarde.

Kind-elementen

Geen.

Bovenliggende elementen

Onderdeel Description
<smtp-element> (netwerkinstellingen) Configureert smtp-opties (Simple Mail Transport Protocol) voor het verzenden van e-mail.

Opmerkingen

Voor sommige SMTP-servers moet u uzelf verifiëren bij de server voordat u deze gebruikt. Als u uzelf wilt verifiëren met behulp van de standaardnetwerkreferenties op uw host, stelt u het defaultCredentials kenmerk in trueop . De SmtpNetworkElement.DefaultCredentials eigenschap kan worden gebruikt om de huidige waarde van het defaultCredentials kenmerk op te halen uit toepasselijke configuratiebestanden.

U kunt ook basisverificatie (een gebruikersnaam en wachtwoord) gebruiken om uzelf te verifiëren bij de SMTP-server. Als u deze optie wilt gebruiken, moet u een geldige gebruikersnaam en wachtwoord opgeven voor de opgegeven SMTP-server.

Opmerking

Met basisverificatie worden de userName en password waarden naar de server niet-versleuteld verzonden. Iedereen die netwerkverkeer bewaakt, kan uw referenties bekijken en gebruiken om verbinding te maken met de server. U moet overwegen een veiliger verificatiemechanisme te gebruiken, zoals Kerberos of NT LAN Manager (NTLM.) Als defaultCredentials dat zo is true, wordt Kerberos of NTLM gebruikt als de server deze protocollen ondersteunt.

De basisverificatie- en standaardopties voor netwerkreferenties sluiten elkaar wederzijds uit; als u een gebruikersnaam en wachtwoord instelt defaultCredentialstrue en opgeeft, wordt de standaardnetwerkreferentie gebruikt en worden de basisverificatiegegevens genegeerd.

Als u een userNamebasisverificatie opgeeft, moet u ook zelf een password verificatie naar de e-mailserver opgeven.

De SmtpNetworkElement.UserName eigenschap kan worden gebruikt om de huidige waarde van het userName kenmerk op te halen uit toepasselijke configuratiebestanden. De SmtpNetworkElement.Password eigenschap kan worden gebruikt om de huidige waarde van het password kenmerk op te halen uit toepasselijke configuratiebestanden. Een password kenmerk wordt normaal gesproken om veiligheidsredenen niet ingevoerd in configuratiebestanden.

Het clientDomain kenmerk wijzigt de clientdomeinnaam die wordt gebruikt in de eerste SMTP-protocolaanvraag naar een SMTP-server. Het clientDomain kenmerk kan worden ingesteld op de volledig gekwalificeerde domeinnaam van de lokale computer, in plaats van de localhost-naam die standaard wordt gebruikt. Dit biedt meer naleving van de SMTP-protocolstandaarden. De standaardwaarde is de localhost-naam van de lokale computer die de aanvraag verzendt. De SmtpNetworkElement.ClientDomain eigenschap kan worden gebruikt om de huidige waarde van het clientDomain kenmerk op te halen uit toepasselijke configuratiebestanden.

Het targetName kenmerk wordt gebruikt voor verificatie bij het gebruik van uitgebreide beveiliging. De standaardwaarde is van het formulier SMTPSVC/<host>, waarbij <host> de hostnaam van de SMTP-e-mailserver is. De SmtpNetworkElement.TargetName eigenschap kan worden gebruikt om de huidige waarde van het targetName kenmerk op te halen uit toepasselijke configuratiebestanden.

Het enableSsl kenmerk geeft aan of SSL wordt gebruikt voor toegang tot een SMTP-e-mailserver. De System.Net.Mail.SmtpClient klasse ondersteunt alleen de SMTP-serviceextensie voor secure SMTP via Transport Layer Security, zoals gedefinieerd in RFC 3207. In deze modus begint de SMTP-sessie op een niet-versleuteld kanaal en wordt er door de client een STARTTLS-opdracht uitgegeven om over te schakelen naar beveiligde communicatie via SSL. Zie RFC 3207 gepubliceerd door de Internet Engineering Task Force (IETF) voor meer informatie.

Een alternatieve verbindingsmethode is de plek waar een SSL-sessie vooraf tot stand wordt gebracht voordat protocolopdrachten worden verzonden. Deze verbindingsmethode wordt ook wel SMTPS genoemd en maakt standaard gebruik van poort 465. Deze alternatieve verbindingsmethode met SSL wordt momenteel niet ondersteund.

De SmtpNetworkElement.EnableSsl eigenschap kan worden gebruikt om de huidige waarde van het enableSsl kenmerk op te halen uit toepasselijke configuratiebestanden.

Example

In het volgende voorbeeld worden de juiste SMTP-parameters opgegeven voor het verzenden van e-mail met behulp van de standaardnetwerkreferenties.

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

Zie ook

  • Last updated on