ClientCredentials Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel.Description

Zestaw:

System.ServiceModel.Primitives.dll

Zestaw:

System.ServiceModel.dll

Umożliwia użytkownikowi skonfigurowanie poświadczeń klienta i usługi, a także ustawień uwierzytelniania poświadczeń usługi do użycia po stronie klienta komunikacji.

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

Dziedziczenie

Object

ClientCredentials

Dziedziczenie

Object

SecurityCredentialsManager

ClientCredentials

Pochodne

System.ServiceModel.Federation.WSTrustChannelClientCredentials

Implementuje

IEndpointBehavior

Przykłady

Poniższy przykładowy kod pokazuje, jak zastąpić tę klasę i zaimplementować własne niestandardowe poświadczenia klienta, które zawierają niestandardowego menedżera tokenów zabezpieczających.

Ważne

Należy pamiętać, że CreateSecurityTokenManager metoda jest zastępowana w celu utworzenia niestandardowego menedżera tokenów zabezpieczających. Menedżer tokenów zabezpieczających pochodzący z ClientCredentialsSecurityTokenManager. Aby utworzyć rzeczywisty token zabezpieczający, należy zwrócić niestandardowego dostawcę tokenu zabezpieczającego pochodzącego z SecurityTokenProvidersystemu . Jeśli nie zastosujesz się do tego wzorca tworzenia tokenów zabezpieczających, aplikacja będzie zagrożona atakami na zabezpieczenia, a w szczególności podniesieniem uprawnień. Ten wzorzec kodowania zapewnia, że podczas buforowania fabryk kanałów są używane poprawne poświadczenia.

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

Uwagi

Dostęp ClientCredentials do obiektu ClientBase<TChannel> jest uzyskiwany za pośrednictwem ClientCredentials właściwości klasy .

Obiekt ClientCredentials jest dodawany do kolekcji Behaviors . Właściwość ClientCredentials jest fasadą (dobrze znanym wzorcem projektowym) nad wpisem w tej kolekcji. Wiele właściwości w tej klasie zwraca obiekty, które składają się głównie z właściwości. Te obiekty mogą służyć do konfiguracji: po utworzeniu get obiektu można go użyć do set właściwości, wywołując jego elementy członkowskie.

Konstruktory

ClientCredentials()	Inicjuje nowe wystąpienie klasy ClientCredentials.
ClientCredentials(ClientCredentials)	Jest to konstruktor kopiujący.

Właściwości

ClientCertificate	Pobiera obiekt, którego można użyć do udostępnienia certyfikatu X.509 używanego przez klienta do uwierzytelniania w usłudze.
HttpDigest	Pobiera bieżące poświadczenia skrótu HTTP.
IssuedToken	Użyj tej właściwości, aby określić adres punktu końcowego i powiązanie do użycia podczas kontaktowania się z lokalną usługą tokenu zabezpieczającego. Te informacje są używane, gdy usługa wymaga uwierzytelniania przy użyciu wystawionego tokenu, ale zasady usługi (reprezentowane jako powiązanie na kliencie) nie określają jawnie sposobu i miejsca uzyskania wystawionego tokenu.
Peer	Steruje poświadczeniami używanymi przez węzeł równorzędny do uwierzytelniania się w innych węzłach w siatce, a także ustawienia uwierzytelniania używane przez węzeł równorzędny do uwierzytelniania innych węzłów równorzędnych.
SecurityTokenHandlerCollectionManager	Pobiera lub ustawia procedurę obsługi tokenu zabezpieczającego dla poświadczeń klienta.
ServiceCertificate	Pobiera obiekt używany do określania certyfikatu X.509 usługi.
SupportInteractive	Pobiera lub ustawia wartość wskazującą, czy system może interaktywnie monitować użytkownika o poświadczenia w razie potrzeby. Na przykład ustawienie tego false ustawienia może być wymagane w scenariuszach warstwy środkowej.
UseIdentityConfiguration	Pobiera lub ustawia, czy poświadczenia klienta używają konfiguracji tożsamości.
UserName	Pobiera obiekt poświadczeń, którego można użyć do ustawienia nazwy użytkownika i hasła używanego przez klienta do uwierzytelniania się w usłudze.
Windows	Pobiera obiekt używany do kontrolowania poświadczeń Windows używanych przez klienta do uwierzytelniania się w usłudze.

Metody

ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Stosuje określone zachowanie klienta do punktu końcowego.
Clone()	Tworzy nową kopię tego ClientCredentials wystąpienia.
CloneCore()	Tworzy nową kopię tego ClientCredentials wystąpienia.
CreateSecurityTokenManager()	Tworzy menedżera tokenów zabezpieczających dla tego wystąpienia. Ta metoda jest rzadko wywoływana jawnie; Jest on używany głównie w scenariuszach rozszerzalności i jest wywoływany przez sam system.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)	Generuje i zwraca token zabezpieczający przy użyciu systemu CardSpace oraz określonego łańcucha zasad i serializatora tokenów.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Dodaje to wystąpienie tej klasy do kolekcji parametrów powiązania.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implementuje modyfikację lub rozszerzenie usługi w punkcie końcowym.
IEndpointBehavior.Validate(ServiceEndpoint)	Zarezerwowane do użytku w przyszłości.