Claim Kelas

Definisi

Ruang nama:

System.Security.Claims

Rakitan:

System.Security.Claims.dll

Sumber:

Claim.cs

Mewakili klaim.

public ref class Claim

public class Claim

type Claim = class

Public Class Claim

Warisan

Object

Claim

Contoh

Contoh berikut mengekstrak klaim yang terkait dengan pengguna terautentikasi yang melakukan permintaan HTTP dan menulisnya dalam respons HTTP. Pengguna saat ini dibaca dari HttpContext sebagai ClaimsPrincipal dan klaim dibaca darinya. Klaim kemudian ditulis ke HttpResponse objek .

ClaimsPrincipal principal = HttpContext.Current.User as ClaimsPrincipal;  
if (null != principal)  
{  
   foreach (Claim claim in principal.Claims)  
   {  
      Response.Write("CLAIM TYPE: " + claim.Type + "; CLAIM VALUE: " + claim.Value + "</br>");  
   }  

}  

Keterangan

Klaim adalah pernyataan tentang subjek oleh penerbit. Klaim mewakili atribut subjek yang berguna dalam konteks operasi autentikasi dan otorisasi. Subjek dan pengeluar sertifikat adalah entitas yang merupakan bagian dari skenario identitas. Beberapa contoh umum subjek adalah: pengguna, aplikasi atau layanan, perangkat, atau komputer. Beberapa contoh umum penerbit adalah: sistem operasi, aplikasi, layanan, penyedia peran, penyedia identitas, atau penyedia federasi. Pengeluar sertifikat memberikan klaim dengan mengeluarkan token keamanan, biasanya melalui Layanan Token Keamanan (STS). (Di WIF, Anda dapat membangun STS dengan berasal dari SecurityTokenService kelas .) Terkadang, pengumpulan klaim yang diterima dari penerbit dapat diperpanjang oleh atribut subjek yang disimpan langsung di sumber daya. Klaim dapat dievaluasi untuk menentukan hak akses ke data dan sumber daya aman lainnya selama proses otorisasi dan juga dapat digunakan untuk membuat atau mengekspresikan keputusan autentikasi tentang subjek.

Dimulai dengan .NET 4.5, kelas Windows Identity Foundation (WIF), yang menerapkan identitas berbasis klaim, telah sepenuhnya diintegrasikan ke dalam .NET Framework. Konsep klaim diimplementasikan oleh Claim kelas .

Berikut ini menjelaskan properti penting dari Claim kelas :

• Properti Type adalah string (biasanya URI) yang berisi informasi semantik tentang klaim; ini memberi tahu Anda apa arti nilai klaim. Misalnya, klaim dengan jenis GivenName klaim ("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname") mewakili nama depan pengguna. Nilai Type properti dapat menjadi salah satu jenis klaim terkenal yang ditentukan di ClaimTypes kelas , atau dapat menjadi URI arbitrer seperti yang didefinisikan oleh penerbit. Misalnya, jenis klaim "urn:spendinglimit" mungkin mewakili atribut pengguna yang masuk akal dalam konteks bisnis penerbit.

• Properti Value berisi nilai klaim. Untuk mengurangi dependensi dan menyederhanakan administrasi, dalam WIF nilai klaim hanya diwakili sebagai string. Untuk jenis nilai yang lebih kompleks, disarankan agar Anda menggunakan jenis skema XML standar untuk menunjukkan bagaimana nilai dimaksudkan untuk diserialisasikan ke dalam dan dideserialisasi dari string.

• Properti ValueType berisi string yang mengidentifikasi informasi jenis untuk nilai tersebut. Properti ini harus digunakan untuk memahami format nilai dan untuk memberikan informasi tentang cara mendeserialisasinya. Jika solusi Anda memerlukan jenis nilai yang kompleks, disarankan agar Anda menggunakan jenis skema XML standar di ValueType properti untuk menunjukkan bagaimana Value properti dimaksudkan untuk diserialisasikan ke dalam dan deserialisasi dari string.

• Properti Subject adalah ClaimsIdentity objek yang mewakili subjek klaim. Subjek klaim adalah entitas (biasanya pengguna yang meminta akses ke sumber daya) yang klaimnya dinyatakan. berisi ClaimsIdentity , di antara propertinya, kumpulan klaim yang menggambarkan properti dan atribut subjek sebagaimana diujarkan oleh satu atau beberapa penerbit.

• Properti Issuer berisi nama entitas yang mengeluarkan klaim. Penerbit klaim diwakili dalam WIF oleh string yang berisi nama yang diambil dari daftar penerbit terkenal yang dikelola oleh registri nama penerbit. Registri nama penerbit adalah instans kelas yang berasal dari IssuerNameRegistry kelas . Registri nama penerbit mengaitkan nama mnemonik ke materi kriptografi yang diperlukan untuk memverifikasi tanda tangan token yang dihasilkan oleh penerbit yang sesuai. Misalnya, ConfigurationBasedIssuerNameRegistry kelas , tersedia di luar kotak dengan .NET 4.5, mengaitkan nama mnemonic untuk setiap pengeluar sertifikat dengan sertifikat X.509 yang sesuai. Daftar penerbit terkenal biasanya dibangun pada waktu startup oleh registri nama penerbit. Daftar yang ConfigurationBasedIssuerNameRegistry digunakan oleh ditentukan dalam file konfigurasi aplikasi.

• Properti OriginalIssuer berisi nama entitas yang awalnya mengeluarkan klaim. Properti ini dirancang untuk memfasilitasi skenario di mana klaim dapat melewati beberapa penerbit sebelum disajikan oleh klien ke aplikasi RP; seperti skenario federasi. Anda dapat memeriksa OriginalIssuer properti untuk menentukan entitas yang awalnya mengeluarkan klaim. Nama ini diambil dari daftar penerbit terkenal yang dikelola oleh registri nama penerbit, seperti dalam kasus Issuer properti .

Konstruktor

Claim(BinaryReader)	Menginisialisasi instans Claim dengan yang ditentukan BinaryReader.
Claim(BinaryReader, ClaimsIdentity)	Menginisialisasi instans Claim baru kelas dengan pembaca dan subjek yang ditentukan.
Claim(Claim)	Menginisialisasi instans baru kelas Claim.
Claim(Claim, ClaimsIdentity)	Menginisialisasi instans Claim baru kelas dengan klaim dan subjek keamanan yang ditentukan.
Claim(String, String)	Menginisialisasi instans Claim baru kelas dengan jenis klaim yang ditentukan, dan nilai.
Claim(String, String, String)	Menginisialisasi instans Claim baru kelas dengan jenis klaim, nilai, dan jenis nilai yang ditentukan.
Claim(String, String, String, String)	Menginisialisasi instans Claim baru kelas dengan jenis klaim, nilai, jenis nilai, dan penerbit yang ditentukan.
Claim(String, String, String, String, String)	Menginisialisasi instans Claim baru kelas dengan jenis klaim, nilai, jenis nilai, penerbit, dan penerbit asli yang ditentukan.
Claim(String, String, String, String, String, ClaimsIdentity)	Menginisialisasi instans Claim baru kelas dengan jenis klaim, nilai, jenis nilai, penerbit, penerbit asli, dan subjek yang ditentukan.

Properti

CustomSerializationData	Berisi data tambahan yang disediakan oleh jenis turunan.
Issuer	Mendapatkan penerbit klaim.
OriginalIssuer	Mendapatkan penerbit asli klaim.
Properties	Mendapatkan kamus yang berisi properti tambahan yang terkait dengan klaim ini.
Subject	Mendapatkan subjek klaim.
Type	Mendapatkan jenis klaim klaim.
Value	Mendapatkan nilai klaim.
ValueType	Mendapatkan jenis nilai klaim.

Metode

Clone()	Mengembalikan objek baru Claim yang disalin dari objek ini. Klaim baru tidak memiliki subjek.
Clone(ClaimsIdentity)	Mengembalikan objek baru Claim yang disalin dari objek ini. Subjek klaim baru diatur ke ClaimsIdentity yang ditentukan.
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 dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan representasi string objek ini Claim .
WriteTo(BinaryWriter)	Menulis ini Claim kepada penulis.
WriteTo(BinaryWriter, Byte[])	Menulis ini Claim kepada penulis.

Lihat juga

• ClaimsIdentity
• ClaimsPrincipal
• IssuerNameRegistry