ClientCredentials Třída

Definice

Obor názvů:

System.ServiceModel.Description

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v8.0.0

Zdroj:

ClientCredentials.cs

Umožňuje uživateli nakonfigurovat přihlašovací údaje klienta a služby a nastavení ověřování přihlašovacích údajů služby pro použití na straně klienta komunikace.

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

Dědičnost

Object

SecurityCredentialsManager

ClientCredentials

Odvozené

System.ServiceModel.Federation.WSTrustChannelClientCredentials

Implementuje

IEndpointBehavior

Příklady

Následující ukázka kódu ukazuje, jak přepsat tuto třídu a implementovat vlastní přihlašovací údaje klienta, který obsahuje vlastní správce tokenů zabezpečení.

Důležité

Je důležité si uvědomit, že CreateSecurityTokenManager metoda je přepsána tak, aby se vytvořil vlastní správce tokenů zabezpečení. Správce tokenů zabezpečení odvozený z ClientCredentialsSecurityTokenManager. Musí vrátit vlastního zprostředkovatele tokenu zabezpečení odvozeného z SecurityTokenProvider, aby se vytvořil skutečný token zabezpečení. Pokud při vytváření tokenů zabezpečení nedodržujete tento vzor, bude vaše aplikace ohrožena útoky na zabezpečení, konkrétně zvýšením oprávnění. Tento vzor kódování zajišťuje použití správných přihlašovacích údajů při ukládání kanálů do mezipaměti.

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

Poznámky

K objektu ClientCredentialsClientCredentials se přistupuje prostřednictvím vlastnosti ClientBase<TChannel> třídy .

Objekt ClientCredentials se přidá do Behaviors kolekce. Vlastnost ClientCredentials je Fasáda (dobře známý vzor návrhu) nad položkou v této kolekci. Mnoho vlastností v této třídě vrací objekty, které se skládají hlavně z vlastností. Tyto objekty lze použít ke konfiguraci: jakmile objekt použijete get , můžete ho použít k set vlastnostem voláním jeho členů.

Konstruktory

ClientCredentials()	Inicializuje novou instanci ClientCredentials třídy .
ClientCredentials(ClientCredentials)	Toto je konstruktor kopírování.

Vlastnosti

ClientCertificate	Získá objekt, který můžete použít k poskytnutí certifikátu X.509, který klient používá k ověření do služby.
HttpDigest	Získá aktuální přihlašovací údaje HTTP Digest.
ServiceCertificate	Získá objekt použitý k určení certifikátu X.509 služby.
UserName	Získá objekt přihlašovacích údajů, který můžete použít k nastavení uživatelského jména a hesla, které klient používá k ověření ve službě.
Windows	Získá objekt sloužící k řízení přihlašovacích údajů systému Windows, které klient používá k ověření do služby.

Metody

ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Použije zadané chování klienta na koncový bod.
Clone()	Vytvoří novou kopii této ClientCredentials instance.
CloneCore()	Vytvoří novou kopii této ClientCredentials instance.
CreateSecurityTokenManager()	Vytvoří správce tokenů zabezpečení pro tuto instanci. Tato metoda je zřídka volána explicitně; primárně se používá ve scénářích rozšiřitelnosti a je volána samotným systémem.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Přidá tuto instanci této třídy do kolekce parametrů vazby.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implementuje úpravu nebo rozšíření služby v rámci koncového bodu.
IEndpointBehavior.Validate(ServiceEndpoint)	Vyhrazeno pro budoucí použití.