WebResponse.IsMutuallyAuthenticated Property

Definition

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Requests.dll

Source:

WebResponse.cs

Gets a Boolean value that indicates whether mutual authentication occurred.

C#

public virtual bool IsMutuallyAuthenticated { get; }

Property Value

Boolean

true if both client and server were authenticated; otherwise, false.

Examples

The following code example checks the value of this property.

C#

// The following example uses the System, System.Net,
// and System.IO namespaces.

public static void RequestMutualAuth(Uri resource)
{
    // Create a new HttpWebRequest object for the specified resource.
    WebRequest request=(WebRequest) WebRequest.Create(resource);
    // Request mutual authentication.
   request.AuthenticationLevel = AuthenticationLevel.MutualAuthRequested;
    // Supply client credentials.
    request.Credentials = CredentialCache.DefaultCredentials;
    HttpWebResponse response = (HttpWebResponse) request.GetResponse();
    // Determine whether mutual authentication was used.
    Console.WriteLine("Is mutually authenticated? {0}", response.IsMutuallyAuthenticated);
    // Read and display the response.
    Stream streamResponse = response.GetResponseStream();
    StreamReader streamRead = new StreamReader(streamResponse);
    string responseString = streamRead.ReadToEnd();
   Console.WriteLine(responseString);
    // Close the stream objects.
    streamResponse.Close();
    streamRead.Close();
    // Release the HttpWebResponse.
    response.Close();
}

Remarks

To request mutual authentication, set the WebRequest.AuthenticationLevel property using the MutualAuthRequested or MutualAuthRequired enumeration value. The default value for the WebRequest.AuthenticationLevel property contains Delegation and MutualAuthRequested.

Note that getting this property can throw ObjectDisposedException.

Applies to