WebResponse::IsMutuallyAuthenticated Property

 

Gets a Boolean value that indicates whether mutual authentication occurred.

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

public:
property bool IsMutuallyAuthenticated {
	virtual bool 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.
static void RequestMutualAuth( Uri^ resource )
{
   // Create a new HttpWebRequest object for the specified resource.
   WebRequest^ request = dynamic_cast<WebRequest^>(WebRequest::Create( resource ));

   // Request mutual authentication.
   request->AuthenticationLevel = AuthenticationLevel::MutualAuthRequested;

   // Supply client credentials.
   request->Credentials = CredentialCache::DefaultCredentials;
   HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());

   // Determine whether mutual authentication was used.
   Console::WriteLine( L"Is mutually authenticated? {0}", response->IsMutuallyAuthenticated );

   // Read and display the response.
   Stream^ streamResponse = response->GetResponseStream();
   StreamReader^ streamRead = gcnew StreamReader( streamResponse );
   String^ responseString = streamRead->ReadToEnd();
   Console::WriteLine( responseString );

   // Close the stream objects.
   streamResponse->Close();
   streamRead->Close();

   // Release the HttpWebResponse.
   response->Close();
}

.NET Framework
Available since 2.0
Return to top
Show: