AuthenticationManager.CredentialPolicy 屬性
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定用於資源要求 (使用 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; }
public static System.Net.ICredentialPolicy CredentialPolicy { get; set; }
static member CredentialPolicy : System.Net.ICredentialPolicy with get, set
Public Shared Property CredentialPolicy As ICredentialPolicy
實作 ICredentialPolicy 介面的物件,判斷認證是否與要求一起傳送。 預設值是 null
。
下列程式代碼範例示範如何設定認證原則。
static void UseIntranetCredentialPolicy()
{
IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
AuthenticationManager::CredentialPolicy = policy;
}
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 |