IsMutuallyAuthenticated Property

WebResponse.IsMutuallyAuthenticated Property


Gets a Boolean value that indicates whether mutual authentication occurred.

Namespace:   System.Net
Assembly:  System (in System.dll)

public virtual bool IsMutuallyAuthenticated { get; }

Property Value

Type: System.Boolean

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

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.

The following code example checks the value of this property.

// 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();
    // Close the stream objects.
    // Release the HttpWebResponse.

.NET Framework
Available since 2.0
Return to top
© 2015 Microsoft