ClientCredentials Klas

Definitie

Hiermee kan de gebruiker client- en servicereferenties configureren, evenals verificatie-instellingen voor servicereferenties voor gebruik aan de clientzijde van de communicatie.

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
Overname
ClientCredentials
Overname
Implementeringen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u deze klasse overschrijft en uw eigen aangepaste clientreferenties implementeert die een aangepast beveiligingstokenbeheer bevatten.

Important

Het is belangrijk te weten dat de CreateSecurityTokenManager methode wordt overschreven om een aangepast beveiligingstokenbeheer te maken. De beveiligingstokenmanager, afgeleid van ClientCredentialsSecurityTokenManager. moet een aangepaste beveiligingstokenprovider retourneren, afgeleid van SecurityTokenProvider, om het werkelijke beveiligingstoken te maken. Als u dit patroon niet volgt voor het maken van beveiligingstokens, loopt uw toepassing het risico op beveiligingsaanvallen, met name uitbreiding van bevoegdheden. Dit coderingspatroon zorgt ervoor dat de juiste referenties worden gebruikt wanneer kanaalfactory's in de cache worden opgeslagen.

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

Opmerkingen

De ClientCredentials toegang wordt geopend via de ClientCredentials eigenschap van de ClientBase<TChannel> klasse.

Er wordt een ClientCredentials object toegevoegd aan de Behaviors verzameling. De ClientCredentials eigenschap is een gevel (een bekend ontwerppatroon) over een vermelding in die collectie. Veel eigenschappen in deze klasse retourneren objecten die voornamelijk bestaan uit eigenschappen. Deze objecten kunnen worden gebruikt voor configuratie: zodra u get het object hebt, kunt u het gebruiken voor eigenschappen door de leden aan te set roepen.

Constructors

Name Description
ClientCredentials()

Initialiseert een nieuw exemplaar van de ClientCredentials klasse.

ClientCredentials(ClientCredentials)

Dit is een kopieerconstructor.

Eigenschappen

Name Description
ClientCertificate

Hiermee haalt u een object op dat u kunt gebruiken om het X.509-certificaat op te geven dat de client gebruikt voor verificatie bij de service.

HttpDigest

Hiermee haalt u de huidige HTTP Digest-referentie op.

IssuedToken

Gebruik deze eigenschap om het eindpuntadres en de binding op te geven die u wilt gebruiken wanneer u contact op neemt met uw lokale beveiligingstokenservice. Deze informatie wordt gebruikt wanneer een service verificatie vereist met behulp van een uitgegeven token, maar het beleid van de service (vertegenwoordigd als een binding op de client) geeft niet expliciet op hoe en waar het uitgegeven token moet worden verkregen.

Peer

Hiermee bepaalt u de referenties die een peerknooppunt gebruikt om zichzelf te verifiëren bij andere knooppunten in de mesh, evenals verificatie-instellingen die een peerknooppunt gebruikt om andere peerknooppunten te verifiëren.

SecurityTokenHandlerCollectionManager

Hiermee haalt u de beveiligingstokenhandler voor de clientreferentie op of stelt u deze in.

ServiceCertificate

Hiermee wordt een object opgehaald dat wordt gebruikt om het X.509-certificaat van een service op te geven.

SupportInteractive

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het systeem de gebruiker indien nodig interactief om referenties mag vragen. U kunt deze bijvoorbeeld instellen false op scenario's in de middelste laag.

UseIdentityConfiguration

Hiermee haalt u op of stelt u in of de clientreferenties identiteitsconfiguratie gebruiken.

UserName

Hiermee haalt u een referentieobject op dat u kunt gebruiken om de gebruikersnaam en het wachtwoord in te stellen die de client gebruikt om zichzelf bij de service te verifiëren.

Windows

Hiermee haalt u een object op dat wordt gebruikt om de Windows referentie te bepalen die de client gebruikt om zichzelf bij de service te verifiëren.

Methoden

Name Description
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

Hiermee past u het opgegeven clientgedrag toe op het eindpunt.

Clone()

Hiermee maakt u een nieuwe kopie van dit ClientCredentials exemplaar.

CloneCore()

Hiermee maakt u een nieuwe kopie van dit ClientCredentials exemplaar.

CreateSecurityTokenManager()

Hiermee maakt u een beveiligingstokenbeheer voor dit exemplaar. Deze methode wordt zelden expliciet aangeroepen; het wordt voornamelijk gebruikt in uitbreidbaarheidsscenario's en wordt aangeroepen door het systeem zelf.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)

Hiermee genereert en retourneert u een beveiligingstoken met behulp van het CardSpace-systeem en de opgegeven beleidsketen en tokenserialisatie.

GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Expliciete interface-implementaties

Name Description
IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

Hiermee voegt u dit exemplaar van deze klasse toe aan een bindingparameterverzameling.

IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

Implementeert een wijziging of uitbreiding van de service in een eindpunt.

IEndpointBehavior.Validate(ServiceEndpoint)

Gereserveerd voor toekomstig gebruik.

Van toepassing op