ClientCredentials Klass

Definition

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 false önskat i scenarier på mellannivå.

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.

Gäller för