ClientCredentials Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Gör det möjligt för användaren att konfigurera klient- och tjänstautentiseringsuppgifter samt autentiseringsinställningar för tjänstautentiseringsuppgifter för användning på klientsidan av kommunikationen.
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
- Arv
-
ClientCredentials
- Arv
- Implementeringar
Exempel
Följande kodexempel visar hur du åsidosätter den här klassen och implementerar dina egna anpassade klientautentiseringsuppgifter som innehåller en anpassad säkerhetstokenhanterare.
Important
Observera att CreateSecurityTokenManager metoden åsidosätts för att skapa en anpassad säkerhetstokenhanterare. Säkerhetstokenhanteraren härledd från ClientCredentialsSecurityTokenManager. måste returnera en anpassad säkerhetstokenprovider, härledd från SecurityTokenProvider, för att skapa den faktiska säkerhetstoken. Om du inte följer det här mönstret för att skapa säkerhetstoken riskerar ditt program att utsättas för säkerhetsattacker, särskilt utökade privilegier. Det här kodningsmönstret säkerställer att rätt autentiseringsuppgifter används när kanalfabriker cachelagras.
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
Kommentarer
ClientCredentials Nås via ClientCredentials egenskapen för ClientBase<TChannel> klassen.
Ett ClientCredentials objekt läggs till i Behaviors samlingen. Egenskapen ClientCredentials är en fasad (ett välkänt designmönster) över en post i samlingen. Många egenskaper i den här klassen returnerar objekt som huvudsakligen består av egenskaper. Dessa objekt kan användas för konfiguration: när du get har objektet kan du använda det till egenskaper genom att set anropa dess medlemmar.
Konstruktorer
| Name | Description |
|---|---|
| ClientCredentials() |
Initierar en ny instans av ClientCredentials klassen. |
| ClientCredentials(ClientCredentials) |
Det här är en kopieringskonstruktor. |
Egenskaper
| Name | Description |
|---|---|
| ClientCertificate |
Hämtar ett objekt som du kan använda för att tillhandahålla X.509-certifikatet som klienten använder för att autentisera till tjänsten. |
| HttpDigest |
Hämtar den aktuella HTTP Digest-autentiseringsuppgiften. |
| IssuedToken |
Använd den här egenskapen för att ange den slutpunktsadress och bindning som ska användas när du kontaktar din lokala säkerhetstokentjänst. Den här informationen används när en tjänst kräver autentisering med en utfärdad token, men principen för tjänsten (representeras som en bindning på klienten) anger inte uttryckligen hur och var den utfärdade token ska hämtas. |
| Peer |
Styr de autentiseringsuppgifter som en peer-nod använder för att autentisera sig själv till andra noder i nätet, samt autentiseringsinställningar som en peer-nod använder för att autentisera andra peer-noder. |
| SecurityTokenHandlerCollectionManager |
Hämtar eller anger hanteraren för säkerhetstoken för klientens autentiseringsuppgifter. |
| ServiceCertificate |
Hämtar ett objekt som används för att ange en tjänsts X.509-certifikat. |
| SupportInteractive |
Hämtar eller anger ett värde som anger om systemet tillåts att interaktivt fråga användaren om autentiseringsuppgifter när det behövs. Du kan till exempel ange det som |
| UseIdentityConfiguration |
Hämtar eller anger om klientens autentiseringsuppgifter använder identitetskonfiguration. |
| UserName |
Hämtar ett autentiseringsobjekt som du kan använda för att ange användarnamnet och lösenordet som klienten använder för att autentisera sig själv till tjänsten. |
| Windows |
Hämtar ett objekt som används för att styra Windows autentiseringsuppgifter som klienten använder för att autentisera sig själv till tjänsten. |
Metoder
| Name | Description |
|---|---|
| ApplyClientBehavior(ServiceEndpoint, ClientRuntime) |
Tillämpar det angivna klientbeteendet på slutpunkten. |
| Clone() |
Skapar en ny kopia av den här ClientCredentials instansen. |
| CloneCore() |
Skapar en ny kopia av den här ClientCredentials instansen. |
| CreateSecurityTokenManager() |
Skapar en säkerhetstokenhanterare för den här instansen. Den här metoden kallas sällan explicit. Det används främst i utökningsscenarier och anropas av själva systemet. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer) |
Genererar och returnerar en säkerhetstoken med hjälp av CardSpace-systemet och den angivna principkedjan och token-serialiseraren. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection) |
Lägger till den här instansen av den här klassen i en bindningsparametersamling. |
| IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) |
Implementerar en ändring eller ett tillägg av tjänsten över en slutpunkt. |
| IEndpointBehavior.Validate(ServiceEndpoint) |
Reserverad för framtida användning. |