HttpWebRequest.PreAuthenticate Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblados:

netstandard.dll, System.Net.Requests.dll

Source:

HttpWebRequest.cs

Obtiene o establece un valor que indica si se va a enviar un encabezado authorization con la solicitud.

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 de propiedad

Boolean

true para enviar un encabezado de autorización HTTP con solicitudes después de que se haya realizado la autenticación; de lo contrario, false. El valor predeterminado es false.

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

Después de autenticar correctamente una solicitud de cliente a un específico Uri , si PreAuthenticate es true y se proporcionan credenciales, el encabezado Authorization se envía con cada solicitud a cualquiera Uri que coincida con el específico Uri hasta la última barra diagonal. Por lo tanto, si la solicitud de cliente se ha autenticado correctamente en un elemento específico Uri que contiene lo siguiente:

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

A continuación, el encabezado autorización para la autenticación previa se envía con cada solicitud a cualquiera de las instancias siguientes Uri :

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

Sin embargo, el encabezado Authorization no se envía con solicitudes a ninguna de las siguientes Uri instancias:

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

Si la solicitud de cliente a un específico Uri no se autentica correctamente, la solicitud usa procedimientos de autenticación estándar.

Con la excepción de la primera solicitud, la PreAuthenticate propiedad indica si se va a enviar información de autenticación con solicitudes posteriores a un Uri que coincide con la barra diagonal específica Uri hasta la última barra diagonal sin esperar a que el servidor pueda impugnar.

En el cuadro de diálogo siguiente entre el cliente y el servidor se muestra el efecto de esta propiedad. En el cuadro de diálogo se supone que la autenticación básica está en uso.

PreAuthenticate es false:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET con encabezados de autorización

Servidor: 200 Correcto

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET con encabezados de autorización

Servidor: 200 Correcto

PreAuthenticate es true:

Cliente: GET someUrl

Servidor: 401 WWW-Authenticate Básico

Cliente: GET con encabezados de autorización

Servidor: 200 Correcto

Cliente: GET someUrl con encabezados de autorización

Si el esquema de autenticación no admite la autenticación previa, se omite el valor de esta propiedad.