SecurityBindingElement.CreateMutualCertificateBindingElement メソッド

定義

名前空間:

System.ServiceModel.Channels

アセンブリ:

System.ServiceModel.dll

非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。

オーバーロード

CreateMutualCertificateBindingElement()	非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。
CreateMutualCertificateBindingElement(MessageSecurityVersion)	非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。

注釈

クライアントには、クライアント自身の証明書と共にサーバーの証明書も構成する必要があります。 サーバーには、サーバー自身の証明書を構成する必要があります。

CreateMutualCertificateBindingElement()

非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement();

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement ();

static member CreateMutualCertificateBindingElement : unit -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement () As SecurityBindingElement

戻り値

SecurityBindingElement

SecurityBindingElement オブジェクト。

例

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

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

注釈

バインドは、要求ごとにクライアントが新しいランダムな対称キー (サーバー用に暗号化される) を生成し、それを使用して要求だけでなくサーバーからの応答も保護するように構成されます。 クライアントの証明書は、要求での保証サポート トークンとして使用されます。

実際には、AsymmetricSecurityBindingElement が作成されます。

CreateMutualCertificateBindingElement(MessageSecurityVersion)

非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version);

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version);

static member CreateMutualCertificateBindingElement : System.ServiceModel.MessageSecurityVersion -> System.ServiceModel.Channels.SecurityBindingElement

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion) As SecurityBindingElement

パラメーター

version

MessageSecurityVersion

メッセージ セキュリティ バージョン。

戻り値

SecurityBindingElement

SecurityBindingElement オブジェクト。

例外

ArgumentNullException

version が nullです。

注釈

バージョンが WSSecurity10 の場合は、バインド要素は、クライアント要求がクライアントの証明書によって署名され、サーバーの証明書で暗号化されるように構成されます。

バージョンが WSSecurity11 の場合は、要求ごとにクライアントが新しいランダムな対称キー (サーバー用に暗号化される) を生成し、それを使用して要求だけでなく、サーバーからの応答も保護するように、バインド要素が構成されます。 クライアントの証明書は、要求での保証サポート トークンとして使用されます。

注意

このメソッドを呼び出すことで SecurityBindingElement オブジェクトが作成されたら、MessageSecurityVersion プロパティは変更できません。 プロパティで set を呼び出しても変更されません。

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

非対称セキュリティ バインディング要素を作成し、証明書ベースのクライアント認証と、証明書ベースのサーバー認証を必要とするように構成します。

public:
 static System::ServiceModel::Channels::SecurityBindingElement ^ CreateMutualCertificateBindingElement(System::ServiceModel::MessageSecurityVersion ^ version, bool allowSerializedSigningTokenOnReply);

public static System.ServiceModel.Channels.SecurityBindingElement CreateMutualCertificateBindingElement (System.ServiceModel.MessageSecurityVersion version, bool allowSerializedSigningTokenOnReply);

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

Public Shared Function CreateMutualCertificateBindingElement (version As MessageSecurityVersion, allowSerializedSigningTokenOnReply As Boolean) As SecurityBindingElement

パラメーター

version

MessageSecurityVersion

メッセージ セキュリティ バージョン。

allowSerializedSigningTokenOnReply

Boolean

応答でシリアル化された署名トークンを使用できるか場合は true。それ以外の場合は false。

戻り値

SecurityBindingElement

SecurityBindingElement オブジェクト。

例外

ArgumentNullException

version が nullです。

注釈

allowSerializedSigningTokenOnReply パラメーターが true の場合は、古いバージョンの Web サービス拡張 (WSE) との相互運用性が有効になります。

注意

このメソッドを呼び出すことで SecurityBindingElement オブジェクトが作成されたら、MessageSecurityVersion プロパティを変更不可として扱う必要があります。 この値が変更されると、矛盾するバインド動作が発生する可能性があります。