AuthenticationManager.CredentialPolicy Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Source:

AuthenticationManager.cs

Obtiene o establece la directiva de credenciales que se utilizará para las solicitudes de recursos realizadas con la clase 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

Valor de propiedad

ICredentialPolicy

Un objeto que implementa la interfaz ICredentialPolicy que determina si se envían credenciales con las solicitudes. El valor predeterminado es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la directiva de credenciales.

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

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

Comentarios

La directiva de credenciales determina si se envían credenciales al enviar una solicitud de un recurso de red, como el contenido de una página web. Si se envían credenciales, los servidores que requieren autenticación de cliente pueden intentar autenticar al cliente cuando se recibe la solicitud en lugar de enviar una respuesta que indique que se requieren las credenciales del cliente. Aunque esto guarda un recorrido de ida y vuelta en el servidor, debe equilibrarse con el riesgo de seguridad inherente al envío de credenciales a través de la red. Cuando el servidor de destino no requiere autenticación de cliente, es mejor no enviar credenciales.

Solo se llamará a la directiva de credenciales para las solicitudes que especifiquen credenciales o usen un WebProxy objeto que especifique las credenciales.