HttpWebRequest.PreAuthenticate Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de