WebRequest.AuthenticationLevel Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen von Werten, die die Ebene der Authentifizierung und des Identitätswechsels für diese Anforderung angeben.
public:
property System::Net::Security::AuthenticationLevel AuthenticationLevel { System::Net::Security::AuthenticationLevel get(); void set(System::Net::Security::AuthenticationLevel value); };
public System.Net.Security.AuthenticationLevel AuthenticationLevel { get; set; }
member this.AuthenticationLevel : System.Net.Security.AuthenticationLevel with get, set
Public Property AuthenticationLevel As AuthenticationLevel
Eigenschaftswert
Eine bitweise Kombination der AuthenticationLevel Werte. Der Standardwert ist MutualAuthRequested.
Bei der gegenseitigen Authentifizierung stellen sowohl der Client als auch der Server Anmeldeinformationen bereit, um ihre Identität festzulegen. Die MutualAuthRequired Werte sind MutualAuthRequested für die Kerberos-Authentifizierung relevant. Die Kerberos-Authentifizierung kann direkt unterstützt oder verwendet werden, wenn das Negotiate-Sicherheitsprotokoll zum Auswählen des tatsächlichen Sicherheitsprotokolls verwendet wird. Weitere Informationen zu Authentifizierungsprotokollen finden Sie unter Internetauthentifizierung.
Überprüfen Sie die Eigenschaft, um festzustellen, ob die IsMutuallyAuthenticated gegenseitige Authentifizierung erfolgt ist.
Wenn Sie den MutualAuthRequired Authentifizierungskennzeichnungswert und die gegenseitige Authentifizierung nicht angeben, erhält Ihre Anwendung eine IOExceptionProtocolViolationException innere Ausnahme, die angibt, dass die gegenseitige Authentifizierung fehlgeschlagen ist.
Beispiele
Im folgenden Codebeispiel wird der Wert dieser Eigenschaft festgelegt.
// 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();
}