ClientCredentials Třída

Definice

Obor názvů:

System.ServiceModel.Description

Sestavení:

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

Balíček:

System.ServiceModel.Primitives v10.0.652802

Zdroj:

ClientCredentials.cs

Umožňuje uživateli nakonfigurovat přihlašovací údaje klienta a služby a také 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 tuto třídu přepsat a implementovat vlastní přihlašovací údaje klienta, které obsahují vlastního správce tokenů zabezpečení.

Důležité

Je důležité si uvědomit, že CreateSecurityTokenManager metoda je přepsána k vytvoření vlastního 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, k vytvoření skutečného tokenu zabezpečení. Pokud tento model nepoužíváte při vytváření tokenů zabezpečení, bude vaše aplikace ohrožena útoky na zabezpečení, konkrétně zvýšení oprávnění. Tento vzor kódování zajišťuje, že se při ukládání továren kanálů do mezipaměti použijí správné přihlašovací údaje.

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

Tato ClientCredentials vlastnost je přístupná prostřednictvím ClientCredentials vlastnosti ClientBase<TChannel> třídy.

Objekt ClientCredentials se přidá do Behaviors kolekce. Vlastnost ClientCredentials je fasáda (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

Name	Description
ClientCredentials()	Inicializuje novou instanci ClientCredentials třídy.
ClientCredentials(ClientCredentials)	Jedná se o konstruktor kopírování.

Vlastnosti

Name	Description
ClientCertificate	Získá objekt, který můžete použít k poskytnutí certifikátu X.509, který klient používá k ověření ve službě.
HttpDigest	Získá aktuální přihlašovací údaje protokolu 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 použitý k řízení přihlašovacích údajů systému Windows, které klient používá k ověření ve službě.

Metody

Name	Description
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 se zřídka nazývá explicitně; primárně se používá ve scénářích rozšiřitelnosti a volá se samotným systémem.

Explicitní implementace rozhraní

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