ClientCredentials Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Description

Bütünleştirilmiş Kodlar:

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

Paket:

System.ServiceModel.Primitives v10.0.652802

Kaynak:

ClientCredentials.cs

Kullanıcının istemci ve hizmet kimlik bilgilerinin yanı sıra iletişimin istemci tarafında kullanılmak üzere hizmet kimlik bilgisi kimlik doğrulaması 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ın nasıl geçersiz kılındığını ve özel bir güvenlik belirteci yöneticisi içeren kendi özel istemci kimlik bilgilerinizin nasıl uygulandığını 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üretilen ö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 ClientCredentials aracılığıyla ClientBase<TChannel> erişilir.

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

Oluşturucular

Name	Description
ClientCredentials()	ClientCredentials sınıfının yeni bir örneğini başlatır.
ClientCredentials(ClientCredentials)	Bu bir kopya oluşturucudur.

Özellikler

Name	Description
ClientCertificate	İstemcinin hizmette kimlik doğrulaması yapmak için kullandığı X.509 sertifikasını sağlamak için kullanabileceğiniz bir nesne 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

Name	Description
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.

Belirtik Arabirim Kullanımları

Name	Description
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)	Gelecekte kullanım için ayrılmıştır.