ClientCredentials Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Description

Bütünleştirilmiş Kod:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Kaynak:

ClientCredentials.cs

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::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

Devralma

Object

SecurityCredentialsManager

ClientCredentials

Türetilmiş

System.ServiceModel.Federation.WSTrustChannelClientCredentials

Uygulamalar

IEndpointBehavior

Ö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.
ServiceCertificate	Hizmetin X.509 sertifikasını belirtmek için kullanılan nesneyi alır.
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)
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.