SecurityBindingElement.CreateSecureConversationBindingElement Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Security.dll

Assembly:

System.ServiceModel.dll

Crée un élément de liaison de sécurité symétrique configuré pour établir une conversation sécurisée entre le client et le service. Le jeton de contexte de sécurité émis à la fin du protocole de transfert de conversation sécurisé est utilisé pour sécuriser les messages.

Surcharges

CreateSecureConversationBindingElement(SecurityBindingElement)	Crée un élément de liaison de sécurité symétrique configuré pour établir une conversation sécurisée entre le client et le service. Le jeton de contexte de sécurité émis à la fin du protocole de transfert de conversation sécurisé est utilisé pour sécuriser les messages. L’élément de liaison de sécurité du démarrage indique comment les messages protocolaires de conversation sont sécurisés.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)	Crée un élément de liaison de sécurité symétrique configuré pour établir une conversation sécurisée entre le client et le service. Le jeton de contexte de sécurité émis à la fin du protocole de transfert de conversation sécurisé est utilisé pour sécuriser les messages.
CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)	Crée un élément de liaison de sécurité symétrique configuré pour établir une conversation sécurisée entre le client et le service. Le jeton de contexte de sécurité émis à la fin du protocole de transfert de conversation sécurisé est utilisé pour sécuriser les messages. L’élément de liaison de sécurité du démarrage indique comment les messages protocolaires de conversation sont sécurisés.

CreateSecureConversationBindingElement(SecurityBindingElement)

Crée un élément de liaison de sécurité symétrique configuré pour établir une conversation sécurisée entre le client et le service. Le jeton de contexte de sécurité émis à la fin du protocole de transfert de conversation sécurisé est utilisé pour sécuriser les messages. L’élément de liaison de sécurité du démarrage indique comment les messages protocolaires de conversation sont sécurisés.

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

Paramètres

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement qui contient la spécification de la façon dont les messages protocolaires de conversation sont sécurisés.

Retours

SecurityBindingElement

Objet SecurityBindingElement.

Exceptions

ArgumentNullException

bootstrapSecurity a la valeur null.

Remarques

L’élément de liaison est configuré pour utiliser des jetons de contexte de sécurité basés sur une session.

bootstrapSecurity est utilisé pour indiquer la stratégie et la liaison de sécurité servant à demander un jeton de conversation sécurisé au service.

Si bootstrapSecurity est un TransportSecurityBindingElement, l’élément de liaison renvoyé par cette méthode l’est également, et IncludeTimestamp a la valeur true ; la propriété LocalClientSecuritySettings de l’objet LocalClientSettings renvoyé par DetectReplays a la valeur false ; et la propriété LocalServiceSecuritySettings de l’objet LocalServiceSettings renvoyé par DetectReplays a la valeur false.

Sinon, un SymmetricSecurityBindingElement est renvoyé, et RequireSignatureConfirmation a la valeur false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Crée un élément de liaison de sécurité symétrique configuré pour établir une conversation sécurisée entre le client et le service. Le jeton de contexte de sécurité émis à la fin du protocole de transfert de conversation sécurisé est utilisé pour sécuriser les messages.

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

Paramètres

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement qui contient la spécification de la façon dont les messages protocolaires de conversation sont sécurisés.

requireCancellation

Boolean

true si l'annulation est requise ; sinon, false. Si ce paramètre a la valeur false, il active un jeton de contexte de sécurité qui s'avère utile dans les scénarios de batterie de serveurs Web car, dans ce mode, l'état de session est encodé dans le jeton de contexte de sécurité établi au lieu d'être conservé dans la mémoire du serveur.

Retours

SecurityBindingElement

Objet SecurityBindingElement.

Exceptions

ArgumentNullException

bootstrapSecurity a la valeur null.

Exemples

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

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

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

Remarques

Si requireCancellation est false, des jetons de contexte de sécurité basés sur un cookie sont émis ; sinon, des jetons de contexte de sécurité basés sur une session sont émis.

bootstrapSecurity est utilisé pour indiquer la stratégie et la liaison de sécurité servant à demander SecureConversationToken au service.

Si bootstrapSecurity est un TransportSecurityBindingElement, l’élément de liaison renvoyé par cette méthode est également un TransportSecurityBindingElement, et IncludeTimestamp a la valeur true ; la propriété LocalClientSecuritySettings de l’objet LocalClientSettings renvoyé par DetectReplays a la valeur false ; et la propriété LocalServiceSecuritySettings de l’objet LocalServiceSettings renvoyé par DetectReplays a la valeur false.

Sinon, un SymmetricSecurityBindingElement est renvoyé, et RequireSignatureConfirmation a la valeur false.

Notes

Lorsque l’emprunt d’identité est requis sur Windows XP, utilisez une session sécurisée sans jeton de contexte de sécurité. Lorsque des jetons de contexte de sécurité sont utilisés avec l'emprunt d'identité, une InvalidOperationException est renvoyée. Pour plus d’informations, consultez Scénarios non pris en charge. Pour plus d’informations sur les sessions sécurisées, consultez Sessions sécurisées.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean, ChannelProtectionRequirements)

Crée un élément de liaison de sécurité symétrique configuré pour établir une conversation sécurisée entre le client et le service. Le jeton de contexte de sécurité émis à la fin du protocole de transfert de conversation sécurisé est utilisé pour sécuriser les messages. L’élément de liaison de sécurité du démarrage indique comment les messages protocolaires de conversation sont sécurisés.

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

Paramètres

bootstrapSecurity

SecurityBindingElement

SecurityBindingElement qui contient la spécification de la façon dont les messages protocolaires de conversation sont sécurisés.

requireCancellation

Boolean

true si l'annulation est requise ; sinon, false. Si ce paramètre a la valeur false, il active un jeton de contexte de sécurité qui s'avère utile dans les scénarios de batterie de serveurs Web car, dans ce mode, l'état de session est encodé dans le jeton de contexte de sécurité établi au lieu d'être conservé dans la mémoire du serveur.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Objet ChannelProtectionRequirements qui décrit les spécifications de la protection du canal.

Retours

SecurityBindingElement

Objet SecurityBindingElement.

Exceptions

ArgumentNullException

bootstrapSecurity a la valeur null.

Remarques

Le paramètre bootstrapProtectionRequirements active la personnalisation de la sécurisation des messages échangés dans le cadre du protocole de transfert de conversation sécurisé.

bootstrapSecurity est utilisé pour indiquer la stratégie et la liaison de sécurité servant à demander un jeton de conversation sécurisé au service.

Si bootstrapSecurity est un TransportSecurityBindingElement, l’élément de liaison renvoyé par cette méthode est également un TransportSecurityBindingElement, et IncludeTimestamp a la valeur true ; la propriété LocalClientSecuritySettings de l’objet LocalClientSettings renvoyé par DetectReplays a la valeur false ; et la propriété LocalServiceSecuritySettings de l’objet LocalServiceSettings renvoyé par DetectReplays a la valeur false.

Sinon, un SymmetricSecurityBindingElement est renvoyé, et RequireSignatureConfirmation a la valeur false.

Notes

Lorsque l’emprunt d’identité est requis sur Windows XP, utilisez une session sécurisée sans jeton de contexte de sécurité. Lorsque des jetons de contexte de sécurité sont utilisés avec l'emprunt d'identité, une InvalidOperationException est renvoyée. Pour plus d’informations, consultez Scénarios non pris en charge. Pour plus d’informations sur les sessions sécurisées, consultez Sessions sécurisées.