ClientCredentials Kelas

Definisi

Ruang nama:

System.ServiceModel.Description

Rakitan:

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

Paket:

System.ServiceModel.Primitives v10.0.652802

Sumber:

ClientCredentials.cs

Memungkinkan pengguna mengonfigurasi kredensial klien dan layanan serta pengaturan autentikasi kredensial layanan untuk digunakan di sisi komunikasi klien.

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

Warisan

Object

SecurityCredentialsManager

ClientCredentials

Turunan

System.ServiceModel.Federation.WSTrustChannelClientCredentials

Penerapan

IEndpointBehavior

Contoh

Sampel kode berikut menunjukkan cara mengambil alih kelas ini dan menerapkan kredensial klien kustom Anda sendiri yang menyertakan manajer token keamanan kustom.

Penting

Penting untuk dicatat bahwa CreateSecurityTokenManager metode ini ditimpa untuk membuat manajer token keamanan kustom. Manajer token keamanan, berasal dari ClientCredentialsSecurityTokenManager. harus mengembalikan penyedia token keamanan kustom, berasal dari SecurityTokenProvider, untuk membuat token keamanan aktual. Jika Anda tidak mengikuti pola ini untuk membuat token keamanan, aplikasi Anda akan berisiko untuk serangan keamanan, khususnya peningkatan hak istimewa. Pola pengkodian ini memastikan bahwa kredensial yang benar digunakan saat pabrik saluran di-cache.

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

Keterangan

ClientCredentials diakses melalui ClientCredentials properti ClientBase<TChannel> kelas .

Objek ClientCredentials ditambahkan ke Behaviors koleksi. Properti ClientCredentials adalah Facade (pola desain terkenal) melalui entri dalam koleksi tersebut. Banyak properti di kelas ini mengembalikan objek yang terutama terdiri dari properti. Objek ini dapat digunakan untuk konfigurasi: setelah Objek get digunakan, Anda dapat menggunakannya ke set properti dengan memanggil anggotanya.

Konstruktor

Nama	Deskripsi
ClientCredentials()	Menginisialisasi instans baru dari kelas ClientCredentials.
ClientCredentials(ClientCredentials)	Ini adalah konstruktor salinan.

Properti

Nama	Deskripsi
ClientCertificate	Mendapatkan objek yang dapat Anda gunakan untuk menyediakan sertifikat X.509 yang digunakan klien untuk mengautentikasi ke layanan.
HttpDigest	Mendapatkan kredensial HTTP Digest saat ini.
ServiceCertificate	Mendapatkan objek yang digunakan untuk menentukan sertifikat X.509 layanan.
UserName	Mendapatkan objek kredensial yang dapat Anda gunakan untuk mengatur nama pengguna dan kata sandi yang digunakan klien untuk mengautentikasi dirinya ke layanan.
Windows	Mendapatkan objek yang digunakan untuk mengontrol kredensial Windows yang digunakan klien untuk mengautentikasi dirinya ke layanan.

Metode

Nama	Deskripsi
ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Menerapkan perilaku klien yang ditentukan ke titik akhir.
Clone()	Membuat salinan baru instans ini ClientCredentials .
CloneCore()	Membuat salinan baru instans ini ClientCredentials .
CreateSecurityTokenManager()	Membuat manajer token keamanan untuk instans ini. Metode ini jarang disebut secara eksplisit; ini terutama digunakan dalam skenario ekstensibilitas dan dipanggil oleh sistem itu sendiri.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Menambahkan instans kelas ini ke koleksi parameter pengikatan.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Menerapkan modifikasi atau ekstensi layanan di seluruh titik akhir.
IEndpointBehavior.Validate(ServiceEndpoint)	Disiapkan untuk penggunaan masa mendatang.