SmtpClient.TargetName Property

Definition

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Source:

SmtpClient.cs

Gets or sets the Service Provider Name (SPN) to use for authentication when using extended protection.

public:
 property System::String ^ TargetName { System::String ^ get(); void set(System::String ^ value); };

public string? TargetName { get; set; }

member this.TargetName : string with get, set

Public Property TargetName As String

Property Value

String

A String that specifies the SPN to use for extended protection. The default value for this SPN is of the form "SMTPSVC/<host>" where <host> is the hostname of the SMTP mail server.

Remarks

The TargetName property is used with integrated Windows authentication when an application is using extended protection. The SmtpClient can then provide extended protection to ensure that credential challenge responses contain service specific information (a SPN) and, if necessary, channel specific information (a channel binding token or CBT). With this information in the credential exchanges, services are able to better protect against malicious use of credential challenge responses that might have been improperly obtained.

The default value for this property can also be set in a machine or application configuration file. Any changes made to the TargetName property override the configuration file settings.

See also

• SmtpSection
• SmtpNetworkElement
• TargetName
• Integrated Windows Authentication with Extended Protection
• <mailSettings> Element (Network Settings)
• <smtp> Element (Network Settings)
• <network> Element (Network Settings)