Partager via


SecurityBindingElement Classe

Définition

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
SecurityBindingElement
Dérivé

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

AllowInsecureTransport

Obtient ou définit une valeur qui indique s'il est possible d'envoyer des messages sécurisés en mode mixte via un transport non sécurisé tel que le protocole HTTP.

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.

LocalServiceSettings

Obtient les propriétés de liaison spécifiques aux paramètres de sécurité locaux utilisés par le service.

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.

ProtectTokens

Obtient ou définit une valeur indiquant si l'élément de liaison de sécurité protège les jetons.

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)

Crée un écouteur de canal basé sur les paramètres SecurityBindingElement et le contexte de liaison transmis.

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)
BuildChannelListenerCore<TChannel>(BindingContext)

En cas d'implémentation, crée un écouteur de canal d'un type spécifié.

CanBuildChannelFactory<TChannel>(BindingContext)

Détermine si une fabrication de canal du type spécifié peut être construite.

CanBuildChannelListener<TChannel>(BindingContext)

Détermine si un écouteur de canal du type spécifié peut être construit.

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)
CreateAnonymousForCertificateBindingElement()

Crée un élément de liaison de sécurité symétrique configuré pour l’authentification de client anonyme et l’authentification de serveur par certificat.

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.

CreateCertificateSignatureBindingElement()

Crée un élément de liaison à l’aide d’un certificat pour signer des messages. Cet élément de liaison peut être utilisé uniquement pour les échanges de messages unidirectionnels et ne peut que signer le message.

CreateIssuedTokenBindingElement(IssuedSecurityTokenParameters)

Crée un élément de liaison de sécurité symétrique configuré pour requérir l’authentification du client à l’aide d’un jeton émis sur la base d’une clé symétrique.

CreateIssuedTokenForCertificateBindingElement(IssuedSecurityTokenParameters)

Crée un élément de liaison de sécurité symétrique configuré pour requérir l'authentification du client sur la base d'un jeton émis et l'authentification du serveur sur la base du certificat de serveur.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters)

Crée un élément de liaison de sécurité symétrique configuré pour requérir l'authentification du client sur la base d'un jeton émis et l'authentification du serveur sur la base du certificat de serveur.

CreateIssuedTokenForSslBindingElement(IssuedSecurityTokenParameters, Boolean)

Crée un élément de liaison de sécurité symétrique configuré pour requérir l'authentification du client sur la base d'un jeton émis et l'authentification du serveur sur la base du certificat de serveur.

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).

CreateKerberosBindingElement()

Crée un élément de liaison de sécurité symétrique configuré pour requérir l’authentification du client sur la base du jeton Kerberos du client.

CreateKerberosOverTransportBindingElement()

Crée un élément de liaison de sécurité configuré pour requérir l’authentification du client sur la base de la sécurité SOAP à l’aide du jeton Kerberos du client. 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.

CreateMutualCertificateDuplexBindingElement()

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. Ce mode d’authentification peut être utilisé pour sécuriser les modèles d’échange de messages duplex et requiert que le service soit configuré avec le certificat du client hors plage.

CreateMutualCertificateDuplexBindingElement(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. Ce mode d’authentification peut être utilisé pour sécuriser les modèles d’échange de messages duplex et requiert que le service soit configuré avec le certificat du client hors plage.

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.

CreateSslNegotiationBindingElement(Boolean)

Crée un élément de liaison de sécurité symétrique configuré pour exécuter la négociation SSL au niveau SOAP entre le client et le serveur, en indiquant si un certificat client est requis.

CreateSslNegotiationBindingElement(Boolean, Boolean)

Crée un élément de liaison de sécurité symétrique qui exécute la négociation SOAP SSL, en indiquant si un certificat client et l’annulation sont requis.

CreateSspiNegotiationBindingElement()

Crée un élément de liaison de sécurité symétrique qui exécute la négociation SOAP SSPI sur la base du package Authentification par négociation.

CreateSspiNegotiationBindingElement(Boolean)

Crée un élément de liaison de sécurité symétrique qui exécute la négociation SOAP SSPI sur la base du package Authentification par négociation.

CreateSspiNegotiationOverTransportBindingElement()

Crée un élément de liaison de sécurité configuré pour l’authentification du client sur la base de la négociation SOAP SSPI à l’aide du package Authentification par négociation. L’élément de liaison requiert que le transport assure l’authentification du serveur ainsi que la protection des messages (par exemple, HTTPS).

CreateSspiNegotiationOverTransportBindingElement(Boolean)

Crée un élément de liaison de sécurité configuré pour l’authentification du client sur la base de la négociation SOAP SSPI à l’aide du package Authentification par négociation. L’élément de liaison requiert que le transport assure l’authentification du serveur ainsi que la protection des messages (par exemple, HTTPS).

CreateUserNameForCertificateBindingElement()

Crée un élément de liaison de sécurité symétrique configuré pour requérir l’authentification du client en fonction de son nom d’utilisateur et de son mot de passe et l’authentification du serveur par certificat. L'élément de liaison créé requiert que le client soit configuré avec un certificat de service hors plage avant d'ouvrir un canal de communication avec un service.

CreateUserNameForSslBindingElement()

Crée un élément de liaison de sécurité symétrique configuré pour requérir l’authentification du client en fonction de son nom d’utilisateur et de son mot de passe et l’authentification du serveur par certificat. Le client authentifie le serveur à l'aide du protocole SSL au niveau SOAP.

CreateUserNameForSslBindingElement(Boolean)

Crée un élément de liaison de sécurité symétrique configuré pour requérir l’authentification du client en fonction de son nom d’utilisateur et de son mot de passe et l’authentification du serveur par certificat. Le client authentifie le serveur à l'aide du protocole SSL au niveau SOAP.

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.

S’applique à

Voir aussi