ICredentialPolicy Rozhraní

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Requests.dll

Zdroj:

ICredentialPolicy.cs

Definuje zásadu přihlašovacích údajů, která se má použít pro požadavky na prostředky, které se provádějí pomocí WebRequest , a jeho odvozené třídy.

public interface class ICredentialPolicy

public interface ICredentialPolicy

type ICredentialPolicy = interface

Public Interface ICredentialPolicy

Odvozené

Microsoft.Win32.IntranetZoneCredentialPolicy

Příklady

Následující příklad kódu ukazuje implementaci tohoto rozhraní, která umožňuje odesílat přihlašovací údaje pouze pro požadavky, které cílí na konkrétní hostitele.

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

Poznámky

Zásady přihlašovacích údajů určují, jestli se mají při odesílání síťového prostředku odesílat WebRequest přihlašovací údaje, například obsah webové stránky. Pokud se odešlou přihlašovací údaje, servery, které vyžadují ověření klienta, se mohou po přijetí požadavku pokusit ověřit klienta místo odeslání odpovědi, která indikuje, že jsou požadovány přihlašovací údaje klienta. I když se tím ušetří doba odezvy na server, tento nárůst výkonu musí být vyvážen s rizikem zabezpečení, které je součástí odesílání přihlašovacích údajů přes síť. Pokud cílový server nevyžaduje ověření klienta, je nejlepší neposílat přihlašovací údaje.

Poznámka:

ICredentialPolicy zásady jsou vyvolány pouze v případě WebRequest , že nebo WebProxy ten, který je přidružen k požadavku, má přihlašovací údaje, které nejsou null. Nastavení této zásady nemá žádný vliv na požadavky, které nezadávají přihlašovací údaje.

AuthenticationManager.CredentialPolicy Pomocí vlastnosti nastavte zásaduICredentialPolicy. Metoda IAuthenticationModule , která zpracovává ověřování pro požadavek, vyvolá metodu ShouldSendCredential před provedením ověřování. Pokud metoda vrátí false, ověřování se neprovádí.

Zásada ICredentialPolicy má vliv na všechny instance s přihlašovacími údaji WebRequest , které nemají hodnotu null v aktuální doméně aplikace. Zásady nelze přepsat u jednotlivých požadavků.

Metody

Name	Description
ShouldSendCredential(Uri, WebRequest, NetworkCredential, IAuthenticationModule)	Boolean Vrátí hodnotu označující, jestli jsou přihlašovací údaje klienta odeslány s požadavkem na prostředek vytvořeným pomocí instance WebRequest třídy.