ICredentialPolicy Arabirim

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Requests.dll

Kaynak:

ICredentialPolicy.cs

ve türetilmiş sınıfları kullanılarak WebRequest yapılan kaynak istekleri için kullanılacak kimlik bilgisi ilkesini tanımlar.

public interface class ICredentialPolicy

public interface ICredentialPolicy

type ICredentialPolicy = interface

Public Interface ICredentialPolicy

Türetilmiş

Microsoft.Win32.IntranetZoneCredentialPolicy

Örnekler

Aşağıdaki kod örneği, bu arabirimin yalnızca belirli konakları hedefleyen istekler için kimlik bilgilerinin gönderilmesine izin veren bir uygulamasını gösterir.

public class SelectedHostsCredentialPolicy: ICredentialPolicy
{
    public SelectedHostsCredentialPolicy()
    {
    }

    public virtual bool ShouldSendCredential(Uri challengeUri,
        WebRequest request,
        NetworkCredential credential,
        IAuthenticationModule authModule)
    {
        Console.WriteLine("Checking custom credential policy.");
        if (request.RequestUri.Host == "www.contoso.com" ||
            challengeUri.IsLoopback)
            return true;

        return false;
    }
}

Açıklamalar

Kimlik bilgisi ilkesi, web sayfasının içeriği gibi bir WebRequest ağ kaynağı için gönderirken kimlik bilgilerinin gönderilip gönderilmeyeceğini belirler. Kimlik bilgileri gönderilirse, istemci kimlik doğrulaması gerektiren sunucular, istemcinin kimlik bilgilerinin gerekli olduğunu belirten bir yanıt göndermek yerine istek alındığında istemcinin kimliğini doğrulamayı deneyebilir. Bu, sunucuya gidiş dönüş kaydetmesine karşın, bu performans kazancının ağ üzerinden kimlik bilgileri göndermenin doğası gereği güvenlik riskine karşı dengelenmiş olması gerekir. Hedef sunucu istemci kimlik doğrulaması gerektirmediğinde, kimlik bilgilerini göndermemek en iyisidir.

Uyarı

ICredentialPolicyilkeler yalnızca istekle ilişkili veya WebRequest kimlik bilgilerine WebProxysahip değilse null çağrılır. Bu ilkenin ayarlanması, kimlik bilgilerini belirtmeyen istekler üzerinde hiçbir etkiye sahip değildir.

AuthenticationManager.CredentialPolicy bir ilke ayarlamak ICredentialPolicy için özelliğini kullanın. IAuthenticationModule İstek için kimlik doğrulamasını işleyen, kimlik doğrulamasını ShouldSendCredential gerçekleştirmeden önce yöntemini çağırır. yöntemi döndürürse false, kimlik doğrulaması gerçekleştirilmez.

İlke ICredentialPolicy , geçerli uygulama etki alanındaki null olmayan kimlik bilgileriyle tüm örneklerini WebRequest etkiler. tek tek isteklerde ilke geçersiz kılınamaz.

Yöntemler

Name	Description
ShouldSendCredential(Uri, WebRequest, NetworkCredential, IAuthenticationModule)	Boolean İstemcinin kimlik bilgilerinin sınıfının bir örneği WebRequest kullanılarak yapılan bir kaynak isteğiyle gönderilip gönderilmediğini gösteren bir döndürür.