HttpListener.AuthenticationSchemes Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.HttpListener.dll

Исходный код:

HttpListener.cs

Возвращает или задает схему, используемую для аутентификации клиентов.

public:
 property System::Net::AuthenticationSchemes AuthenticationSchemes { System::Net::AuthenticationSchemes get(); void set(System::Net::AuthenticationSchemes value); };

public System.Net.AuthenticationSchemes AuthenticationSchemes { get; set; }

member this.AuthenticationSchemes : System.Net.AuthenticationSchemes with get, set

Public Property AuthenticationSchemes As AuthenticationSchemes

Значение свойства

AuthenticationSchemes

Битовая комбинация значений перечисления AuthenticationSchemes, которая указывает, как клиенты должны проходить аутентификацию. Значение по умолчанию — Anonymous.

Исключения

ObjectDisposedException

Объект закрыт.

Примеры

В следующем примере кода показано использование AuthenticationSchemes свойства для указания схемы проверки подлинности.

public static void SimpleListenerWithUnsafeAuthentication(string[] prefixes)
{
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length == 0)
      throw new ArgumentException("prefixes");
    // Set up a listener.
    HttpListener listener = new HttpListener();
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    // Specify Negotiate as the authentication scheme.
    listener.AuthenticationSchemes = AuthenticationSchemes.Negotiate;
    // If NTLM is used, we will allow multiple requests on the same
    // connection to use the authentication information of first request.
    // This improves performance but does reduce the security of your
    // application.
    listener.UnsafeConnectionNtlmAuthentication = true;
    // This listener does not want to receive exceptions
    // that occur when sending the response to the client.
    listener.IgnoreWriteExceptions = true;
    Console.WriteLine("Listening...");
    // ... process requests here.

    listener.Close();
}

Public Shared Sub SimpleListenerWithUnsafeAuthentication(ByVal prefixes As String())
    ' URI prefixes are required,
    ' for example "http://contoso.com:8080/index/".
    If prefixes Is Nothing OrElse prefixes.Length = 0 Then Throw New ArgumentException("prefixes")
    ' Set up a listener.
    Dim listener As HttpListener = New HttpListener()

    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next

    listener.Start()
    ' Specify Negotiate as the authentication scheme.
    listener.AuthenticationSchemes = AuthenticationSchemes.Negotiate
    ' If NTLM Is used, we will allow multiple requests on the same
    ' connection to use the authentication information of first request.
    ' This improves performance but does reduce the security of your 
    ' application. 
    listener.UnsafeConnectionNtlmAuthentication = True
    ' This listener does Not want to receive exceptions 
    ' that occur when sending the response to the client.
    listener.IgnoreWriteExceptions = True
    Console.WriteLine("Listening...")
    ' ... process requests here.

    listener.Close()
End Sub

Комментарии

Использует HttpListener указанную схему для проверки подлинности всех входящих запросов. Методы GetContext и EndGetContext возвращают входящий клиентский запрос только в том случае, HttpListener если успешно прошел проверку подлинности запроса.

Вы можете проверить удостоверение клиента, успешно прошедшего проверку подлинности HttpListenerContext.User , с помощью свойства .

Если требуется HttpListener , чтобы объект использовал различные механизмы проверки подлинности на основе характеристик получаемых запросов (например, свойства запроса Url или UserHostName ), необходимо реализовать метод, который выбирает схему проверки подлинности. Инструкции о том, как это сделать, см. в документации по свойствам AuthenticationSchemeSelectorDelegate .

Примечание

Чтобы задать это свойство для включения Digest, NTLM или Negotiate, требуется SecurityPermission, ControlPrincipal.