ClientCredentials ClientCredentials ClientCredentials ClientCredentials Class

Definition

Ermöglicht es dem Benutzer, die Client- und Dienstanmeldeinformationen sowie die auf der Clientseite der Kommunikation zu verwendenden Authentifizierungseinstellungen für die Dienstanmeldeinformationen zu konfigurieren.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
Vererbung
ClientCredentialsClientCredentialsClientCredentialsClientCredentials
Implementiert

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie diese Klasse überschreiben und Ihre eigenen benutzerdefinierten Clientanmeldeinformationen mit einem benutzerdefinierten Clientsicherheitstoken-Manager implementieren.The following code sample shows how to override this class and implement your own custom client credentials that includes a custom security token manager.

Wichtig

Wichtig: Beachten Sie, dass die CreateSecurityTokenManager-Methode überschrieben wird, um einen benutzerdefinierten Sicherheitstokenmanager zu erstellen.It is important to note that the CreateSecurityTokenManager method is overridden to create a custom security token manager. Der vom ClientCredentialsSecurityTokenManager abgeleitete SicherheitstokenmanagerThe security token manager, derived from ClientCredentialsSecurityTokenManager. muss einen benutzerdefinierten Sicherheitstokenanbieter zurückgeben, der vom SecurityTokenProvider abgeleitet wurde, um das eigentliche Sicherheitstoken zu erstellen.must return a custom security token provider, derived from SecurityTokenProvider, to create the actual security token. Wenn Sie diesem Muster zum Erstellen von Sicherheitstokens nicht folgen, läuft die Anwendung Gefahr, Sicherheitsangriffen (insbesondere Rechteerweiterungen) ausgesetzt zu sein.If you do not follow this pattern for creating security tokens, your application will be at risk for security attacks, specifically elevation of privileges. Dieses Codierungsmuster stellt sicher, dass die richtigen Anmeldeinformationen verwendet werden, wenn Channelfactorys zwischengespeichert werden.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

Hinweise

Der Zugriff auf die ClientCredentials erfolgt über die ClientCredentials-Eigenschaft der ClientBase<TChannel>-Klasse.The ClientCredentials is accessed through the ClientCredentials property of the ClientBase<TChannel> class.

Der ClientCredentials-Auflistung wird ein Behaviors-Objekt hinzugefügt.A ClientCredentials object is added to the Behaviors collection. Die ClientCredentials -Eigenschaft ist eine Fassade (ein bekanntes Entwurfsmuster) über einen Eintrag in der Auflistung.The ClientCredentials property is a Façade (a well-known design pattern) over an entry in that collection. Viele Eigenschaften in diesen Klassen geben Objekte zurück, die hauptsächlich aus Eigenschaften bestehen.Many properties in this class return objects that consist mainly of properties. Diese Objekte können für die Konfiguration verwendet werden: Nach dem get des Objekts können Sie es durch Aufrufen seiner Member zum set von Eigenschaften verwenden.These objects can be used for configuration: once you get the object, you can use it to set properties by calling its members.

Konstruktoren

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

Initialisiert eine neue Instanz der ClientCredentials-Klasse.Initializes a new instance of the ClientCredentials class.

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

Dies ist ein Kopierkonstruktor.This is a copy constructor.

Eigenschaften

ClientCertificate ClientCertificate ClientCertificate ClientCertificate

Ruft ein Objekt ab, mit dem Sie das vom Client für die Authentifizierung des Diensts verwendete X.509-Zertifikat bereitstellen können.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

Ruft die aktuellen HTTP-Hashwertanmeldeinformationen ab.Gets the current HTTP Digest credential.

IssuedToken IssuedToken IssuedToken IssuedToken

Geben Sie mithilfe dieser Eigenschaft die Endpunktadresse und die Bindung an, die beim Kontaktieren des lokalen Sicherheitstokendiensts verwendet werden sollen.Use this property to specify the endpoint address and binding to use when contacting your local Security Token Service. Diese Informationen werden verwendet, wenn ein Dienst die Authentifizierung mit einem ausgestellten Token erfordert. In der Richtlinie des Diensts (durch eine Bindung auf dem Client dargestellt) ist jedoch nicht explizit angegeben, wie und wo das ausgestellte Token abgerufen werden kann.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

Steuert die Anmeldeinformationen, mit denen sich ein Peerknoten gegenüber anderen Knoten im Netz authentifiziert, sowie die Authentifizierungseinstellungen, mit denen ein Peerknoten andere Peerknoten authentifiziert.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

Ruft den Sicherheitstokenhandler für die Clientanmeldeinformationen ab oder legt diesen fest.Gets or sets the security token handler for the client credential.

ServiceCertificate ServiceCertificate ServiceCertificate ServiceCertificate

Ruft ein Objekt ab, mit dem das X.509-Zertifikat eines Diensts angegeben wird.Gets an object used to specify a service's X.509 certificate.

SupportInteractive SupportInteractive SupportInteractive SupportInteractive

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das System den Benutzer ggf. interaktiv zur Eingabe von Anmeldeinformationen auffordern darf.Gets or sets a value that indicates whether the system is allowed to interactively prompt the user for credentials when necessary. Bei einem Szenario der mittleren Ebene könnte es z. B. wünschenswert sein, den Wert auf false festzulegen.For example, setting it to false might be desired in middle-tier scenarios.

UseIdentityConfiguration UseIdentityConfiguration UseIdentityConfiguration UseIdentityConfiguration

Ruft ab oder legt fest, ob die Clientanmeldeinformationen die Identitätskonfiguration verwenden.Gets or sets whether the client credentials uses identity configuration.

UserName UserName UserName UserName

Ruft ein Anmeldeinformationsobjekt ab, mit dem Sie den Benutzernamen und das Kennwort festlegen können, die der Client verwendet, um sich dem Dienst gegenüber zu authentifizieren.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

Ruft ein Objekt zur Steuerung der Windows-Anmeldeinformationen ab, die der Client verwendet, um sich dem Dienst gegenüber zu authentifizieren.Gets an object used to control the Windows credential that the client uses to authenticate itself to the service.

Methoden

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

Wendet das angegebene Clientverhalten auf den Endpunkt an.Applies the specified client behavior to the endpoint.

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

Erstellt eine neue Kopie dieser ClientCredentials-Instanz.Creates a new copy of this ClientCredentials instance.

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

Erstellt eine neue Kopie dieser ClientCredentials-Instanz.Creates a new copy of this ClientCredentials instance.

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

Erstellt einen Sicherheitstoken-Manager für diese Instanz.Creates a security token manager for this instance. Diese Methode wird nur selten explizit aufgerufen. In der Regel wird sie in Szenarien zur Erweiterbarkeit verwendet und vom System selbst aufgerufen.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)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.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)

Generiert mit dem CardSpaceCardSpace-System, der angegebenen Richtlinienkette und dem Tokenserialisierungsprogramm ein Sicherheitstoken und gibt es zurück.Generates and returns a security token using the CardSpaceCardSpace system and the specified policy chain and token serializer.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

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

Fügt diese Instanz dieser Klasse einer Bindungsparameterauflistung hinzu.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)

Implementiert eine Änderung oder eine Erweiterung des Diensts in einem Endpunkt.Implements a modification or extension of the service across an endpoint.

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

Für zukünftige Verwendung reserviert.Reserved for future use.

Gilt für: