ClaimsIdentity Kelas

Referensi

Definisi

Ruang nama:: System.Security.Claims

Rakitan:: mscorlib.dll, System.Security.Claims.dll

Rakitan:: System.Security.Claims.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Sumber:: ClaimsIdentity.cs

Sumber:: ClaimsIdentity.cs

Sumber:: ClaimsIdentity.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili identitas berbasis klaim.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity

public class ClaimsIdentity : System.Security.Principal.IIdentity

[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class ClaimsIdentity : System.Security.Principal.IIdentity

type ClaimsIdentity = class
    interface IIdentity

[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ClaimsIdentity = class
    interface IIdentity

Public Class ClaimsIdentity
Implements IIdentity

Warisan: Object
ClaimsIdentity

Turunan: System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

System.Web.Security.FormsIdentity

Atribut: ComVisibleAttribute SerializableAttribute

Penerapan: IIdentity

Keterangan

Kelas ClaimsIdentity ini adalah implementasi konkret dari identitas berbasis klaim; yaitu, identitas yang dijelaskan oleh kumpulan klaim. Klaim adalah pernyataan tentang entitas yang dibuat oleh penerbit yang menjelaskan properti, hak, atau beberapa kualitas lain dari entitas tersebut. Entitas seperti itu dikatakan sebagai subjek klaim. Klaim diwakili oleh Claim kelas . Klaim yang terkandung dalam ClaimsIdentity menjelaskan entitas yang diwakili identitas terkait, dan dapat digunakan untuk membuat keputusan otorisasi dan autentikasi. Model akses berbasis klaim memiliki banyak keuntungan dibandingkan model akses yang lebih tradisional yang bergantung secara eksklusif pada peran. Misalnya, klaim dapat memberikan informasi yang jauh lebih kaya tentang identitas yang mereka wakili dan dapat dievaluasi untuk otorisasi atau autentikasi dengan cara yang jauh lebih spesifik.

Dimulai dengan .NET Framework 4.5, Windows Identity Foundation (WIF) dan identitas berbasis klaim telah sepenuhnya diintegrasikan ke dalam .NET Framework. Ini berarti bahwa banyak kelas yang mewakili identitas dalam .NET Framework sekarang berasal dari ClaimsIdentity dan menggambarkan properti mereka melalui kumpulan klaim. Ini berbeda dari versi .NET Framework sebelumnya, di mana, kelas-kelas ini mengimplementasikan antarmuka secara IIdentity langsung. Pengumpulan klaim yang menjelaskan identitas dapat diakses melalui Claims properti . Kelas ini ClaimsIdentity menyediakan beberapa metode untuk menemukan dan memodifikasi klaim dan sepenuhnya mendukung kueri terintegrasi bahasa (LINQ). Dalam kode aplikasi, ClaimsIdentity objek biasanya diakses melalui ClaimsPrincipal objek; misalnya, prinsipal yang dikembalikan oleh Thread.CurrentPrincipal.

Catatan

Kelas ClaimsPrincipal ini juga memiliki Claims properti . Dalam sebagian besar kasus, Anda harus mengakses klaim pengguna melalui ClaimsPrincipal.Claims koleksi daripada melalui Claims koleksi. Anda harus mengakses klaim individu ClaimsIdentity hanya dalam kasus di mana prinsipal berisi lebih dari satu ClaimsIdentity dan Anda perlu mengevaluasi atau memodifikasi identitas tertentu.

Penting

Untuk menambahkan atau menghapus klaim dari Claims koleksi, penelepon harus memiliki kepercayaan penuh.

Dalam model berbasis klaim, IIdentity.Name properti dan IPrincipal.IsInRole(String) metode diimplementasikan dengan mengevaluasi klaim yang terkandung oleh identitas. Implementasi dasar dalam model berbasis klaim disediakan oleh ClaimsIdentity.Name properti dan ClaimsPrincipal.IsInRole metode . Properti NameClaimType dan RoleClaimType memungkinkan Anda menentukan jenis klaim yang harus digunakan untuk mengevaluasi klaim yang terkandung oleh identitas saat melakukan operasi ini.

Skenario delegasi didukung melalui Actor properti dan BootstrapContext .

Konstruktor

ClaimsIdentity()	Menginisialisasi instans ClaimsIdentity baru kelas dengan koleksi klaim kosong.
ClaimsIdentity(BinaryReader)	Menginisialisasi instans ClaimsIdentity dengan yang ditentukan BinaryReader.
ClaimsIdentity(ClaimsIdentity)	Menginisialisasi instans ClaimsIdentity baru kelas dari instans yang ada ClaimsIdentity .
ClaimsIdentity(IEnumerable<Claim>)	Menginisialisasi instans ClaimsIdentity baru kelas menggunakan kumpulan Claim objek yang dijumlahkan.
ClaimsIdentity(IEnumerable<Claim>, String)	Menginisialisasi instans ClaimsIdentity baru kelas dengan klaim dan jenis autentikasi yang ditentukan.
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Menginisialisasi instans ClaimsIdentity baru kelas dengan klaim, jenis autentikasi, jenis klaim nama, dan jenis klaim peran yang ditentukan.
ClaimsIdentity(IIdentity)	Menginisialisasi instans ClaimsIdentity baru kelas menggunakan nama dan jenis autentikasi dari yang ditentukan IIdentity.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Menginisialisasi instans ClaimsIdentity baru kelas menggunakan klaim yang ditentukan dan yang ditentukan IIdentity.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Menginisialisasi instans ClaimsIdentity baru kelas dari yang ditentukan IIdentity menggunakan klaim, jenis autentikasi, jenis klaim nama, dan jenis klaim peran yang ditentukan.
ClaimsIdentity(SerializationInfo)	Kedaluwarsa. Menginisialisasi instans ClaimsIdentity baru kelas dari aliran berseri yang dibuat dengan menggunakan ISerializable.
ClaimsIdentity(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans ClaimsIdentity baru kelas dari aliran berseri yang dibuat dengan menggunakan ISerializable.
ClaimsIdentity(String)	Menginisialisasi instans ClaimsIdentity baru kelas dengan koleksi klaim kosong dan jenis autentikasi yang ditentukan.
ClaimsIdentity(String, String, String)	Menginisialisasi instans ClaimsIdentity baru kelas dengan jenis autentikasi yang ditentukan, jenis klaim nama, dan jenis klaim peran.

Bidang

DefaultIssuer	Penerbit default; "OTORITAS LOKAL".
DefaultNameClaimType	Jenis klaim nama default; Name.
DefaultRoleClaimType	Jenis klaim peran default; Role.

Properti

Actor	Mendapatkan atau menetapkan identitas pihak pemanggil yang diberikan hak delegasi.
AuthenticationType	Mendapatkan jenis autentikasi.
BootstrapContext	Mendapatkan atau mengatur token yang digunakan untuk membuat identitas klaim ini.
Claims	Mendapatkan klaim yang terkait dengan identitas klaim ini.
CustomSerializationData	Berisi data tambahan yang disediakan oleh jenis turunan. Biasanya diatur saat memanggil WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Mendapatkan nilai yang menunjukkan apakah identitas telah diautentikasi.
Label	Mendapatkan atau mengatur label untuk identitas klaim ini.
Name	Mendapatkan nama identitas klaim ini.
NameClaimType	Mendapatkan jenis klaim yang digunakan untuk menentukan klaim mana yang memberikan nilai untuk Name properti identitas klaim ini.
RoleClaimType	Mendapatkan jenis klaim yang akan ditafsirkan sebagai peran .NET di antara klaim dalam identitas klaim ini.

Metode

AddClaim(Claim)	Menambahkan satu klaim ke identitas klaim ini.
AddClaims(IEnumerable<Claim>)	Menambahkan daftar klaim ke identitas klaim ini.
Clone()	Mengembalikan salinan baru ClaimsIdentity dari identitas klaim ini.
CreateClaim(BinaryReader)	Menyediakan titik ekstensibilitas untuk jenis turunan untuk membuat kustom Claim.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindAll(Predicate<Claim>)	Mengambil semua klaim yang cocok dengan predikat yang ditentukan.
FindAll(String)	Mengambil semua klaim yang memiliki jenis klaim yang ditentukan.
FindFirst(Predicate<Claim>)	Mengambil klaim pertama yang cocok dengan predikat yang ditentukan.
FindFirst(String)	Mengambil klaim pertama dengan jenis klaim yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	Mengisi dengan data yang SerializationInfo diperlukan untuk membuat serial objek saat ini ClaimsIdentity .
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
HasClaim(Predicate<Claim>)	Menentukan apakah identitas klaim ini memiliki klaim yang cocok dengan predikat yang ditentukan.
HasClaim(String, String)	Menentukan apakah identitas klaim ini memiliki klaim dengan jenis dan nilai klaim yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
RemoveClaim(Claim)	Mencoba menghapus klaim dari identitas klaim.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TryRemoveClaim(Claim)	Mencoba menghapus klaim dari identitas klaim.
WriteTo(BinaryWriter)	Menserialisasikan menggunakan BinaryWriter.
WriteTo(BinaryWriter, Byte[])	Menserialisasikan menggunakan BinaryWriter.

Berlaku untuk

Bagikan melalui