<network> Element (nätverksinställningar)

Konfigurerar nätverksalternativen för en extern 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"
/>

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attributes

Attribute Description
clientDomain Anger det klientdomännamn som ska användas i den första SMTP-protokollbegäran för att ansluta till SMTP-e-postservern. Standardvärdet är localhost-namnet på den lokala dator som skickar begäran.
defaultCredentials Anger om standardanvändarautentiseringsuppgifterna ska användas för att komma åt SMTP-e-postservern för SMTP-transaktioner. Standardvärdet är false.
enableSsl Anger om SSL används för att komma åt en SMTP-e-postserver. Standardvärdet är false.
host Anger värdnamnet för SMTP-e-postservern som ska användas för SMTP-transaktioner. Det här attributet har inget standardvärde.
password Anger lösenordet som ska användas för autentisering till SMTP-e-postservern. Det här attributet har inget standardvärde.
port Anger det portnummer som ska användas för att ansluta till SMTP-e-postservern. Standardvärdet är 25.
targetName Anger det tjänstleverantörsnamn (SPN) som ska användas för autentisering när utökat skydd används för SMTP-transaktioner. Det här attributet har inget standardvärde.
userName Anger det användarnamn som ska användas för autentisering till SMTP-e-postservern. Det här attributet har inget standardvärde.

Underordnade element

Ingen.

Överordnade element

Komponent Description
<smtp-element> (nätverksinställningar) Konfigurerar alternativ för SMTP-e-postöverföring (Simple Mail Transport Protocol).

Anmärkningar

Vissa SMTP-servrar kräver att du autentiserar dig själv till servern innan du använder den. Om du vill autentisera dig själv med standardautentiseringsuppgifterna för nätverket på värden anger du defaultCredentials attributet till true. Egenskapen SmtpNetworkElement.DefaultCredentials kan användas för att hämta det aktuella värdet för defaultCredentials attributet från tillämpliga konfigurationsfiler.

Du kan också använda grundläggande autentisering (ett användarnamn och lösenord) för att autentisera dig själv till SMTP-servern. Om du vill använda det här alternativet måste du ange ett giltigt användarnamn och lösenord för den angivna SMTP-servern.

Anmärkning

Grundläggande autentisering skickar userName värdena och password till servern okrypterade. Alla som övervakar nätverkstrafik kan visa dina autentiseringsuppgifter och använda dem för att ansluta till servern. Du bör överväga att använda en säkrare autentiseringsmekanism, till exempel Kerberos eller NT LAN Manager (NTLM.) Om defaultCredentials är trueanvänds Kerberos eller NTLM om servern stöder dessa protokoll.

De grundläggande autentiserings- och standardalternativen för nätverksautentiseringsuppgifter är ömsesidigt uteslutande. Om du anger defaultCredentials till true och anger ett användarnamn och lösenord används standardnätverksautentiseringsuppgifterna och grundläggande autentiseringsdata ignoreras.

För grundläggande autentisering om du anger en userName, bör du också ange en password till autentisering själv till e-postservern.

Egenskapen SmtpNetworkElement.UserName kan användas för att hämta det aktuella värdet för userName attributet från tillämpliga konfigurationsfiler. Egenskapen SmtpNetworkElement.Password kan användas för att hämta det aktuella värdet för password attributet från tillämpliga konfigurationsfiler. Ett password attribut anges normalt inte i konfigurationsfiler av säkerhetsskäl.

Attributet clientDomain ändrar det klientdomännamn som användes i den första SMTP-protokollbegäran till en SMTP-server. Attributet clientDomain kan anges till det fullständigt kvalificerade domännamnet för den lokala datorn i stället för det localhost-namn som används som standard. Detta ger bättre efterlevnad av SMTP-protokollstandarderna. Standardvärdet är localhost-namnet på den lokala dator som skickar begäran. Egenskapen SmtpNetworkElement.ClientDomain kan användas för att hämta det aktuella värdet för clientDomain attributet från tillämpliga konfigurationsfiler.

Attributet targetName används för autentisering när utökat skydd används. Standardvärdet är formatet "SMTPSVC/<host>" där <host> är värdnamnet för SMTP-e-postservern. Egenskapen SmtpNetworkElement.TargetName kan användas för att hämta det aktuella värdet för targetName attributet från tillämpliga konfigurationsfiler.

Attributet enableSsl anger om SSL används för att komma åt en SMTP-e-postserver. Klassen System.Net.Mail.SmtpClient stöder endast SMTP-tjänsttillägget för säker SMTP över Transport Layer Security enligt definitionen i RFC 3207. I det här läget börjar SMTP-sessionen på en okrypterad kanal och sedan utfärdas ett STARTTLS-kommando av klienten till servern för att växla till säker kommunikation med hjälp av SSL. Mer information finns i RFC 3207 publicerad av IETF (Internet Engineering Task Force).

En alternativ anslutningsmetod är där en SSL-session upprättas i förväg innan protokollkommandon skickas. Den här anslutningsmetoden kallas ibland SMTPS och använder som standard port 465. Den här alternativa anslutningsmetoden med SSL stöds inte för närvarande.

Egenskapen SmtpNetworkElement.EnableSsl kan användas för att hämta det aktuella värdet för enableSsl attributet från tillämpliga konfigurationsfiler.

Example

I följande exempel anges lämpliga SMTP-parametrar för att skicka e-post med standardautentiseringsuppgifterna för nätverket.

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

Se även

  • Last updated on