SecurityBindingElement.CreateSecureConversationBindingElement Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assemblys:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v10.0.652802

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 de la négociation de conversation sécurisée est utilisé pour sécuriser les messages.

Surcharges

Nom	Description
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 de la négociation de conversation sécurisée est utilisé pour sécuriser les messages. L’élément de liaison de sécurité bootstrap spécifie la façon dont les messages de négociation de conversation sécurisés 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 de la négociation de conversation sécurisée 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 de la négociation de conversation sécurisée est utilisé pour sécuriser les messages. L’élément de liaison de sécurité bootstrap spécifie la façon dont les messages de négociation de conversation sécurisés sont sécurisés.

CreateSecureConversationBindingElement(SecurityBindingElement)

Source:

SecurityBindingElement.cs

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 de la négociation de conversation sécurisée est utilisé pour sécuriser les messages. L’élément de liaison de sécurité bootstrap spécifie la façon dont les messages de négociation de conversation sécurisés 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

Qui SecurityBindingElement contient une spécification sur la façon dont les messages de négociation de conversation sécurisés 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.

Il bootstrapSecurity est utilisé pour indiquer la liaison de sécurité et la stratégie utilisées pour demander un jeton de conversation sécurisé auprès du service.

S’il bootstrapSecurity s’agit d’un TransportSecurityBindingElementélément de liaison retourné par cette méthode est également un, et IncludeTimestamp est défini truesur ; et l’objet LocalClientSecuritySettings retourné par LocalClientSettings sa propriété falsea la DetectReplays valeur ; et l’objet LocalServiceSecuritySettings retourné par LocalServiceSettings sa DetectReplays propriété a la valeur false.

Sinon, un SymmetricSecurityBindingElement est retourné, avec RequireSignatureConfirmation la valeur définie sur false.

CreateSecureConversationBindingElement(SecurityBindingElement, Boolean)

Source:

SecurityBindingElement.cs

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 de la négociation de conversation sécurisée 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

Qui SecurityBindingElement contient une spécification sur la façon dont les messages de négociation de conversation sécurisés sont sécurisés.

requireCancellation

Boolean

true si l’annulation est requise ; sinon, false. Définition de ce paramètre pour false activer un jeton de contexte de sécurité utile dans les scénarios de batterie de serveurs Web, car dans ce mode, l’état de session est encodé à l’intérieur du jeton de contexte de sécurité établi au lieu d’être conservé dans la mémoire du serveur.

Retours

Objet SecurityBindingElement.

Exceptions

ArgumentNullException

bootstrapSecurity a la valeur null.

Exemples

Le code suivant montre comment appeler cette méthode.

SecurityBindingElement security = SecurityBindingElement.CreateMutualCertificateBindingElement();

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

Remarques

Si requireCancellation c’est falsele cas, les jetons de contexte de sécurité basés sur les cookies sont émis ; sinon, les jetons de contexte de sécurité basés sur la session sont émis.

Il bootstrapSecurity est utilisé pour indiquer la liaison de sécurité et la stratégie utilisées pour demander un SecureConversationToken service.

S’il bootstrapSecurity s’agit d’un TransportSecurityBindingElementélément de liaison retourné par cette méthode est également un TransportSecurityBindingElement, et IncludeTimestamp est défini sur true; et l’objet LocalClientSecuritySettings retourné par LocalClientSettings sa propriété falsea la DetectReplays valeur ; et l’objet LocalServiceSecuritySettings retourné par LocalServiceSettings sa DetectReplays propriété a la valeur false.

Sinon, un SymmetricSecurityBindingElement est retourné, avec RequireSignatureConfirmation la valeur définie sur false.

Note

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é, un InvalidOperationException jeton est levé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)

Source:

SecurityBindingElement.cs

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 de la négociation de conversation sécurisée est utilisé pour sécuriser les messages. L’élément de liaison de sécurité bootstrap spécifie la façon dont les messages de négociation de conversation sécurisés 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

Qui SecurityBindingElement contient une spécification sur la façon dont les messages de négociation de conversation sécurisés sont sécurisés.

requireCancellation

Boolean

true si l’annulation est requise ; sinon, false. Définition de ce paramètre pour false activer un jeton de contexte de sécurité utile dans les scénarios de batterie de serveurs Web, car dans ce mode, l’état de session est encodé à l’intérieur du jeton de contexte de sécurité établi au lieu d’être conservé dans la mémoire du serveur.

bootstrapProtectionRequirements

ChannelProtectionRequirements

Objet ChannelProtectionRequirements qui spécifie les conditions requises pour la protection des canaux.

Retours

Objet SecurityBindingElement.

Exceptions

ArgumentNullException

bootstrapSecurity a la valeur null.

Remarques

Le bootstrapProtectionRequirements paramètre active la personnalisation de la façon dont les messages échangés dans le cadre de la négociation de conversation sécurisée sont sécurisés.

Il bootstrapSecurity est utilisé pour indiquer la liaison de sécurité et la stratégie utilisées pour demander un jeton de conversation sécurisé auprès du service.

S’il bootstrapSecurity s’agit d’un TransportSecurityBindingElementélément de liaison retourné par cette méthode est également un TransportSecurityBindingElement, et IncludeTimestamp est défini sur true; et l’objet LocalClientSecuritySettings retourné par LocalClientSettings sa propriété falsea la DetectReplays valeur ; et l’objet LocalServiceSecuritySettings retourné par LocalServiceSettings sa DetectReplays propriété a la valeur false.

Sinon, un SymmetricSecurityBindingElement est retourné, avec RequireSignatureConfirmation la valeur définie sur false.

Note

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é, un InvalidOperationException jeton est levé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.