WebRequest.AuthenticationLevel Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Requests.dll

Zdroj:

WebRequest.cs

Získá nebo nastaví hodnoty označující úroveň ověřování a zosobnění použité pro tento požadavek.

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

Hodnota vlastnosti

AuthenticationLevel

Bitové kombinace AuthenticationLevel hodnot. Výchozí hodnota je MutualAuthRequested.

Při vzájemném ověřování klient i server předkládají přihlašovací údaje k navázání své identity. Hodnoty MutualAuthRequired a MutualAuthRequested hodnoty jsou relevantní pro ověřování protokolem Kerberos. Ověřování protokolem Kerberos je možné podporovat přímo nebo se dá použít, pokud se k výběru skutečného protokolu zabezpečení používá protokol zabezpečení Negotiate. Další informace o ověřovacích protokolech naleznete v tématu Internetové ověřování.

Chcete-li zjistit, zda došlo k vzájemnému ověřování, zkontrolujte IsMutuallyAuthenticated vlastnost.

Pokud zadáte hodnotu příznaku MutualAuthRequired ověřování a neproběhne vzájemné ověřování, aplikace obdrží IOExceptionProtocolViolationException vnitřní výjimku, která značí, že vzájemné ověřování selhalo.

Příklady

Následující příklad kódu nastaví hodnotu této vlastnosti.

// 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();
}