ICredentialPolicy Interface

Definitie

public interface class ICredentialPolicy

public interface ICredentialPolicy

type ICredentialPolicy = interface

Public Interface ICredentialPolicy

Afgeleid

Microsoft.Win32.IntranetZoneCredentialPolicy

Voorbeelden

In het volgende codevoorbeeld ziet u een implementatie van deze interface waarmee referenties alleen kunnen worden verzonden voor aanvragen die gericht zijn op specifieke hosts.

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;
    }
}

Opmerkingen

Het referentiebeleid bepaalt of referenties moeten worden verzonden bij het verzenden van een WebRequest voor een netwerkresource, zoals de inhoud van een webpagina. Als referenties worden verzonden, kunnen servers die clientverificatie vereisen, proberen om de client te verifiëren wanneer de aanvraag wordt ontvangen in plaats van een antwoord te verzenden dat aangeeft dat de referenties van de client vereist zijn. Hoewel hiermee een retour naar de server wordt opgeslagen, moet deze prestatiewinst worden verdeeld tegen het beveiligingsrisico dat inherent is aan het verzenden van referenties in het netwerk. Wanneer voor de doelserver geen clientverificatie is vereist, kunt u het beste geen referenties verzenden.

Gebruik de AuthenticationManager.CredentialPolicy eigenschap om een ICredentialPolicy beleid in te stellen. De IAuthenticationModule methode die verificatie voor de aanvraag afhandelt, roept de ShouldSendCredential methode aan voordat de verificatie wordt uitgevoerd. Als de methode retourneert false, wordt verificatie niet uitgevoerd.

Een ICredentialPolicy beleid is van invloed op alle exemplaren met WebRequest niet-null-referenties in het huidige toepassingsdomein. Het beleid kan niet worden overschreven voor afzonderlijke aanvragen.