ClientCredentials Classe

Definizione

Consente all'utente di configurare le credenziali client e del servizio, nonché le impostazioni di autenticazione delle credenziali del servizio da utilizzare per il lato client della comunicazione.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
Ereditarietà
ClientCredentials
Implementazioni

Esempi

Nell'esempio di codice seguente viene illustrato come eseguire l'override di questa classe e implementare credenziali client personalizzate che includono un gestore dei token di sicurezza personalizzato.The following code sample shows how to override this class and implement your own custom client credentials that includes a custom security token manager.

Importante

È importante da notare che l'override del metodo CreateSecurityTokenManager viene eseguito per creare un gestore del token di sicurezza personalizzato.It is important to note that the CreateSecurityTokenManager method is overridden to create a custom security token manager. Il gestore del token di sicurezza, derivato da ClientCredentialsSecurityTokenManager.The security token manager, derived from ClientCredentialsSecurityTokenManager. deve restituire un provider del token di sicurezza personalizzato, derivato da SecurityTokenProvider, per creare il token di sicurezza effettivo.must return a custom security token provider, derived from SecurityTokenProvider, to create the actual security token. Se non si segue questo modello per la creazione di token di sicurezza, l'applicazione sarà esposta al rischio di attacchi alla sicurezza, in particolare tramite elevazione dei privilegi.If you do not follow this pattern for creating security tokens, your application will be at risk for security attacks, specifically elevation of privileges. Questo modello di codifica si assicura che vengano usate le credenziali corrette quando vengono memorizzate nella cache le channel factory.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
    
    ' 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

Commenti

È possibile accedere a ClientCredentials tramite la proprietà ClientCredentials della classe ClientBase<TChannel>.The ClientCredentials is accessed through the ClientCredentials property of the ClientBase<TChannel> class.

Oggetto ClientCredentials aggiunto alla raccolta Behaviors.A ClientCredentials object is added to the Behaviors collection. La proprietà ClientCredentials è una facciata (un modello di progettazione noto) su una voce nella raccolta.The ClientCredentials property is a Façade (a well-known design pattern) over an entry in that collection. Molte proprietà di questa classe restituiscono oggetti costituiti principalmente da proprietà.Many properties in this class return objects that consist mainly of properties. Questi oggetti possono essere utilizzati per la configurazione: una volta eseguita l'operazione di get dell'oggetto, è possibile utilizzarlo per eseguire l'operazione di set delle proprietà chiamandone i membri.These objects can be used for configuration: once you get the object, you can use it to set properties by calling its members.

Costruttori

ClientCredentials()

Inizializza una nuova istanza della classe ClientCredentials.Initializes a new instance of the ClientCredentials class.

ClientCredentials(ClientCredentials)

Si tratta di un costruttore di copia.This is a copy constructor.

Proprietà

ClientCertificate

Ottiene un oggetto che è possibile utilizzare per fornire il certificato X.509 utilizzato dal client per l'autenticazione al servizio.Gets an object that you can use to provide the X.509 certificate that the client uses to authenticate to the service.

HttpDigest

Ottiene la credenziale digest HTTP corrente.Gets the current HTTP Digest credential.

IssuedToken

Utilizzare questa proprietà per specificare l'indirizzo e l'associazione dell'endpoint da utilizzare per contattare il servizio locale del token di sicurezza.Use this property to specify the endpoint address and binding to use when contacting your local Security Token Service. Queste informazioni vengono utilizzate quando per un servizio è necessaria l'autenticazione tramite un token emesso, ma i criteri del servizio (rappresentati come associazione sul client) non specificano in modo esplicito come e dove ottenere il token.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

Controlla le credenziali che un nodo peer utilizza per autenticare se stesso agli altri nodi della rete, oltre che le impostazioni di autenticazione utilizzate da un nodo peer per autenticare altri nodi peer.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

Ottiene o imposta il gestore di token di sicurezza per le credenziali client.Gets or sets the security token handler for the client credential.

ServiceCertificate

Ottiene un oggetto utilizzato per specificare il certificato X.509 di un servizio.Gets an object used to specify a service's X.509 certificate.

SupportInteractive

Ottiene o imposta un valore che indica se il sistema è autorizzato a richiedere all'utente in modo interattivo le credenziali quando è necessario.Gets or sets a value that indicates whether the system is allowed to interactively prompt the user for credentials when necessary. Potrebbe, ad esempio, essere utile impostarlo su false in scenari di livello intermedio.For example, setting it to false might be desired in middle-tier scenarios.

UseIdentityConfiguration

Ottiene o imposta se le credenziali client utilizzano la configurazione di identità.Gets or sets whether the client credentials uses identity configuration.

UserName

Ottiene un oggetto credenziale utilizzabile per impostare il nome utente e la password utilizzati dal client per l'autenticazione al servizio.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

Ottiene un oggetto utilizzato per controllare le credenziali Windows utilizzate dal client per l'autenticazione al servizio.Gets an object used to control the Windows credential that the client uses to authenticate itself to the service.

Metodi

ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

Applica il comportamento client specificato all'endpoint.Applies the specified client behavior to the endpoint.

Clone()

Crea una nuova copia di questa istanza della classe ClientCredentials.Creates a new copy of this ClientCredentials instance.

CloneCore()

Crea una nuova copia di questa istanza della classe ClientCredentials.Creates a new copy of this ClientCredentials instance.

CreateSecurityTokenManager()

Crea un gestore dei token di sicurezza per questa istanza.Creates a security token manager for this instance. Questo metodo viene raramente chiamato in modo esplicito; lo si utilizza principalmente in scenari di estensibilità e viene chiamato dal sistema stesso.This method is rarely called explicitly; it is primarily used in extensibility scenarios and is called by the system itself.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)

Genera e restituisce un token di sicurezza utilizzando il sistema CardSpaceCardSpace nonché la catena di criteri e il serializzatore di token specificati.Generates and returns a security token using the CardSpaceCardSpace system and the specified policy chain and token serializer.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

Aggiunge questa istanza della classe a una raccolta di parametri di associazione.Adds this instance of this class to a binding parameter collection.

IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

Implementa una modifica o un'estensione del servizio all'interno di un endpoint.Implements a modification or extension of the service across an endpoint.

IEndpointBehavior.Validate(ServiceEndpoint)

Riservato per usi futuri.Reserved for future use.

Si applica a