AuthenticationManager.CredentialPolicy Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Source:

AuthenticationManager.cs

Obtient ou définit la stratégie d’informations d’identification à utiliser pour les demandes de ressources effectuées à l’aide de la classe HttpWebRequest.

public:
 static property System::Net::ICredentialPolicy ^ CredentialPolicy { System::Net::ICredentialPolicy ^ get(); void set(System::Net::ICredentialPolicy ^ value); };

public static System.Net.ICredentialPolicy? CredentialPolicy { get; set; }

static member CredentialPolicy : System.Net.ICredentialPolicy with get, set

Public Shared Property CredentialPolicy As ICredentialPolicy

Valeur de propriété

ICredentialPolicy

Objet qui implémente l'interface ICredentialPolicy déterminant si des informations d'identification sont envoyées avec les demandes. La valeur par défaut est null.

Exemples

L’exemple de code suivant illustre la définition de la stratégie d’informations d’identification.

static void UseIntranetCredentialPolicy()
{
   IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
   AuthenticationManager::CredentialPolicy = policy;
}

 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

Remarques

La stratégie d’informations d’identification détermine s’il faut envoyer des informations d’identification lors de l’envoi d’une demande pour une ressource réseau, telle que le contenu d’une page web. Si des informations d’identification sont envoyées, les serveurs qui nécessitent l’authentification du client peuvent tenter d’authentifier le client à la réception de la demande au lieu d’envoyer une réponse indiquant que les informations d’identification du client sont requises. Bien que cela enregistre un aller-retour sur le serveur, cela doit être équilibré avec le risque de sécurité inhérent à l’envoi d’informations d’identification sur le réseau. Lorsque le serveur de destination ne nécessite pas d’authentification client, il est préférable de ne pas envoyer d’informations d’identification.

La stratégie d’informations d’identification sera appelée uniquement pour les demandes qui spécifient des informations d’identification ou qui utilisent un WebProxy objet qui spécifie les informations d’identification.