SecurityBindingElement Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assemblys:

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

Paquet:

System.ServiceModel.Primitives v10.0.652802

Source:

SecurityBindingElement.cs

Classe abstraite qui, en cas d’implémentation, représente un élément de liaison qui prend en charge la sécurité des messages SOAP du canal.

public ref class SecurityBindingElement abstract : System::ServiceModel::Channels::BindingElement

public abstract class SecurityBindingElement : System.ServiceModel.Channels.BindingElement

type SecurityBindingElement = class
    inherit BindingElement

Public MustInherit Class SecurityBindingElement
Inherits BindingElement

Héritage

Object

BindingElement

SecurityBindingElement

Dérivé

System.ServiceModel.Channels.AsymmetricSecurityBindingElement

System.ServiceModel.Channels.SymmetricSecurityBindingElement

System.ServiceModel.Channels.TransportSecurityBindingElement

Remarques

Cette classe est la classe de base pour les éléments de liaison de sécurité des messages SOAP dans WCF. Il existe trois implémentations de cette classe abstraite : SymmetricSecurityBindingElement, AsymmetricSecurityBindingElementet TransportSecurityBindingElement. Ces implémentations modélisent les liaisons définies dans la spécification de stratégie WS-Security.

Une liaison personnalisée contient une collection d’éléments de liaison organisés dans un ordre spécifique : l’élément qui représente le haut de la pile de liaisons est ajouté en premier, l’élément suivant vers le bas dans la pile de liaisons est ajouté deuxièmement, et ainsi de suite.

Pour ajouter cette classe à une liaison, procédez comme suit :

1. Créer un BindingElementCollection.

2. Créez un élément de liaison personnalisé qui se trouve au-dessus de cet élément de liaison dans la pile de liaisons, tel que le facultatif TransactionFlowBindingElement et ReliableSessionBindingElement.

3. Ajoutez ces éléments dans l’ordre décrit précédemment à l’aide BindingElementCollection de la InsertItem méthode.

4. Créez une instance d’un élément de liaison de SecurityBindingElementsécurité dérivé, par AsymmetricSecurityBindingElementexemple, SymmetricSecurityBindingElementou TransportSecurityBindingElement.

5. Ajoutez l’élément de liaison de sécurité dérivé à la collection.

6. Ajoutez tous les éléments de liaison personnalisés supplémentaires à la collection, par TcpTransportBindingElementexemple .

Pour plus d’informations sur l’utilisation d’un SecurityBindingElement, consultez Les modes d’authentification SecurityBindingElement et comment : créer une liaison personnalisée à l’aide de SecurityBindingElement.

Note

Une fois qu’un SecurityBindingElement objet est créé, vous devez traiter ses propriétés comme immuables. L’appel set de certaines propriétés peut avoir des effets imprévisibles : la liaison peut se comporter comme si la propriété conservait sa ancienne valeur, avec un échec d’exécution étant la seule indication d’un problème. Deux propriétés connues pour se comporter de cette façon sont KeyType et MessageSecurityVersion. Il peut y avoir d’autres propriétés dont cela est également vrai.

Propriétés

Nom	Description
DefaultAlgorithmSuite	Obtient ou définit le chiffrement des messages et les algorithmes d’habillage de clé.
EnableUnsecuredResponse	Obtient ou définit une valeur qui indique si WCF peut envoyer et recevoir des réponses non sécurisées aux demandes sécurisées.
EndpointSupportingTokenParameters	Obtient le point de terminaison qui prend en charge les paramètres de jeton.
IncludeTimestamp	Obtient ou définit une valeur qui indique si les horodatages sont inclus dans chaque message.
KeyEntropyMode	Obtient ou définit la source d’entropie utilisée pour créer des clés.
LocalClientSettings	Obtient les propriétés de liaison spécifiques aux paramètres de sécurité locaux utilisés par le client.
MessageSecurityVersion	Obtient ou définit la version de sécurité des messages.
OperationSupportingTokenParameters	Obtient la collection des paramètres de jeton de prise en charge de l’opération.
OptionalEndpointSupportingTokenParameters	Obtient les paramètres de jeton de prise en charge facultatifs pour le point de terminaison de service.
OptionalOperationSupportingTokenParameters	Obtient la collection des paramètres de jeton de prise en charge de l’opération facultative.
SecurityHeaderLayout	Obtient ou définit l’ordre des éléments dans l’en-tête de sécurité pour cette liaison.

Méthodes

Nom	Description
BuildChannelFactory<TChannel>(BindingContext)	Crée une fabrique de canaux en fonction des SecurityBindingElement paramètres et du contexte de liaison transmis. La fabrique de canaux créée est une fabrique de canal de sécurité des messages SOAP, qui a en interne une référence à la fabrique de canaux qui correspond au contexte de liaison (qui inclut la fabrique de canal de transport).
BuildChannelFactoryCore<TChannel>(BindingContext)	En cas d’implémentation, crée une fabrique de canaux d’un type spécifié.
CanBuildChannelFactory<TChannel>(BindingContext)	Détermine si une fabrique de canal du type spécifié peut être générée.
Clone()	En cas de substitution dans une classe dérivée, retourne une copie de l’objet d’élément de liaison. (Hérité de BindingElement)
CreateCertificateOverTransportBindingElement()	Crée un élément de liaison de sécurité qui s’attend à ce que les clients effectuent une authentification basée sur des certificats à l’aide de la sécurité des messages SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Crée un élément de liaison de sécurité qui s’attend à ce que les clients effectuent une authentification basée sur des certificats à l’aide de la sécurité des messages SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Crée un élément de liaison de sécurité configuré pour exiger l’authentification du client basée sur la sécurité SOAP à l’aide d’un jeton émis. Cet élément de liaison nécessite le transport pour fournir l’authentification du serveur et la protection des messages (par exemple, HTTPS).
CreateMutualCertificateBindingElement()	Crée un élément de liaison de sécurité asymétrique configuré pour exiger l’authentification client basée sur un certificat ainsi que l’authentification du serveur basé sur des certificats.
CreateMutualCertificateBindingElement(MessageSecurityVersion, Boolean)	Crée un élément de liaison de sécurité asymétrique configuré pour exiger l’authentification client basée sur un certificat ainsi que l’authentification du serveur basé sur des certificats.
CreateMutualCertificateBindingElement(MessageSecurityVersion)	Crée un élément de liaison de sécurité asymétrique configuré pour exiger l’authentification client basée sur un certificat ainsi que l’authentification du serveur basé sur des certificats.
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, 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)	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.
CreateUserNameOverTransportBindingElement()	Crée un élément de liaison de sécurité configuré pour l’authentification du client en fonction d’un nom d’utilisateur et d’un mot de passe envoyé dans le cadre du message SOAP. L’élément de liaison nécessite le transport pour fournir l’authentification du serveur et la protection des messages (par exemple, HTTPS).
GetProperty<T>(BindingContext)	Obtient un objet spécifié à l’aide de l’objet spécifié BindingContext.
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Définit la clé de la propriété d’exigence de jeton dont la valeur est bindingContext utilisée pour communiquer avec la partie émettrice si l’exigence concerne un jeton émis.
SetKeyDerivation(Boolean)	Définit une valeur qui indique si les clés dérivées sont requises.
ToString()	Retourne une description de cette classe.

Voir aussi

• Modes d'authentification de SecurityBindingElement
• Guide pratique pour créer une liaison personnalisée à l’aide de SecurityBindingElement