HttpListener.AuthenticationSchemeSelectorDelegate Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Origem:

HttpListener.cs

Obtém ou define o delegado chamado para determinar o protocolo usado para autenticar clientes.

public:
 property System::Net::AuthenticationSchemeSelector ^ AuthenticationSchemeSelectorDelegate { System::Net::AuthenticationSchemeSelector ^ get(); void set(System::Net::AuthenticationSchemeSelector ^ value); };

public System.Net.AuthenticationSchemeSelector? AuthenticationSchemeSelectorDelegate { get; set; }

member this.AuthenticationSchemeSelectorDelegate : System.Net.AuthenticationSchemeSelector with get, set

Public Property AuthenticationSchemeSelectorDelegate As AuthenticationSchemeSelector

Valor da propriedade

AuthenticationSchemeSelector

Um delegado AuthenticationSchemeSelector que invoca o método usado para selecionar um protocolo de autenticação. O valor padrão é null.

Exceções

ObjectDisposedException

Este objeto foi fechado.

Exemplos

O exemplo de código a seguir define o valor dessa propriedade.

// Set up a listener.
HttpListener listener = new HttpListener();
HttpListenerPrefixCollection prefixes = listener.Prefixes;
prefixes.Add(@"http://localhost:8080/");
prefixes.Add(@"http://contoso.com:8080/");

// Specify the authentication delegate.
listener.AuthenticationSchemeSelectorDelegate =
    new AuthenticationSchemeSelector (AuthenticationSchemeForClient);

// Start listening for requests and process them
// synchronously.
listener.Start();

' Set up a listener.
Dim listener As New HttpListener()
Dim prefixes As HttpListenerPrefixCollection = listener.Prefixes
prefixes.Add("http://localhost:8080/")
prefixes.Add("http://contoso.com:8080/")

' Specify the authentication delegate.
listener.AuthenticationSchemeSelectorDelegate = New AuthenticationSchemeSelector(AddressOf AuthenticationSchemeForClient)

' Start listening for requests and process them 
' synchronously.
listener.Start()

O exemplo de código a seguir fornece uma implementação de um método invocado por um AuthenticationSchemeSelector delegado.

static AuthenticationSchemes AuthenticationSchemeForClient(HttpListenerRequest request)
{
    Console.WriteLine("Client authentication protocol selection in progress...");
    // Do not authenticate local machine requests.
    if (request.RemoteEndPoint.Address.Equals (IPAddress.Loopback))
    {
        return AuthenticationSchemes.None;
    }
    else
    {
        return AuthenticationSchemes.IntegratedWindowsAuthentication;
    }
}

Private Shared Function AuthenticationSchemeForClient(ByVal request As HttpListenerRequest) As AuthenticationSchemes
    Console.WriteLine("Client authentication protocol selection in progress...")
    ' Do not authenticate local machine requests.
    If request.RemoteEndPoint.Address.Equals(IPAddress.Loopback) Then
        Return AuthenticationSchemes.None
    Else
        Return AuthenticationSchemes.IntegratedWindowsAuthentication
    End If
End Function

Comentários

Observação

Se você quiser que o mesmo protocolo de autenticação seja usado para todas as solicitações manipuladas por uma instância específica do HttpListener, não será necessário definir essa propriedade. Para especificar um protocolo a ser usado para todas as solicitações de cliente, use a AuthenticationSchemes propriedade .

Se o cliente não tiver especificado informações de autenticação em seus cabeçalhos, o HttpListener chamará o delegado especificado para cada solicitação de entrada não autenticada para determinar qual protocolo, se houver, usar para autenticar o cliente. Os GetContext métodos e EndGetContext retornam uma solicitação de entrada somente se o HttpListener tiver autenticado com êxito a solicitação. Se uma solicitação não puder ser autenticada, o HttpListener enviará automaticamente uma resposta 401. Você pode obter a identidade de um cliente autenticado com êxito usando a HttpRequest.LogonUserIdentity propriedade .

A capacidade de delegar a escolha do protocolo de autenticação a um método específico do aplicativo é útil se você quiser que uma instância do use protocolos de HttpListener autenticação diferentes, dependendo das características das solicitações recebidas (por exemplo, a propriedade ou UserHostAddress da Url solicitação).

Observação

Para definir essa propriedade para habilitar Digest, NTLM ou Negotiate requer o SecurityPermission, ControlPrincipal.