AuthenticationManager.CredentialPolicy 屬性

定義

取得或設定用於資源要求 (使用 HttpWebRequest 類別所提出) 的認證原則。

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

屬性值

實作 ICredentialPolicy 介面的物件,判斷認證是否與要求一起傳送。 預設值是 null

範例

下列程式代碼範例示範如何設定認證原則。

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

備註

認證原則會決定是否要在傳送網路資源的要求時傳送認證,例如網頁的內容。 如果傳送認證,要求客戶端驗證的伺服器可以在收到要求時嘗試驗證用戶端,而不是傳送回應,指出需要客戶端的認證。 雖然這可節省伺服器的來回行程,但這必須與透過網路傳送認證時固有的安全性風險進行平衡。 當目的地伺服器不需要客戶端驗證時,最好不要傳送認證。

認證原則只會針對指定認證的要求呼叫,或使用 WebProxy 指定認證的物件。

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1