SecurityBindingElement.CreateMutualCertificateBindingElement Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Crée un élément de liaison de sécurité asymétrique qui est configuré pour requérir l'authentification du client et du serveur par certificat.

Surcharges

CreateMutualCertificateBindingElement()	Crée un élément de liaison de sécurité asymétrique qui est configuré pour requérir l'authentification du client et du serveur par certificat.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Crée un élément de liaison de sécurité asymétrique qui est configuré pour requérir l'authentification du client et du serveur par certificat.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Crée un élément de liaison de sécurité asymétrique qui est configuré pour requérir l'authentification du client et du serveur par certificat.

Remarques

Le client doit être configuré avec son certificat ainsi qu'avec le certificat du serveur. Le serveur doit être configuré avec son certificat.

CreateMutualCertificateBindingElement()

Crée un élément de liaison de sécurité asymétrique qui est configuré pour requérir l'authentification du client et du serveur par certificat.

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

Retours

SecurityBindingElement

Objet SecurityBindingElement.

Exemples

L'exemple de code suivant montre comment appeler cette méthode.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

Remarques

La liaison est configurée afin qu'une nouvelle clé symétrique aléatoire (chiffrée pour le serveur) soit générée pour chaque demande du client et soit utilisée pour protéger aussi bien la demande que la réponse du serveur. Le certificat du client est utilisé comme un jeton de prise en charge d'approbation sur la demande.

Un AsymmetricSecurityBindingElement est en fait créé.

CreateMutualCertificateBindingElement(MessageSecurityVersion)

Crée un élément de liaison de sécurité asymétrique qui est configuré pour requérir l'authentification du client et du serveur par certificat.

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

Paramètres

version

MessageSecurityVersion

Version de sécurité du message.

Retours

SecurityBindingElement

Objet SecurityBindingElement.

Exceptions

ArgumentNullException

version a la valeur null.

Remarques

Si la version est WSSecurity10, l’élément de liaison est alors configuré de sorte que la demande du client soit signée par son certificat et chiffrée avec le certificat du serveur.

Si la version est WSSecurity11, l'élément de liaison est alors configuré de sorte qu'une nouvelle clé symétrique aléatoire (chiffrée pour le serveur) soit générée pour chaque demande du client et soit utilisée pour protéger aussi bien la demande que la réponse du serveur. Le certificat du client est utilisé comme un jeton de prise en charge d'approbation sur la demande.

Notes

Une fois qu'un objet SecurityBindingElement est créé en appelant cette méthode, la propriété MessageSecurityVersion est immuable. Appeler dessus set ne la modifie pas.

CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)

Crée un élément de liaison de sécurité asymétrique qui est configuré pour requérir l'authentification du client et du serveur par certificat.

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

Paramètres

version

MessageSecurityVersion

Version de sécurité du message.

allowSerializedSigningTokenOnReply

Boolean

true pour autoriser un jeton de signature sérialisé dans la réponse ; sinon false.

Retours

SecurityBindingElement

Objet SecurityBindingElement.

Exceptions

ArgumentNullException

version a la valeur null.

Remarques

Le paramètre allowSerializedSigningTokenOnReply, lorsqu'il a la valeur true, active l'interopérabilité avec les versions antérieures de WSE (Web Services Enhancements).

Notes

Une fois qu'un objet SecurityBindingElement est créé en appelant cette méthode, la propriété MessageSecurityVersion doit être traitée comme étant immuable. Un comportement incohérent de la liaison peut se produire si cette valeur est modifiée.