SecurityBindingElement.CreateSecureConversationBindingElement メソッド

定義

名前空間:

System.ServiceModel.Channels

アセンブリ:

System.ServiceModel.Primitives.dll

パッケージ:

System.ServiceModel.Primitives v6.2.0

対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。

オーバーロード

CreateSecureConversationBindingElement(SecurityBindingElement)	対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。 ブートストラップ セキュリティ バインディング要素は、セキュリティで保護された通信のハンドシェイク メッセージをセキュリティで保護する方法を指定します。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。 ブートストラップ セキュリティ バインディング要素は、セキュリティで保護された通信のハンドシェイク メッセージをセキュリティで保護する方法を指定します。

CreateSecureConversationBindingElement(SecurityBindingElement)

Source:

SecurityBindingElement.cs

対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。 ブートストラップ セキュリティ バインディング要素は、セキュリティで保護された通信のハンドシェイク メッセージをセキュリティで保護する方法を指定します。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement) As SecurityBindingElement

パラメーター

bootstrapSecurity

SecurityBindingElement

セキュリティで保護されたメッセージ交換ハンドシェイク メッセージの保護方法の仕様を含む SecurityBindingElement。

戻り値

SecurityBindingElement

SecurityBindingElement オブジェクト。

例外

ArgumentNullException

bootstrapSecurity が nullです。

注釈

バインド要素は、セッション ベースのセキュリティ コンテキスト トークンを使用するように構成されます。

サービスからセキュリティで保護された通信のトークンを要求するために使用されるセキュリティ バインドおよびポリシーを示すには、bootstrapSecurity が使用されます。

bootstrapSecurity が TransportSecurityBindingElement の場合は、このメソッドによって返されるバインド要素も同じになります。また、IncludeTimestamp は、true に設定されます。LocalClientSecuritySettings から返される LocalClientSettings オブジェクトでは、DetectReplays プロパティが false に設定されています。LocalServiceSecuritySettings から返される LocalServiceSettings オブジェクトでは、DetectReplays プロパティが false に設定されています。

それ以外の場合は、SymmetricSecurityBindingElement が RequireSignatureConfirmation に設定された false が返されます。

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Source:

SecurityBindingElement.cs

対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean) As SecurityBindingElement

パラメーター

bootstrapSecurity

SecurityBindingElement

セキュリティで保護されたメッセージ交換ハンドシェイク メッセージの保護方法の仕様を含む SecurityBindingElement。

requireCancellation

Boolean

キャンセルが必要な場合は true、それ以外の場合は false。 このパラメーターを false に設定すると、セキュリティ コンテキスト トークンが有効になります。このモードでは、セッション状態は、サーバーのメモリに保持されるのではなく、確立されるセキュリティ コンテキスト トークンの内部にエンコードされるため、このトークンは Web ファームのシナリオに役に立ちます。

戻り値

SecurityBindingElement

SecurityBindingElement オブジェクト。

例外

ArgumentNullException

bootstrapSecurity が nullです。

例

このメソッドを呼び出す方法を次のコードに示します。

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

// Use a secure session.
security = SecurityBindingElement.CreateSecureConversationBindingElement(security, true);

注釈

requireCancellation が false の場合は、クッキー ベースのセキュリティ コンテキスト トークンが発行されます。それ以外の場合は、セッション ベースのセキュリティ コンテキスト トークンが発行されます。

サービスから bootstrapSecurity を要求するために使用されるセキュリティ バインディングおよびポリシーを示すには、SecureConversationToken が使用されます。

bootstrapSecurity が TransportSecurityBindingElement の場合は、このメソッドによって返されるバインディング要素も TransportSecurityBindingElement になります。また、IncludeTimestamp は、true に設定されます。LocalClientSecuritySettings から返される LocalClientSettings オブジェクトでは、DetectReplays プロパティが false に設定されています。LocalServiceSecuritySettings から返される LocalServiceSettings オブジェクトでは、DetectReplays プロパティが false に設定されています。

それ以外の場合は、SymmetricSecurityBindingElement が RequireSignatureConfirmation に設定された false が返されます。

注意

Windows XP で偽装が必要な場合は、セキュリティ コンテキスト トークンなしでセキュリティで保護されたセッションを使用します。 偽装時にセキュリティ コンテキスト トークンを使用すると、InvalidOperationException がスローされます。 詳細については、「サポートされていないシナリオ」を参照してください。 セキュリティで保護されたセッションの詳細については、「 セキュリティで保護されたセッション」を参照してください。

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Source:

SecurityBindingElement.cs

対称セキュリティ バインド要素を作成し、クライアントとサービスの間にセキュリティで保護された通信を確立するように構成します。 セキュリティで保護された通信のハンドシェイクの最後に発行されるセキュリティ コンテキスト トークンを使用して、メッセージをセキュリティで保護します。 ブートストラップ セキュリティ バインディング要素は、セキュリティで保護された通信のハンドシェイク メッセージをセキュリティで保護する方法を指定します。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateSecureConversationBindingElement(System::ServiceModel::Channels::SecurityBindingElement ^ bootstrapSecurity, bool requireCancellation, System::ServiceModel::Security::ChannelProtectionRequirements ^ bootstrapProtectionRequirements);

public static System.ServiceModel.Channels.SecurityBindingElement CreateSecureConversationBindingElement (System.ServiceModel.Channels.SecurityBindingElement bootstrapSecurity, bool requireCancellation, System.ServiceModel.Security.ChannelProtectionRequirements bootstrapProtectionRequirements);

static member CreateSecureConversationBindingElement : System.ServiceModel.Channels.SecurityBindingElement * bool * System.ServiceModel.Security.ChannelProtectionRequirements -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateSecureConversationBindingElement (bootstrapSecurity As SecurityBindingElement, requireCancellation As Boolean, bootstrapProtectionRequirements As ChannelProtectionRequirements) As SecurityBindingElement

パラメーター

bootstrapSecurity

SecurityBindingElement

セキュリティで保護されたメッセージ交換ハンドシェイク メッセージの保護方法の仕様を含む SecurityBindingElement。

requireCancellation

Boolean

キャンセルが必要な場合は true、それ以外の場合は false。 このパラメーターを false に設定すると、セキュリティ コンテキスト トークンが有効になります。このモードでは、セッション状態は、サーバーのメモリに保持されるのではなく、確立されるセキュリティ コンテキスト トークンの内部にエンコードされるため、このトークンは Web ファームのシナリオに役に立ちます。

bootstrapProtectionRequirements

ChannelProtectionRequirements

チャネル保護の要件を指定する ChannelProtectionRequirements オブジェクト。

戻り値

SecurityBindingElement

SecurityBindingElement オブジェクト。

例外

ArgumentNullException

bootstrapSecurity が nullです。

注釈

bootstrapProtectionRequirements パラメーターを使用すると、セキュリティで保護された通信のハンドシェイクの一部として交換されるメッセージをセキュリティで保護する方法をカスタマイズできます。

サービスからセキュリティで保護された通信のトークンを要求するために使用されるセキュリティ バインドおよびポリシーを示すには、bootstrapSecurity が使用されます。

bootstrapSecurity が TransportSecurityBindingElement の場合は、このメソッドによって返されるバインディング要素も TransportSecurityBindingElement になります。また、IncludeTimestamp は、true に設定されます。LocalClientSecuritySettings から返される LocalClientSettings オブジェクトでは、DetectReplays プロパティが false に設定されています。LocalServiceSecuritySettings から返される LocalServiceSettings オブジェクトでは、DetectReplays プロパティが false に設定されています。

それ以外の場合は、SymmetricSecurityBindingElement が RequireSignatureConfirmation に設定された false が返されます。

注意

Windows XP で偽装が必要な場合は、セキュリティ コンテキスト トークンなしでセキュリティで保護されたセッションを使用します。 偽装時にセキュリティ コンテキスト トークンを使用すると、InvalidOperationException がスローされます。 詳細については、「サポートされていないシナリオ」を参照してください。 セキュリティで保護されたセッションの詳細については、「 セキュリティで保護されたセッション」を参照してください。