ClientCredentials Sınıf

Tanım

Kullanıcının hem istemci ve hizmet kimlik bilgilerini hem de iletişimin istemci tarafında kullanılmak üzere hizmet kimlik bilgileri kimlik doğrulama ayarlarını yapılandırmasına olanak tanır.

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
Devralma
ClientCredentials
Devralma
Türetilmiş
Uygulamalar

Örnekler

Aşağıdaki kod örneği, bu sınıfı geçersiz kılmayı ve özel bir güvenlik belirteci yöneticisi içeren kendi özel istemci kimlik bilgilerinizi uygulamayı gösterir.

Önemli

Özel bir güvenlik belirteci yöneticisi oluşturmak için yönteminin geçersiz kılındığını CreateSecurityTokenManager unutmayın. 'den ClientCredentialsSecurityTokenManagertüretilen güvenlik belirteci yöneticisi. , gerçek güvenlik belirtecini oluşturmak için ' den SecurityTokenProvidertüretilmiş özel bir güvenlik belirteci sağlayıcısı döndürmelidir. Güvenlik belirteçleri oluşturmak için bu deseni izlemezseniz, uygulamanız özellikle ayrıcalıkların yükseltilmesi gibi güvenlik saldırıları için risk altında olur. Bu kodlama düzeni, kanal fabrikaları önbelleğe alınırken doğru kimlik bilgilerinin kullanılmasını sağlar.

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

Açıklamalar

öğesine ClientCredentials sınıfının özelliği ClientBase<TChannel> aracılığıyla ClientCredentials erişilir.

ClientCredentials Koleksiyona Behaviors bir nesne eklenir. ClientCredentials özelliği, bu koleksiyondaki bir giriş üzerinde bir Cephedir (iyi bilinen bir tasarım deseni). Bu sınıftaki birçok özellik, çoğunlukla özelliklerden oluşan nesneleri döndürür. Bu nesneler yapılandırma için kullanılabilir: nesneyi aldıktan get sonra, üyelerini çağırarak özellikler için set kullanabilirsiniz.

Oluşturucular

ClientCredentials()

ClientCredentials sınıfının yeni bir örneğini başlatır.

ClientCredentials(ClientCredentials)

Bu bir kopya oluşturucudur.

Özellikler

ClientCertificate

İstemcinin hizmette kimlik doğrulaması yapmak için kullandığı X.509 sertifikasını sağlamak için kullanabileceğiniz bir nesnesi alır.

HttpDigest

Geçerli HTTP Özet kimlik bilgilerini alır.

IssuedToken

Yerel Güvenlik Belirteci Hizmetinizle iletişim kurarken kullanılacak uç nokta adresini ve bağlamayı belirtmek için bu özelliği kullanın. Bu bilgiler, bir hizmet verilen belirteç kullanılarak kimlik doğrulaması gerektirdiğinde kullanılır, ancak hizmet ilkesi (istemcide bağlama olarak temsil edilir) verilen belirtecin nasıl ve nereden alınacağını açıkça belirtmez.

Peer

Eş düğümlerin meshteki diğer düğümlerde kimlik doğrulaması yapmak için kullandığı kimlik bilgilerini ve eş düğümlerin diğer eş düğümlerin kimliğini doğrulamak için kullandığı kimlik doğrulama ayarlarını denetler.

SecurityTokenHandlerCollectionManager

İstemci kimlik bilgileri için güvenlik belirteci işleyicisini alır veya ayarlar.

ServiceCertificate

Hizmetin X.509 sertifikasını belirtmek için kullanılan nesneyi alır.

SupportInteractive

Sistemin gerektiğinde kullanıcıdan kimlik bilgilerini etkileşimli olarak istemesine izin verilip verilmeyeceğini belirten bir değer alır veya ayarlar. Örneğin, orta katman senaryolarında bunu false olarak ayarlamak istenebilir.

UseIdentityConfiguration

İstemci kimlik bilgilerinin kimlik yapılandırmasını kullanıp kullanmadığını alır veya ayarlar.

UserName

İstemcinin hizmette kimliğini doğrulamak için kullandığı kullanıcı adını ve parolayı ayarlamak için kullanabileceğiniz bir kimlik bilgisi nesnesi alır.

Windows

İstemcinin hizmette kimliğini doğrulamak için kullandığı Windows kimlik bilgilerini denetlemek için kullanılan bir nesneyi alır.

Yöntemler

ApplyClientBehavior(ServiceEndpoint, ClientRuntime)

Belirtilen istemci davranışını uç noktaya uygular.

Clone()

Bu ClientCredentials örneğin yeni bir kopyasını oluşturur.

CloneCore()

Bu ClientCredentials örneğin yeni bir kopyasını oluşturur.

CreateSecurityTokenManager()

Bu örnek için bir güvenlik belirteci yöneticisi oluşturur. Bu yöntem nadiren açıkça çağrılır; öncelikle genişletilebilirlik senaryolarında kullanılır ve sistemin kendisi tarafından çağrılır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetInfoCardSecurityToken(Boolean, CardSpacePolicyElement[], SecurityTokenSerializer)

CardSpace sistemini ve belirtilen ilke zincirini ve belirteç seri hale getiricisini kullanarak bir güvenlik belirteci oluşturur ve döndürür.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)

Bu sınıfın bu örneğini bağlama parametresi koleksiyonuna ekler.

IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)

Bir uç nokta genelinde hizmetin bir değişikliğini veya uzantısını uygular.

IEndpointBehavior.Validate(ServiceEndpoint)

Daha sonraki kullanımlar için ayrılmıştır.

Şunlara uygulanır