HttpWebRequest.PreAuthenticate Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtient ou définit une valeur indiquant si un en-tête d'autorisation doit être envoyé avec la requête.

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

Valeur de propriété

Boolean

true pour envoyer un en-tête d’autorisation HTTP avec des demandes après l’authentification. sinon, false. La valeur par défaut est false.

Remarques

Une fois qu’une demande cliente auprès d’un client spécifique Uri est correctement authentifiée, si PreAuthenticate true elle est fournie et que les informations d’identification sont fournies, l’en-tête d’autorisation est envoyé avec Uri chaque requête correspondant à la dernière barre oblique spécifique Uri . Par conséquent, si la demande cliente s’est authentifiée avec succès auprès d’un élément spécifique Uri qui contient les éléments suivants :

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

Ensuite, l’en-tête d’autorisation pour la pré-authentification est envoyé avec chaque requête à l’une des instances suivantes 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

Toutefois, l’en-tête d’autorisation n’est pas envoyé avec des requêtes à l’une des instances suivantes Uri :

http://www.contoso.com/

http://www.contoso.com/firstpath

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

Si la demande cliente à une requête spécifique Uri n’est pas authentifiée avec succès, la demande utilise des procédures d’authentification standard.

À l’exception de la première demande, la PreAuthenticate propriété indique s’il faut envoyer des informations d’authentification avec des demandes ultérieures à un Uri qui correspond à la barre oblique spécifique Uri jusqu’à la dernière barre oblique sans attendre d’être contestée par le serveur.

La boîte de dialogue suivante entre le client et le serveur illustre l’effet de cette propriété. La boîte de dialogue suppose que l’authentification de base est utilisée.

PreAuthenticate est false:

Client : GET someUrl

Serveur : 401 WWW-Authenticate De base

Client : GET avec en-têtes d’autorisation

Serveur : 200 OK

Client : GET someUrl

Serveur : 401 WWW-Authenticate De base

Client : GET avec en-têtes d’autorisation

Serveur : 200 OK

PreAuthenticate est true:

Client : GET someUrl

Serveur : 401 WWW-Authenticate De base

Client : GET avec en-têtes d’autorisation

Serveur : 200 OK

Client : GET someUrl avec en-têtes d’autorisation

Si le schéma d’authentification ne prend pas en charge la préauthentication, la valeur de cette propriété est ignorée.