Sdílet prostřednictvím


ClientCredentials Třída

Definice

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::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
Dědičnost
ClientCredentials
Dědičnost
Odvozené
Implementuje

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.

IssuedToken

Pomocí této vlastnosti můžete zadat adresu koncového bodu a vazbu, která se má použít při kontaktování místní služby tokenů zabezpečení. Tyto informace se používají, když služba vyžaduje ověření pomocí vydaného tokenu, ale zásady služby (reprezentované jako vazba na klientovi) explicitně neudávají, jak a kde se má vystavený token získat.

Peer

Řídí přihlašovací údaje, které partnerský uzel používá k ověření v jiných uzlech v síti, a také nastavení ověřování, které partnerský uzel používá k ověřování ostatních partnerských uzlů.

SecurityTokenHandlerCollectionManager

Získá nebo nastaví obslužnou rutinu tokenu zabezpečení pro přihlašovací údaje klienta.

ServiceCertificate

Získá objekt použitý k určení certifikátu X.509 služby.

SupportInteractive

Získá nebo nastaví hodnotu, která označuje, zda je systému povoleno interaktivně vyzvat uživatele k zadání přihlašovacích údajů v případě potřeby. Například jeho nastavení na false může být žádoucí ve scénářích střední vrstvy.

UseIdentityConfiguration

Získá nebo nastaví, zda přihlašovací údaje klienta používá konfiguraci identity.

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)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)

Generuje a vrací token zabezpečení pomocí systému CardSpace a zadaného řetězce zásad a serializátoru tokenů.

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í.

Platí pro