ClientCredentials Osztály

Definíció

Névtér:

System.ServiceModel.Description

Szerelvények:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Csomag:

System.ServiceModel.Primitives v10.0.652802

Forrás:

ClientCredentials.cs

Lehetővé teszi, hogy a felhasználó konfigurálja az ügyfél- és szolgáltatáshitelesítési hitelesítő adatokat, valamint a szolgáltatás hitelesítő adatait a kommunikáció ügyféloldalán való használatra.

public ref class ClientCredentials : System::ServiceModel::Security::SecurityCredentialsManager, System::ServiceModel::Description::IEndpointBehavior

public class ClientCredentials : System.ServiceModel.Security.SecurityCredentialsManager, System.ServiceModel.Description.IEndpointBehavior

type ClientCredentials = class
    inherit SecurityCredentialsManager
    interface IEndpointBehavior

Public Class ClientCredentials
Inherits SecurityCredentialsManager
Implements IEndpointBehavior

Öröklődés

Object

SecurityCredentialsManager

ClientCredentials

Származtatott

System.ServiceModel.Federation.WSTrustChannelClientCredentials

Megvalósítás

IEndpointBehavior

Példák

Az alábbi kódminta bemutatja, hogyan bírálhatja felül ezt az osztályt, és hogyan valósíthatja meg saját egyéni ügyfél-hitelesítő adatait, amelyek egyéni biztonsági jogkivonat-kezelőt tartalmaznak.

Important

Fontos megjegyezni, hogy a CreateSecurityTokenManager metódus felül van írva egy egyéni biztonsági jogkivonat-kezelő létrehozásához. A biztonsági jogkivonat-kezelő, amely a következőből ClientCredentialsSecurityTokenManagerszármazik: . A tényleges biztonsági jogkivonat létrehozásához egy egyéni biztonsági jogkivonat-szolgáltatót kell visszaadnia, amelyből származik SecurityTokenProvider. Ha nem követi ezt a mintát a biztonsági jogkivonatok létrehozásához, az alkalmazás biztonsági támadások, különösen a jogosultságok emelése veszélyben lesz. Ez a kódolási minta biztosítja, hogy a csatornagyárak gyorsítótárazásakor a rendszer a megfelelő hitelesítő adatokat használja.

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

Megjegyzések

Ez ClientCredentials az osztály tulajdonságán ClientCredentials keresztül ClientBase<TChannel> érhető el.

A rendszer hozzáad egy ClientCredentials objektumot a Behaviors gyűjteményhez. A ClientCredentials tulajdonság egy homlokzat (egy jól ismert tervezési minta) a gyűjtemény egy bejegyzése felett. Az osztály számos tulajdonsága elsősorban tulajdonságokból álló objektumokat ad vissza. Ezek az objektumok konfiguráláshoz használhatók: miután get az objektumot használta, a tagok meghívásával tulajdonságokra set használhatja őket.

Konstruktorok

Name	Description
ClientCredentials()	Inicializálja a ClientCredentials osztály új példányát.
ClientCredentials(ClientCredentials)	Ez egy másolat konstruktor.

Tulajdonságok

Name	Description
ClientCertificate	Lekéri azt az objektumot, amellyel megadhatja az X.509-tanúsítványt, amelyet az ügyfél a szolgáltatás hitelesítéséhez használ.
HttpDigest	Lekéri az aktuális HTTP Digest hitelesítő adatokat.
ServiceCertificate	Lekéri a szolgáltatás X.509-tanúsítványának megadásához használt objektumot.
UserName	Lekéri az ügyfél által a szolgáltatásban való hitelesítéshez használt felhasználónév és jelszó beállításához használható hitelesítőadat-objektumot.
Windows	Lekéri az ügyfél által a szolgáltatásban való hitelesítéshez használt Windows hitelesítő adatok vezérléséhez használt objektumot.

Metódusok

Name	Description
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Alkalmazza a megadott ügyfél viselkedését a végpontra.
Clone()	Létrehozza a ClientCredentials példány új példányát.
CloneCore()	Létrehozza a ClientCredentials példány új példányát.
CreateSecurityTokenManager()	Létrehoz egy biztonsági jogkivonat-kezelőt ehhez a példányhoz. Ezt a módszert ritkán nevezik explicit módon; elsősorban bővíthetőségi forgatókönyvekben használják, és magát a rendszer hívja meg.

Explicit interfész-implementációk

Name	Description
IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Hozzáadja ennek az osztálynak ezt a példányát egy kötésparaméter-gyűjteményhez.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implementálja a szolgáltatás módosítását vagy kiterjesztését egy végponton keresztül.
IEndpointBehavior.Validate(ServiceEndpoint)	Jövőbeli használatra fenntartva.