共用方式為


SecurityBindingElement 類別

定義

抽象類別 (Abstract Class),其在實作時可表示支援通道 SOAP 訊息安全性的繫結項目。

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement
public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement
type SecurityBindingElement = class
    inherit BindingElement
Public MustInherit Class SecurityBindingElement
Inherits BindingElement
繼承
SecurityBindingElement
衍生

備註

這個類別是 WCF 中 SOAP 訊息安全性綁定項的基類。 這個抽象類別有三種實作:SymmetricSecurityBindingElementAsymmetricSecurityBindingElementTransportSecurityBindingElement。 這些實作會建立以 WS-Security Policy 規格定義之繫結的模型。

自訂繫結包含以特定順序排列的繫結項目之集合:第一個會新增代表繫結堆疊頂端的項目,第二個新增繫結堆疊中次一項目,依此類推。

若要將這個類別新增至繫結,請執行下列動作:

  1. 建立 BindingElementCollection

  2. 建立在繫結堆疊中位於此繫結項目上方的自訂繫結項目,例如選擇性的 TransactionFlowBindingElementReliableSessionBindingElement

  3. 依先前所述的順序,使用 BindingElementCollection 方法將這些項目新增至 InsertItem

  4. 建立自 SecurityBindingElement 衍生之安全性繫結項目的執行個體,例如 AsymmetricSecurityBindingElementSymmetricSecurityBindingElementTransportSecurityBindingElement

  5. 將衍生的安全性繫結項目新增至集合。

  6. 將其他任何自訂繫結項目新增至集合中,例如 TcpTransportBindingElement

如需使用 SecurityBindingElement的詳細資訊,請參閱 SecurityBindingElement 驗證模式如何:使用 SecurityBindingElement 建立自定義系結

注意

一旦建立 SecurityBindingElement 物件之後,您就應該將它的屬性視為不變的屬性。 在某些屬性上呼叫 set 可能會產生無法預測的結果:繫結的行為可能如同屬性保留舊的值一般,而且執行階段錯誤是發生問題的唯一徵兆。 已知可能出現這種行為的兩個屬性是 KeyTypeMessageSecurityVersion。 另外可能還有其他屬性也會出現同樣的狀況。

屬性

AllowInsecureTransport

取得或設定值,這個值表示是否可傳送混合模式的安全訊息至不安全的傳輸,例如 HTTP。

DefaultAlgorithmSuite

取得或設定訊息加密和金鑰包裝演算法。

EnableUnsecuredResponse

取得或設定值,這個值表示 WCF 是否可以接收及傳送不安全的回應至安全的要求。

EndpointSupportingTokenParameters

取得支援權杖參數的端點。

IncludeTimestamp

取得或設定值,指出時間戳記是否包含在各個訊息中。

KeyEntropyMode

取得或設定用於建立金鑰的 Entropy 來源。

LocalClientSettings

取得用戶端所使用本機安全性設定的特定繫結項目。

LocalServiceSettings

取得服務所使用本機安全性設定的特定繫結項目。

MessageSecurityVersion

取得或設定訊息安全性版本。

OperationSupportingTokenParameters

取得支援權杖參數之作業的集合。

OptionalEndpointSupportingTokenParameters

取得服務端點的選擇性支援權杖參數。

OptionalOperationSupportingTokenParameters

取得支援權杖參數之選擇性作業的集合。

ProtectTokens

取得或設定安全性繫結項目是否保護權杖。

SecurityHeaderLayout

取得或設定此繫結之安全性標頭中的項目順序。

方法

BuildChannelFactory<TChannel>(BindingContext)

根據傳入的 SecurityBindingElement 設定和繫結內容建立通道處理站。 所建立的通道處理站是 SOAP 訊息安全性通道處理站,其內部具有對應至繫結內容之通道處理站的參考 (包括傳輸通道處理站)。

BuildChannelFactoryCore<TChannel>(BindingContext)

當實作時會建立指定型別的通道處理站。

BuildChannelListener<TChannel>(BindingContext)

根據傳入的 SecurityBindingElement 設定和繫結內容建立通道接聽程式。

BuildChannelListener<TChannel>(BindingContext)

初始化通道接聽項,以便從繫結內容接受指定之類型的通道。

(繼承來源 BindingElement)
BuildChannelListenerCore<TChannel>(BindingContext)

當實作時會建立指定型別的通道接聽程式。

CanBuildChannelFactory<TChannel>(BindingContext)

判斷是否可以建置指定之型別的通道處理站。

CanBuildChannelListener<TChannel>(BindingContext)

判斷是否可以建置指定之型別的通道接聽項。

CanBuildChannelListener<TChannel>(BindingContext)

傳回值,指出繫結項目是否可以建置特定通道型別的通道接聽程式。

(繼承來源 BindingElement)
Clone()

在衍生類別中覆寫時,傳回繫結項目物件的複本。

(繼承來源 BindingElement)
CreateAnonymousForCertificateBindingElement()

建立對稱式安全性繫結項目,這個項目則設定為匿名用戶端驗證和憑證架構的伺服器驗證。

CreateCertificateOverTransportBindingElement()

建立安全性繫結項目,這個項目需要用戶端使用 SOAP 訊息安全性執行憑證架構的驗證。

CreateCertificateOverTransportBindingElement(MessageSecurityVersion)

建立安全性繫結項目,這個項目需要用戶端使用 SOAP 訊息安全性執行憑證架構的驗證。

CreateCertificateSignatureBindingElement()

建立要使用憑證簽署訊息的繫結項目。 這個繫結項目只能用於單向訊息交換,而且只能簽署訊息。

CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters)

建立對稱的安全性繫結項目,該項目已設定為需要使用以對稱金鑰為基礎發行之權杖的用戶端驗證。

CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters)

建立對稱式安全性繫結項目,這個項目則設定為需要根據發行的權杖進行用戶端驗證,並且需要根據伺服器憑證進行伺服器驗證。

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters)

建立對稱式安全性繫結項目,這個項目則設定為需要根據發行的權杖進行用戶端驗證,並且需要根據伺服器憑證進行伺服器驗證。

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean)

建立對稱式安全性繫結項目,這個項目則設定為需要根據發行的權杖進行用戶端驗證,並且需要根據伺服器憑證進行伺服器驗證。

CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)

建立安全性繫結項目,該項目已設定為需要使用發行之權杖的 SOAP 安全性用戶端驗證。 這個繫結項目需要傳輸提供伺服器驗證和訊息保護 (例如 HTTPS)。

CreateKerberosBindingElement()

建立對稱的安全性繫結項目,該項目已設定為需要以用戶端之 Kerberos 權杖為基礎的用戶端驗證。

CreateKerberosOverTransportBindingElement()

建立安全性繫結項目,該項目已設定為需要使用用戶端之 Kerberos 權杖的 SOAP 安全性用戶端驗證。 這個繫結項目需要傳輸提供伺服器驗證和訊息保護 (例如 HTTPS)。

CreateMutualCertificateBindingElement()

建立非對稱安全性繫結項目,這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

CreateMutualCertificateBindingElement(MessageSecurityVersion)

建立非對稱安全性繫結項目,這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

建立非對稱安全性繫結項目,這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。

CreateMutualCertificateDuplexBindingElement()

建立非對稱安全性繫結項目,這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。 這個驗證模式可以用來確保雙向訊息交換模式的安全性,並且需要透過範圍外的用戶端憑證來設定服務。

CreateMutualCertificateDuplexBindingElement(MessageSecurityVersion)

建立非對稱安全性繫結項目,這個項目則設定為需要進行憑證架構的用戶端驗證和伺服器驗證。 這個驗證模式可以用來確保雙向訊息交換模式的安全性,並且需要透過範圍外的用戶端憑證來設定服務。

CreateSecureConversationBindingElement(SecurityBindingElement)

建立對稱式安全性繫結項目,這個項目則設定為建立用戶端與服務之間的安全對話。 在安全對話交換結束時發出的安全性內容權杖是用來確保這些訊息的安全。 啟動安裝安全性繫結項目會指定如何保護安全對話交換訊息。

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

建立對稱式安全性繫結項目,這個項目則設定為建立用戶端與服務之間的安全對話。 在安全對話交換結束時發出的安全性內容權杖是用來確保這些訊息的安全。

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

建立對稱式安全性繫結項目,這個項目則設定為建立用戶端與服務之間的安全對話。 在安全對話交換結束時發出的安全性內容權杖是用來確保這些訊息的安全。 啟動安裝安全性繫結項目會指定如何保護安全對話交換訊息。

CreateSslNegotiationBindingElement(Boolean)

建立對稱式安全性繫結項目,這個項目則設定為執行用戶端與伺服器之間的 SOAP 層級的 SSL 交涉,同時指示是否需要用戶端憑證。

CreateSslNegotiationBindingElement(Boolean, Boolean)

建立對稱式安全性繫結項目,這個項目會執行 SOAP SSL 交涉,同時指示是否需要用戶端憑證和取消。

CreateSspiNegotiationBindingElement()

建立對稱式安全性繫結項目,這個項目會根據交涉式驗證封裝來執行 SOAP SSPI 交涉。

CreateSspiNegotiationBindingElement(Boolean)

建立對稱式安全性繫結項目,這個項目會根據交涉式驗證封裝來執行 SOAP SSPI 交涉。

CreateSspiNegotiationOverTransportBindingElement()

建立安全性繫結項目,這個項目則設定為使用交涉式驗證封裝,根據 SOAP SSPI 交涉來進行用戶端驗證。 這個繫結項目需要傳輸提供伺服器驗證和訊息保護 (例如 HTTPS)。

CreateSspiNegotiationOverTransportBindingElement(Boolean)

建立安全性繫結項目,這個項目則設定為使用交涉式驗證封裝,根據 SOAP SSPI 交涉來進行用戶端驗證。 這個繫結項目需要傳輸提供伺服器驗證和訊息保護 (例如 HTTPS)。

CreateUserNameForCertificateBindingElement()

建立對稱式安全性繫結項目,這個項目則設定為需要進行使用者名稱和密碼架構的用戶端驗證,並且進行憑證架構的伺服器驗證。 建立的繫結項目需要使用服務憑證來設定用戶端,該憑證在開啟與服務的通訊通道之前是超出範圍的。

CreateUserNameForSslBindingElement()

建立對稱式安全性繫結項目,這個項目則設定為需要進行使用者名稱和密碼架構的用戶端驗證,並且進行憑證架構的伺服器驗證。 用戶端會使用 SOAP 層級的 SSL 通訊協定來驗證伺服器。

CreateUserNameForSslBindingElement(Boolean)

建立對稱式安全性繫結項目,這個項目則設定為需要進行使用者名稱和密碼架構的用戶端驗證,並且進行憑證架構的伺服器驗證。 用戶端會使用 SOAP 層級的 SSL 通訊協定來驗證伺服器。

CreateUserNameOverTransportBindingElement()

建立安全性繫結項目,這個項目則設定為以 SOAP 訊息傳送之一部分的使用者名稱和密碼為基礎的用戶端驗證。 這個繫結項目需要傳輸提供伺服器驗證和訊息保護 (例如 HTTPS)。

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetProperty<T>(BindingContext)

取得使用指定之 BindingContext 的指定物件。

GetType()

取得目前執行個體的 Type

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)

設定權杖需求屬性的索引鍵,如果是有關已發行權杖的需求,其值便會是用來與發行方溝通的 BindingContext。

SetKeyDerivation(Boolean)

設定值,指出是否需要衍生金鑰。

ToString()

傳回這個類別的描述。

適用於

另請參閱