ClientCredentials Classe

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Permet à l'utilisateur de configurer les informations d'identification du client et du service, ainsi que les paramètres d'authentification des informations d'identification du service à utiliser du côté client de la communication.

public ref class ClientCredentials : System::ServiceModel::Description::IEndpointBehavior

public ref class ClientCredentials : System::ServiceModel::Security::SecurityCredentialsManager, System::ServiceModel::Description::IEndpointBehavior

public class ClientCredentials : System.ServiceModel.Description.IEndpointBehavior

public class ClientCredentials : System.ServiceModel.Security.SecurityCredentialsManager, System.ServiceModel.Description.IEndpointBehavior

type ClientCredentials = class
    interface IEndpointBehavior

type ClientCredentials = class
    inherit SecurityCredentialsManager
    interface IEndpointBehavior

Public Class ClientCredentials
Implements IEndpointBehavior

Public Class ClientCredentials
Inherits SecurityCredentialsManager
Implements IEndpointBehavior

Héritage

Object

ClientCredentials

Héritage

Object

SecurityCredentialsManager

ClientCredentials

Dérivé

System.ServiceModel.Federation.WSTrustChannelClientCredentials

Implémente

IEndpointBehavior

Exemples

L'exemple de code suivant indique comment substituer cette classe et implémenter vos informations d'identification du client personnalisées qui intègrent un gestionnaire de jetons de sécurité personnalisé.

Important

Il est important de noter que la méthode CreateSecurityTokenManager est remplacée pour créer un gestionnaire de jetons de sécurité personnalisé. Le gestionnaire de jetons de sécurité, dérivé de ClientCredentialsSecurityTokenManager, doit retourner un fournisseur de jetons de sécurité personnalisé, dérivé de SecurityTokenProvider, pour créer le jeton de sécurité réel. Si vous ne suivez pas ce modèle pour créer des jetons de sécurité, votre application s’expose à des risques liés aux attaques de sécurité, notamment l’élévation de privilèges. Ce modèle de codage vérifie que les informations d’identification correctes sont utilisées lorsque les fabriques de canaux sont mises en cache.

public class MyClientCredentials : ClientCredentials
{
    string creditCardNumber;

    public MyClientCredentials()
    {
        // Perform client credentials initialization.
    }

    protected MyClientCredentials(MyClientCredentials other)
        : base(other)
    {
        // Clone fields defined in this class.
        this.creditCardNumber = other.creditCardNumber;
    }

    public string CreditCardNumber
    {
        get
        {
            return this.creditCardNumber;
        }
        set
        {
            if (value == null)
            {
                throw new ArgumentNullException("value");
            }
            this.creditCardNumber = value;
        }
    }

    public override SecurityTokenManager CreateSecurityTokenManager()
    {
        // Return your implementation of the SecurityTokenManager.
        return new MyClientCredentialsSecurityTokenManager(this);
    }

    protected override ClientCredentials CloneCore()
    {
        // Implement the cloning functionality.
        return new MyClientCredentials(this);
    }
}

Public Class MyClientCredentials
    Inherits ClientCredentials
    Private creditCardNumberValue As String

    Public Sub New() 
    
    End Sub
    
    ' Perform client credentials initialization.    
    Protected Sub New(ByVal other As MyClientCredentials) 
        MyBase.New(other)
        ' Clone fields defined in this class.
        Me.creditCardNumberValue = other.creditCardNumberValue
    
    End Sub

    Public Property CreditCardNumber() As String 
        Get
            Return Me.creditCardNumberValue
        End Get
        Set
            If value Is Nothing Then
                Throw New ArgumentNullException("value")
            End If
            Me.creditCardNumberValue = value
        End Set
    End Property

    Public Overrides Function CreateSecurityTokenManager() As SecurityTokenManager 
        ' Return your implementation of the SecurityTokenManager.
        Return New MyClientCredentialsSecurityTokenManager(Me)
    
    End Function
    
    Protected Overrides Function CloneCore() As ClientCredentials 
        ' Implement the cloning functionality.
        Return New MyClientCredentials(Me)
    
    End Function
End Class

Remarques

ClientCredentials est accessible via la propriété ClientCredentials de la classe ClientBase<TChannel>.

Un objet ClientCredentials est ajouté à la collection Behaviors. La ClientCredentials propriété est une façade (modèle de conception connu) sur une entrée dans cette collection. De nombreuses propriétés de cette classe retournent des objets constitués essentiellement de propriétés. Ces objets peuvent être utilisés à des fins de configuration : une fois que vous effectuez une opération get sur un objet, vous pouvez l'utiliser pour effectuer une opération set sur des propriétés en appelant ses membres.

Constructeurs

ClientCredentials()	Initialise une nouvelle instance de la classe ClientCredentials.
ClientCredentials(ClientCredentials)	Constructeur de copie.

Propriétés

ClientCertificate	Obtient un objet que vous pouvez utiliser pour fournir le certificat X.509 permettant au client de s'authentifier auprès du service.
HttpDigest	Obtient les informations d’identification HTTP Digest actuelles.
IssuedToken	Utilisez cette propriété pour spécifier l’adresse de point de terminaison et la liaison à utiliser lorsque vous contactez votre service de jetons de sécurité local. Ces informations sont utilisées lorsqu’un service nécessite une authentification à l’aide d’un jeton émis, mais que la stratégie du service (représenté sous la forme d’une liaison sur le client) n’indique pas explicitement comment ni où obtenir le jeton émis.
Peer	Détermine les informations d'identification qu'un nœud homologue utilise pour s'authentifier sur les autres nœuds de la maille, ainsi que les paramètres d'authentification qu'un nœud homologue utilise pour authentifier les autres nœuds homologues.
SecurityTokenHandlerCollectionManager	Obtient ou définit le gestionnaire de jetons de sécurité pour les informations d'identification du client.
ServiceCertificate	Obtient un objet servant à spécifier le certificat X.509 d'un service.
SupportInteractive	Obtient ou définit une valeur qui indique si le système est autorisé à inviter de manière interactive l'utilisateur à spécifier des informations d'identification, si nécessaire. Par exemple, la valeur false est généralement recommandée dans des scénarios de couche intermédiaire.
UseIdentityConfiguration	Obtient ou définit une valeur indiquant si les informations d'identification du client utilisent la configuration d'identité.
UserName	Obtient un objet d'informations d'identification que vous pouvez utiliser pour définir le nom d'utilisateur et le mot de passe dont le client se sert pour s'authentifier auprès du service.
Windows	Obtient un objet utilisé pour déterminer les informations d'identification Windows dont le client se sert pour s'authentifier auprès du service.

Méthodes

ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Applique le comportement client spécifié au point de terminaison.
Clone()	Crée une copie de cette instance ClientCredentials.
CloneCore()	Crée une copie de cette instance ClientCredentials.
CreateSecurityTokenManager()	Crée un gestionnaire de jetons de sécurité pour cette instance. Cette méthode est rarement appelée de manière explicite. En effet, elle est principalement utilisée dans des scénarios d'extensibilité et est appelée par le système lui-même.
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)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)	Génère et retourne un jeton de sécurité à l’aide du système CardSpace et de la chaîne de stratégie et du sérialiseur de jetons spécifiés.
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)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Ajoute cette instance de cette classe à une collection de paramètres de liaison.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implémente une modification ou une extension du service sur l’intégralité du point de terminaison.
IEndpointBehavior.Validate(ServiceEndpoint)	Réservé à un usage ultérieur.