ClientCredentials Klasse

Definition

Namespace:

System.ServiceModel.Description

Assemblys:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v10.0.652802

Quelle:

ClientCredentials.cs

Ermöglicht es dem Benutzer, Client- und Dienstanmeldeinformationen sowie Dienstanmeldeinformationen für die Verwendung auf der Clientseite der Kommunikation zu konfigurieren.

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

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

type ClientCredentials = class
    inherit SecurityCredentialsManager
    interface IEndpointBehavior

Public Class ClientCredentials
Inherits SecurityCredentialsManager
Implements IEndpointBehavior

Vererbung

Object

SecurityCredentialsManager

ClientCredentials

Abgeleitet

System.ServiceModel.Federation.WSTrustChannelClientCredentials

Implementiert

IEndpointBehavior

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie diese Klasse außer Kraft setzen und eigene benutzerdefinierte Clientanmeldeinformationen implementieren, die einen benutzerdefinierten Sicherheitstoken-Manager enthalten.

Von Bedeutung

Es ist wichtig zu beachten, dass die CreateSecurityTokenManager Methode überschrieben wird, um einen benutzerdefinierten Sicherheitstoken-Manager zu erstellen. Der Sicherheitstoken-Manager, abgeleitet von ClientCredentialsSecurityTokenManager. muss einen benutzerdefinierten Sicherheitstokenanbieter zurückgeben, der von SecurityTokenProviderdem abgeleitet wird, um das tatsächliche Sicherheitstoken zu erstellen. Wenn Sie diesem Muster zum Erstellen von Sicherheitstoken nicht folgen, besteht Ihre Anwendung gefahr für Sicherheitsangriffe, insbesondere die Erhöhung von Berechtigungen. Dieses Codierungsmuster stellt sicher, dass die richtigen Anmeldeinformationen verwendet werden, wenn Kanalfabriken zwischengespeichert werden.

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

Hinweise

Der ClientCredentials Zugriff erfolgt über die ClientCredentials Eigenschaft der ClientBase<TChannel> Klasse.

Der Auflistung wird ein ClientCredentials Objekt hinzugefügt Behaviors . Die ClientCredentials Eigenschaft ist ein Fassadenmuster (ein bekanntes Designmuster) über einen Eintrag in dieser Sammlung. Viele Eigenschaften in dieser Klasse geben Objekte zurück, die hauptsächlich aus Eigenschaften bestehen. Diese Objekte können für die Konfiguration verwendet werden: Nachdem Sie get das Objekt erstellt haben, können Sie es für set Eigenschaften verwenden, indem Sie dessen Member aufrufen.

Konstruktoren

Name	Beschreibung
ClientCredentials()	Initialisiert eine neue Instanz der ClientCredentials-Klasse.
ClientCredentials(ClientCredentials)	Dies ist ein Kopierkonstruktor.

Eigenschaften

Name	Beschreibung
ClientCertificate	Ruft ein Objekt ab, das Sie verwenden können, um das X.509-Zertifikat bereitzustellen, das der Client für die Authentifizierung beim Dienst verwendet.
HttpDigest	Ruft die aktuellen HTTP Digest-Anmeldeinformationen ab.
ServiceCertificate	Ruft ein Objekt ab, das zum Angeben des X.509-Zertifikats eines Diensts verwendet wird.
UserName	Ruft ein Anmeldeinformationsobjekt ab, mit dem Sie den Benutzernamen und das Kennwort festlegen können, den der Client zum Authentifizieren beim Dienst verwendet.
Windows	Ruft ein Objekt ab, das zum Steuern der Windows-Anmeldeinformationen verwendet wird, die der Client zum Authentifizieren für den Dienst verwendet.

Methoden

Name	Beschreibung
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Wendet das angegebene Clientverhalten auf den Endpunkt an.
Clone()	Erstellt eine neue Kopie dieser ClientCredentials Instanz.
CloneCore()	Erstellt eine neue Kopie dieser ClientCredentials Instanz.
CreateSecurityTokenManager()	Erstellt einen Sicherheitstoken-Manager für diese Instanz. Diese Methode wird selten explizit aufgerufen. sie wird in erster Linie in Erweiterungsszenarien verwendet und vom System selbst aufgerufen.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Fügt diese Instanz dieser Klasse einer Bindungsparameterauflistung hinzu.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implementiert eine Änderung oder Erweiterung des Diensts über einen Endpunkt hinweg.
IEndpointBehavior.Validate(ServiceEndpoint)	Reserviert für zukünftige Verwendung.