SecurityBindingElement クラス

定義

名前空間:

System.ServiceModel.Channels

アセンブリ:

System.ServiceModel.Primitives.dll

パッケージ:

System.ServiceModel.Primitives v6.2.0

Source:

SecurityBindingElement.cs

実装されると、チャネルの 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

継承

Object

BindingElement

SecurityBindingElement

派生

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

注釈

このクラスは、WCF の SOAP メッセージ セキュリティ バインド要素の基底クラスです。 この抽象クラスには、SymmetricSecurityBindingElement、AsymmetricSecurityBindingElement、および TransportSecurityBindingElement という 3 種類の実装があります。 これらの実装は、WS-Security Policy 仕様で定義されているバインドをモデル化しています。

カスタム バインドには、特定の順序で配置されたバインド要素のコレクションが含まれます。バインド スタックの一番上を表す要素が最初に追加され、バインド スタックの 1 つ下の要素が 2 番目に追加される、という順序で配置されます。

このクラスをバインドに追加するには、次を実行します。

1. BindingElementCollection を作成します。

2. オプションの TransactionFlowBindingElement や ReliableSessionBindingElement など、バインド スタックでこのバインド要素の上になるカスタム バインド要素を作成します。

3. BindingElementCollection メソッドを使用して、これらの要素を前に説明した順序で InsertItem に追加します。

4. SecurityBindingElement、AsymmetricSecurityBindingElement、SymmetricSecurityBindingElement など、TransportSecurityBindingElement から派生するセキュリティ バインド要素のインスタンスを作成します。

5. 派生したセキュリティ バインドをコレクションに追加します。

6. TcpTransportBindingElement など、追加のカスタム バインド要素があればコレクションに追加します。

の使用 SecurityBindingElementの詳細については、「 SecurityBindingElement 認証モード 」および「 方法: SecurityBindingElement を使用してカスタム バインドを作成する」を参照してください。

注意

SecurityBindingElement オブジェクトが一度作成されると、そのプロパティを変更不可として扱う必要があります。 一部のプロパティで set を呼び出すと、予期しない結果になることがあります。プロパティに古い値が保持されているようにバインディングが動作し、この問題が発生したことを示すのが、ランタイム エラーのみとなる場合があります。 このように動作することがわかっているプロパティは KeyType と MessageSecurityVersion の 2 つです。 他にも同じように動作するプロパティが存在する可能性があります。

プロパティ

DefaultAlgorithmSuite	メッセージの暗号化とキー ラップ アルゴリズムを取得または設定します。
EnableUnsecuredResponse	WCF がセキュリティで保護された要求に対するセキュリティで保護されていない応答を送受信できるかどうかを示す値を取得または設定します。
EndpointSupportingTokenParameters	トークン パラメーターをサポートするエンドポイントを取得します。
IncludeTimestamp	各メッセージにタイム スタンプが含まれるかどうかを示す値を取得または設定します。
KeyEntropyMode	キーの作成に使用されるエントロピのソースを取得または設定します。
LocalClientSettings	クライアントが使用するローカル セキュリティ設定に固有のバインド プロパティを取得します。
MessageSecurityVersion	メッセージ セキュリティのバージョンを取得または設定します。
OperationSupportingTokenParameters	トークン パラメーターをサポートする操作のコレクションを取得します。
OptionalEndpointSupportingTokenParameters	サービス エンドポイントに対するオプションのサポート トークン パラメーターを取得します。
OptionalOperationSupportingTokenParameters	トークン パラメーターをサポートするオプション操作のコレクションを取得します。
SecurityHeaderLayout	このバインドのセキュリティ ヘッダー内の要素の順序を取得または設定します。

メソッド

BuildChannelFactory<TChannel>(BindingContext)	指定する SecurityBindingElement の設定とバインド コンテキストに基づいて、チャネル ファクトリを作成します。 作成されるチャネル ファクトリは SOAP メッセージ セキュリティ チャネル ファクトリで、内部的にバインディング コンテキスト (トランスポート チャネル ファクトリを格納する) に対応するチャネル ファクトリへの参照を保持します。
BuildChannelFactoryCore<TChannel>(BindingContext)	実装されると、指定した種類のチャネル ファクトリを作成します。
BuildChannelListener<TChannel>(BindingContext)	指定した種類のチャネルを受け入れるよう、バインディング コンテキストからチャネル リスナーを初期化します。 (継承元 BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	指定した種類のチャネル ファクトリを作成できるかどうかを判断します。
CanBuildChannelListener<TChannel>(BindingContext)	指定した種類のチャネルに対するリスナーをバインド要素が作成できるかどうかを示す値を返します。 (継承元 BindingElement)
Clone()	派生クラスでオーバーライドされると、バインド要素オブジェクトのコピーを返します。 (継承元 BindingElement)
CreateCertificateOverTransportBindingElement()	SOAP メッセージ セキュリティを使用する証明書ベースの認証をクライアントが行うものと想定する、セキュリティ バインド要素を作成します。
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	SOAP メッセージ セキュリティを使用する証明書ベースの認証をクライアントが行うものと想定する、セキュリティ バインド要素を作成します。
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	セキュリティ バインド要素を作成し、発行されたトークンを使用する SOAP セキュリティ ベースのクライアント認証を必要とするように構成します。 このバインド要素では、トランスポートはサーバー認証だけでなく、メッセージ保護 (たとえば HTTPS) も提供する必要があります。
CreateMutualCertificateBindingElement()	非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。
CreateMutualCertificateBindingElement(MessageSecurityVersion)	非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。
CreateSecureConversationBindingElement(SecurityBindingElement)	対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。 ブートストラップ セキュリティ バインディング要素は、セキュリティで保護された通信のハンドシェイク メッセージをセキュリティで保護する方法を指定します。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。 ブートストラップ セキュリティ バインディング要素は、セキュリティで保護された通信のハンドシェイク メッセージをセキュリティで保護する方法を指定します。
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()	このクラスの説明を返します。

こちらもご覧ください

• SecurityBindingElement 認証モード
• 方法: SecurityBindingElement を使用してカスタム バインドを作成する