ClientCredentials ClientCredentials ClientCredentials ClientCredentials Class

Définition

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.Enables the user to configure client and service credentials as well as service credential authentication settings for use on the client side of communication.

public ref class ClientCredentials : System::ServiceModel::Description::IEndpointBehavior
public class ClientCredentials : System.ServiceModel.Description.IEndpointBehavior
type ClientCredentials = class
    interface IEndpointBehavior
Public Class ClientCredentials
Implements IEndpointBehavior
Héritage
ClientCredentialsClientCredentialsClientCredentialsClientCredentials
Implémente

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é.The following code sample shows how to override this class and implement your own custom client credentials that includes a custom security token manager.

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é.It is important to note that the CreateSecurityTokenManager method is overridden to create a custom security token manager. Le gestionnaire de jetons de sécurité, dérivé de ClientCredentialsSecurityTokenManager,The security token manager, derived from 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.must return a custom security token provider, derived from SecurityTokenProvider, to create the actual security token. 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.If you do not follow this pattern for creating security tokens, your application will be at risk for security attacks, specifically elevation of privileges. 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.This coding pattern ensures that the correct credentials are used when channel factories are cached.

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 'New
    
    ' 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>.The ClientCredentials is accessed through the ClientCredentials property of the ClientBase<TChannel> class.

Un objet ClientCredentials est ajouté à la collection Behaviors.A ClientCredentials object is added to the Behaviors collection. Le ClientCredentials propriété est un Façade (un modèle de conception bien connu) sur une entrée dans cette collection.The ClientCredentials property is a Façade (a well-known design pattern) over an entry in that collection. De nombreuses propriétés de cette classe retournent des objets constitués essentiellement de propriétés.Many properties in this class return objects that consist mainly of properties. 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.These objects can be used for configuration: once you get the object, you can use it to set properties by calling its members.

Constructeurs

ClientCredentials() ClientCredentials() ClientCredentials() ClientCredentials()

Initialise une nouvelle instance de la classe ClientCredentials.Initializes a new instance of the ClientCredentials class.

ClientCredentials(ClientCredentials) ClientCredentials(ClientCredentials) ClientCredentials(ClientCredentials) ClientCredentials(ClientCredentials)

Constructeur de copie.This is a copy constructor.

Propriétés

ClientCertificate ClientCertificate ClientCertificate ClientCertificate

Obtient un objet que vous pouvez utiliser pour fournir le certificat X.509 permettant au client de s'authentifier auprès du service.Gets an object that you can use to provide the X.509 certificate that the client uses to authenticate to the service.

HttpDigest HttpDigest HttpDigest HttpDigest

Obtient les informations d’identification HTTP Digest actuelles.Gets the current HTTP Digest credential.

IssuedToken IssuedToken IssuedToken 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.Use this property to specify the endpoint address and binding to use when contacting your local Security Token Service. 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.This information is used when a service requires authentication using an issued token, but the policy of the service (represented as a binding on the client) does not explicitly specify how and where to obtain the issued token.

Peer Peer Peer 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.Controls the credentials that a peer node uses to authenticate itself to other nodes in the mesh, as well as authentication settings that a peer node uses to authenticate other peer nodes.

SecurityTokenHandlerCollectionManager SecurityTokenHandlerCollectionManager SecurityTokenHandlerCollectionManager SecurityTokenHandlerCollectionManager

Obtient ou définit le gestionnaire de jetons de sécurité pour les informations d'identification du client.Gets or sets the security token handler for the client credential.

ServiceCertificate ServiceCertificate ServiceCertificate ServiceCertificate

Obtient un objet servant à spécifier le certificat X.509 d'un service.Gets an object used to specify a service's X.509 certificate.

SupportInteractive SupportInteractive SupportInteractive 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.Gets or sets a value that indicates whether the system is allowed to interactively prompt the user for credentials when necessary. Par exemple, la valeur false est généralement recommandée dans des scénarios de couche intermédiaire.For example, setting it to false might be desired in middle-tier scenarios.

UseIdentityConfiguration UseIdentityConfiguration UseIdentityConfiguration UseIdentityConfiguration

Obtient ou définit une valeur indiquant si les informations d'identification du client utilisent la configuration d'identité.Gets or sets whether the client credentials uses identity configuration.

UserName UserName UserName 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.Gets a credential object that you can use to set the user name and password that the client uses to authenticate itself to the service.

Windows Windows Windows 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.Gets an object used to control the Windows credential that the client uses to authenticate itself to the service.

Méthodes

ApplyClientBehavior(ServiceEndpoint, ClientRuntime) ApplyClientBehavior(ServiceEndpoint, ClientRuntime) ApplyClientBehavior(ServiceEndpoint, ClientRuntime) ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

Applique le comportement client spécifié au point de terminaison.Applies the specified client behavior to the endpoint.

Clone() Clone() Clone() Clone()

Crée une copie de cette instance ClientCredentials.Creates a new copy of this ClientCredentials instance.

CloneCore() CloneCore() CloneCore() CloneCore()

Crée une copie de cette instance ClientCredentials.Creates a new copy of this ClientCredentials instance.

CreateSecurityTokenManager() CreateSecurityTokenManager() CreateSecurityTokenManager() CreateSecurityTokenManager()

Crée un gestionnaire de jetons de sécurité pour cette instance.Creates a security token manager for this 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.This method is rarely called explicitly; it is primarily used in extensibility scenarios and is called by the system itself.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer) GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer) GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer) GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)

Génère et retourne un jeton de sécurité à l'aide du système CardSpaceCardSpace ainsi que la chaîne de stratégie et le sérialiseur de jeton spécifiés.Generates and returns a security token using the CardSpaceCardSpace system and the specified policy chain and token serializer.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection) IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection) IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection) IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

Ajoute cette instance de cette classe à une collection de paramètres de liaison.Adds this instance of this class to a binding parameter collection.

IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

Implémente une modification ou une extension du service sur l’intégralité du point de terminaison.Implements a modification or extension of the service across an endpoint.

IEndpointBehavior.Validate(ServiceEndpoint) IEndpointBehavior.Validate(ServiceEndpoint) IEndpointBehavior.Validate(ServiceEndpoint) IEndpointBehavior.Validate(ServiceEndpoint)

Réservé à un usage ultérieur.Reserved for future use.

S’applique à