ClientCredentials Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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 |
| 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. |