<Elemento network> (impostazioni di rete)

Articolo
04/08/2023

Configura le opzioni di rete per un server SMTP (Simple Mail Transport Protocol) esterno.

<Configurazione>
  <system.net>
    <mailSettings>
      <Smtp>
        <Rete>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
`clientDomain`	Specifica il nome di dominio client da utilizzare nella richiesta di protocollo SMTP iniziale per connettersi al server di posta SMTP. Il valore predefinito è il nome localhost del computer locale che invia la richiesta.
`defaultCredentials`	Specifica se le credenziali utente predefinite devono essere utilizzate per accedere al server di posta SMTP per le transazioni SMTP. Il valore predefinito è `false`.
`enableSsl`	Specifica se ssl viene utilizzato per accedere a un server di posta SMTP. Il valore predefinito è `false`.
`host`	Specifica il nome host del server di posta SMTP da utilizzare per le transazioni SMTP. Questo attributo non ha un valore predefinito.
`password`	Specifica la password da utilizzare per l'autenticazione al server di posta SMTP. Questo attributo non ha un valore predefinito.
`port`	Specifica il numero di porta da utilizzare per connettersi al server di posta SMTP. Il valore predefinito è 25.
`targetName`	Specifica il nome del provider di servizi da utilizzare per l'autenticazione quando si utilizza la protezione estesa per le transazioni SMTP. Questo attributo non ha un valore predefinito.
`userName`	Specifica il nome utente da utilizzare per l'autenticazione al server di posta SMTP. Questo attributo non ha un valore predefinito.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
<Elemento smtp> (impostazioni di rete)	Configura le opzioni di invio di posta elettronica SMTP (Simple Mail Transport Protocol).

Commenti

Alcuni server SMTP richiedono l'autenticazione al server prima dell'uso. Se si vuole eseguire l'autenticazione usando le credenziali di rete predefinite nell'host, impostare l'attributo defaultCredentials su true. La SmtpNetworkElement.DefaultCredentials proprietà può essere utilizzata per ottenere il valore corrente dell'attributo defaultCredentials dai file di configurazione applicabili.

È anche possibile usare l'autenticazione di base (un nome utente e una password) per eseguire l'autenticazione nel server SMTP. Per utilizzare questa opzione, è necessario specificare un nome utente e una password validi per il server SMTP specificato.

Nota

L'autenticazione di base invia i userName valori e password al server non crittografato. Chiunque monitori il traffico di rete possa visualizzare le credenziali e usarle per connettersi al server. È consigliabile usare un meccanismo di autenticazione più sicuro, ad esempio Kerberos o NT LAN Manager (NTLM). Se defaultCredentials è true, verrà usato Kerberos o NTLM se il server supporta questi protocolli.

Le opzioni di autenticazione di base e credenziali di rete predefinite si escludono a vicenda; se si imposta defaultCredentialstrue su e si specifica un nome utente e una password, vengono usate le credenziali di rete predefinite e i dati di autenticazione di base vengono ignorati.

Per l'autenticazione di base se si specifica un userName, è necessario specificare anche un password oggetto per l'autenticazione al server di posta elettronica.

La SmtpNetworkElement.UserName proprietà può essere utilizzata per ottenere il valore corrente dell'attributo userName dai file di configurazione applicabili. La SmtpNetworkElement.Password proprietà può essere utilizzata per ottenere il valore corrente dell'attributo password dai file di configurazione applicabili. Un password attributo non viene in genere immesso nei file di configurazione per motivi di sicurezza.

L'attributo clientDomain modifica il nome di dominio client utilizzato nella richiesta di protocollo SMTP iniziale a un server SMTP. L'attributo clientDomain può essere impostato sul nome di dominio completo del computer locale, anziché sul nome localhost usato per impostazione predefinita. Ciò garantisce una maggiore conformità agli standard del protocollo SMTP. Il valore predefinito è il nome localhost del computer locale che invia la richiesta. La SmtpNetworkElement.ClientDomain proprietà può essere utilizzata per ottenere il valore corrente dell'attributo clientDomain dai file di configurazione applicabili.

L'attributo targetName viene usato per l'autenticazione quando si usa la protezione estesa. Il valore predefinito è il formato "SMTPSVC/<host>", dove <host> è il nome host del server di posta SMTP. La SmtpNetworkElement.TargetName proprietà può essere utilizzata per ottenere il valore corrente dell'attributo targetName dai file di configurazione applicabili.

L'attributo enableSsl specifica se ssl viene utilizzato per accedere a un server di posta SMTP. La System.Net.Mail.SmtpClient classe supporta solo l'estensione del servizio SMTP per SMTP sicuro su Transport Layer Security, come definito in RFC 3207. In questa modalità, la sessione SMTP inizia su un canale non crittografato, quindi viene eseguito un comando STARTTLS dal client al server per passare alla comunicazione sicura tramite SSL. Per altre informazioni, vedere RFC 3207 pubblicato da Internet Engineering Task Force (IETF).

Un metodo di connessione alternativo è la posizione in cui viene stabilita una sessione SSL prima dell'invio di qualsiasi comando del protocollo. Questo metodo di connessione viene talvolta chiamato SMTPS e per impostazione predefinita usa la porta 465. Questo metodo di connessione alternativo che usa SSL non è attualmente supportato.

La SmtpNetworkElement.EnableSsl proprietà può essere utilizzata per ottenere il valore corrente dell'attributo enableSsl dai file di configurazione applicabili.

Esempio

Nell'esempio seguente vengono specificati i parametri SMTP appropriati per inviare messaggi di posta elettronica usando le credenziali di rete predefinite.

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

Condividi tramite