SecurityBindingElement Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v6.2.0

Source:

SecurityBindingElement.cs

Classe abstraite qui, une fois implémentée, représente un élément de liaison qui prend en charge la sécurité des messages SOAP de canaux.

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é de message SOAP dans WCF. Il existe trois implémentations de cette classe abstraite : SymmetricSecurityBindingElement, AsymmetricSecurityBindingElement et TransportSecurityBindingElement. Ces implémentations modèlent 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 réorganisés dans un ordre spécifique : l’élément qui représente le haut de la pile de liaison est ajouté en premier, l’élément suivant dans la pile de liaison est ajouté en deuxième position, etc.

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

1. Créez un BindingElementCollection.

2. Créez un élément de liaison personnalisé placé au-dessus de cet élément de liaison dans la pile de liaison, tel que les TransactionFlowBindingElement et ReliableSessionBindingElement facultatifs.

3. Ajoutez ces éléments dans l'ordre précédemment indiqué au BindingElementCollection à l'aide de la méthode InsertItem.

4. Créez une instance d'un élément de liaison de sécurité dérivé de SecurityBindingElement, tel que AsymmetricSecurityBindingElement, SymmetricSecurityBindingElement ou TransportSecurityBindingElement.

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

6. Ajoutez tout élément de liaison personnalisé supplémentaire à la collection, tel que TcpTransportBindingElement.

Pour plus d’informations sur l’utilisation d’un SecurityBindingElement, consultez Modes d’authentification SecurityBindingElement et Guide pratique pour créer une liaison personnalisée à l’aide de SecurityBindingElement.

Notes

Une fois qu'un objet SecurityBindingElement est créé, vous devez traiter ses propriétés comme étant immuables. En appelant set sur certaines propriétés, vous risquez d'obtenir des résultats imprévisibles : la liaison peut se comporter comme si la propriété avait conservé sa valeur antérieure, un échec de l'exécution étant alors le seul indicateur d'un problème. KeyType et MessageSecurityVersion sont deux propriétés connues pour se comporter ainsi. D'autres propriétés peuvent également être concernées.

Propriétés

DefaultAlgorithmSuite	Obtient ou définit les algorithmes de chiffrement de message et de clé de type WRAP.
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 des paramètres de jeton.
IncludeTimestamp	Obtient ou définit une valeur qui indique si l'horodatage est 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é du message.
OperationSupportingTokenParameters	Obtient la collection des paramètres du 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 du service.
OptionalOperationSupportingTokenParameters	Obtient la collection des paramètres optionnels du jeton de prise en charge de l'opération.
SecurityHeaderLayout	Obtient ou définit l'ordre des éléments dans l'en-tête de sécurité de cette liaison.

Méthodes

BuildChannelFactory<TChannel>(BindingContext)	Crée une fabrique de canal basée sur les paramètres SecurityBindingElement et le contexte de liaison transmis. La fabrication de canal créée est une fabrication de canal de sécurité de messages SOAP, qui comprend en interne une référence à la fabrication de canal correspondant au contexte de liaison (lequel inclut la fabrication du canal de transport).
BuildChannelFactoryCore<TChannel>(BindingContext)	En cas d'implémentation, crée une fabrication de canal d'un type spécifié.
BuildChannelListener<TChannel>(BindingContext)	Initialise un écouteur de canal pour accepter les canaux d’un type donné issus du contexte de liaison. (Hérité de BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Détermine si une fabrication de canal du type spécifié peut être construite.
CanBuildChannelListener<TChannel>(BindingContext)	Retourne une valeur qui indique si l’élément de liaison peut générer un écouteur pour un type de canal spécifique. (Hérité de BindingElement)
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 attend que les clients effectuent l’authentification par certificat à l’aide de la sécurité des messages SOAP.
CreateCertificateOverTransportBindingElement(MessageSecurityVersion)	Crée un élément de liaison de sécurité qui attend que les clients effectuent l’authentification par certificat à l’aide de la sécurité des messages SOAP.
CreateIssuedTokenOverTransportBindingElement(IssuedSecurityTokenParameters)	Crée un élément de liaison de sécurité configuré pour requérir l’authentification du client en fonction de la sécurité SOAP à l’aide d’un jeton émis. Cet élément de liaison requiert que le transport assure l'authentification du serveur ainsi que la protection des messages (par exemple, HTTPS).
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.
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.
CreateUserNameOverTransportBindingElement()	Crée un élément de liaison de sécurité configuré pour l’authentification du client en fonction du nom d’utilisateur et du mot de passe envoyés dans le cadre du message SOAP. L’élément de liaison requiert que le transport assure l’authentification du serveur ainsi que la protection des messages (par exemple, HTTPS).
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperty<T>(BindingContext)	Obtient un objet spécifié à l'aide du BindingContext spécifié.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SetIssuerBindingContextIfRequired(SecurityTokenParameters, BindingContext)	Définit la clé pour la propriété d'exigence de jeton dont la valeur est le BindingContext à utiliser pour parler au correspondant émetteur lorsque la spécification est pour un jeton émis.
SetKeyDerivation(Boolean)	Définit une valeur qui indique si les clés dérivées sont requises.
ToString()	Renvoie la description de cette classe.

Voir aussi

• Modes d'authentification SecurityBindingElement
• Procédure : créer une liaison personnalisée à l’aide de SecurityBindingElement