X509ClientCertificateAuthentication Kelas

Definisi

Ruang nama:

System.ServiceModel.Security

Rakitan:

System.ServiceModel.dll

Menentukan properti autentikasi untuk memvalidasi sertifikat klien.

public ref class X509ClientCertificateAuthentication

public class X509ClientCertificateAuthentication

type X509ClientCertificateAuthentication = class

Public Class X509ClientCertificateAuthentication

Warisan

Object

X509ClientCertificateAuthentication

Contoh

Kode berikut menunjukkan cara mengatur properti ini.

// Create a service host.
Uri httpUri = new Uri("http://localhost/Calculator");
ServiceHost sh = new ServiceHost(typeof(Calculator), httpUri);

// Get a reference to the authentication object.
X509ClientCertificateAuthentication myAuthProperties =
    sh.Credentials.ClientCertificate.Authentication;

// Configure peer trust.
myAuthProperties.CertificateValidationMode =
    X509CertificateValidationMode.PeerTrust;
// Configure chain trust.
myAuthProperties.CertificateValidationMode =
    X509CertificateValidationMode.ChainTrust;
// Configure custom certificate validation.
myAuthProperties.CertificateValidationMode =
    X509CertificateValidationMode.Custom;

// Specify a custom certificate validator (not shown here) that inherits
// from the X509CertificateValidator class.
// creds.ClientCertificate.Authentication.CustomCertificateValidator =
//    new MyCertificateValidator();

' Create a service host.
Dim httpUri As New Uri("http://localhost/Calculator")
Dim sh As New ServiceHost(GetType(Calculator), httpUri)

' Get a reference to the authentication object.
Dim myAuthProperties As X509ClientCertificateAuthentication = _
sh.Credentials.ClientCertificate.Authentication

' Configure peer trust.
myAuthProperties.CertificateValidationMode = X509CertificateValidationMode.PeerTrust
' Configure chain trust.
myAuthProperties.CertificateValidationMode = X509CertificateValidationMode.ChainTrust
' Configure custom certificate validation.
myAuthProperties.CertificateValidationMode = X509CertificateValidationMode.Custom
' Specify a custom certificate validator (not shown here) that inherits 
' from the X509CertificateValidator class. 
' creds.ClientCertificate.Authentication.CustomCertificateValidator = _
'    new MyCertificateValidator()

Properti juga dapat diatur dalam file konfigurasi.

<serviceCredentials>
  <clientCertificate>
     <authentication certificateValidationMode='ChainTrust' />
  </clientCertificate>
</serviceCredentials>

Keterangan

CertificateValidationMode Jika diatur ke Custom, maka Anda harus membuat validator sertifikat kustom yang mewarisi dari X509CertificateValidator kelas . Untuk informasi selengkapnya, lihat Cara: Membuat Layanan yang Menggunakan Validator Sertifikat Kustom.

Properti

Nama	Deskripsi
CertificateValidationMode	Mendapatkan atau mengatur mode validasi sertifikat.
CustomCertificateValidator	Mendapatkan atau mengatur validator sertifikat klien kustom.
IncludeWindowsGroups	Mendapatkan atau menetapkan nilai yang menunjukkan apakah grup Windows disertakan dalam konteks otorisasi.
MapClientCertificateToWindowsAccount	Mendapatkan atau menetapkan nilai yang menunjukkan apakah sertifikat dipetakan ke akun Windows.
RevocationMode	Mendapatkan atau mengatur mode pencabutan sertifikat untuk validasi sertifikat ChainTrust dan PeerOrChainTrust X.509.
TrustedStoreLocation	Mendapatkan atau mengatur lokasi penyimpanan tepercaya di mana konteks rantai sertifikat klien divalidasi.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• X509CertificateValidator
• Cara: Membuat Layanan yang Menggunakan Validator Sertifikat Kustom
• Bekerja dengan Sertifikat