HttpWebRequest.PreAuthenticate Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

HttpWebRequest.cs

Obtém ou define um valor que indica se é necessário enviar um cabeçalho de autorização com a solicitação.

public:
 virtual property bool PreAuthenticate { bool get(); void set(bool value); };

public override bool PreAuthenticate { get; set; }

member this.PreAuthenticate : bool with get, set

Public Overrides Property PreAuthenticate As Boolean

Valor da propriedade

Boolean

true para enviar um cabeçalho de autorização HTTP com solicitações após a autenticação ter ocorrido; caso contrário, false. O padrão é false.

Comentários

Depois que uma solicitação de cliente para um específico Uri for autenticada com êxito, se PreAuthenticate for true e as credenciais forem fornecidas, o cabeçalho autorização será enviado com cada solicitação para qualquer Uri uma que corresponda ao específico Uri até a última barra de encaminhamento. Portanto, se a solicitação do cliente foi autenticada com êxito em um específico Uri que contém o seguinte:

http://www.contoso.com/firstpath/

Em seguida, o cabeçalho autorização para pré-autenticação é enviado com cada solicitação para qualquer uma das seguintes Uri instâncias:

http://www.contoso.com/firstpath/

http://www.contoso.com/firstpath/default

http://www.contoso.com/firstpath/default.html

http://www.contoso.com/firstpath/sample.html

No entanto, o cabeçalho autorização não é enviado com solicitações para nenhuma das seguintes Uri instâncias:

http://www.contoso.com/

http://www.contoso.com/firstpath

http://www.contoso.com/secondpath/

http://www.contoso.com/firstpath/thirdpath/

Se a solicitação do cliente para um específico Uri não for autenticada com êxito, a solicitação usará procedimentos de autenticação padrão.

Com exceção da primeira solicitação, a PreAuthenticate propriedade indica se as informações de autenticação devem ser enviadas com solicitações subsequentes para um Uri que corresponda ao específico Uri até a última barra de encaminhamento sem esperar para ser contestada pelo servidor.

A caixa de diálogo a seguir entre o cliente e o servidor ilustra o efeito dessa propriedade. A caixa de diálogo pressupõe que a autenticação básica esteja em uso.

PreAuthenticate é false:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET com cabeçalhos de autorização

Servidor: 200 OK

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET com cabeçalhos de autorização

Servidor: 200 OK

PreAuthenticate é true:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET com cabeçalhos de autorização

Servidor: 200 OK

Cliente: GET someUrl com cabeçalhos de autorização

Se o esquema de autenticação não der suporte à pré-autenticação, o valor dessa propriedade será ignorado.