ClaimsIdentity Класс

Определение

Пространство имен:

System.Security.Claims

Сборка:

System.Security.Claims.dll

Исходный код:

ClaimsIdentity.cs

Предоставляет удостоверение на основе утверждений.

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

public class ClaimsIdentity : System.Security.Principal.IIdentity

type ClaimsIdentity = class
    interface IIdentity

Public Class ClaimsIdentity
Implements IIdentity

Наследование

Object

ClaimsIdentity

Производный

System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

Реализации

IIdentity

Комментарии

Класс ClaimsIdentity представляет собой конкретную реализацию удостоверения на основе утверждений, то есть удостоверения, описываемого коллекцией утверждений. Утверждение — это утверждение о сущности, сделанное издателем, которое описывает свойство, право или какое-либо другое качество этой сущности. Считается, что такая сущность является предметом претензии. Утверждение представлено классом Claim . Утверждения, содержащиеся в , ClaimsIdentity описывают сущность, которую представляет соответствующее удостоверение, и могут использоваться для принятия решений об авторизации и проверке подлинности. Модель доступа на основе утверждений имеет множество преимуществ по сравнению с более традиционными моделями доступа, которые зависят исключительно от ролей. Например, утверждения могут предоставлять гораздо более подробные сведения об удостоверениях, которые они представляют, и могут быть оценены для авторизации или проверки подлинности гораздо более конкретным способом.

Начиная с платформа .NET Framework 4.5, Windows Identity Foundation (WIF) и удостоверение на основе утверждений были полностью интегрированы в платформа .NET Framework. Это означает, что многие классы, представляющие удостоверение в платформа .NET Framework теперь являются производными от ClaimsIdentity своих свойств и описывают их с помощью коллекции утверждений. Это отличается от предыдущих версий платформа .NET Framework, в которых эти классы реализуют IIdentity интерфейс напрямую. Доступ к коллекции утверждений, описывающих удостоверение, можно получить через Claims свойство . Класс ClaimsIdentity предоставляет несколько методов для поиска и изменения утверждений и полностью поддерживает запросы, интегрированные с языком (LINQ). В коде ClaimsIdentity приложения доступ к объектам обычно осуществляется через ClaimsPrincipal объекты, например субъект, возвращаемый Thread.CurrentPrincipal.

Примечание

Класс ClaimsPrincipal также имеет Claims свойство . В большинстве случаев доступ к утверждениям пользователя следует получить через коллекцию ClaimsPrincipal.Claims , а не через коллекцию Claims . Доступ к утверждениям отдельного пользователя ClaimsIdentity потребуется только в тех случаях, когда субъект содержит несколько ClaimsIdentity и вам нужно оценить или изменить определенное удостоверение.

Важно!

Чтобы добавить или удалить утверждения из Claims коллекции, вызывающий объект должен иметь полное доверие.

В модели на основе утверждений IIdentity.Name свойство и IPrincipal.IsInRole(String) метод реализуются путем оценки утверждений, содержащихся в идентификаторе. Базовые реализации в модели на основе утверждений предоставляются свойством ClaimsIdentity.Name и методом ClaimsPrincipal.IsInRole . Свойства NameClaimType и RoleClaimType позволяют указать тип утверждения, который следует использовать для оценки утверждений, содержащихся в удостоверении, при выполнении этих операций.

Сценарии делегирования поддерживаются с помощью Actor свойств и BootstrapContext .

Конструкторы

ClaimsIdentity()	Инициализирует новый экземпляр класса ClaimsIdentity с пустой коллекцией требований.
ClaimsIdentity(BinaryReader)	Инициализирует новый экземпляр ClaimsIdentity с указанным BinaryReader.
ClaimsIdentity(ClaimsIdentity)	Инициализирует новый экземпляр класса ClaimsIdentity из существующего экземпляра ClaimsIdentity.
ClaimsIdentity(IEnumerable<Claim>)	Инициализирует новый экземпляр класса ClaimsIdentity, используя перечисляемую коллекцию объектов Claim.
ClaimsIdentity(IEnumerable<Claim>, String)	Инициализирует новый экземпляр класса ClaimsIdentity с указанными требованиями и типом аутентификации.
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Инициализирует новый экземпляр класса ClaimsIdentity указанными требованиями, типом аутентификации, типом требования имени и типом требования роли.
ClaimsIdentity(IIdentity)	Инициализирует новый экземпляр класса ClaimsIdentity, используя имя и тип аутентификации из заданного объекта IIdentity.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Инициализирует новый экземпляр класса ClaimsIdentity, используя указанные требования и заданный объект IIdentity.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Инициализирует новый экземпляр класса ClaimsIdentity из указанного IIdentity, используя указанные требования, тип аутентификации, тип требования имени и тип требования роли.
ClaimsIdentity(SerializationInfo)	Устаревшие.. Инициализирует новый экземпляр класса ClaimsIdentity из сериализованного потока, созданного с помощью ISerializable.
ClaimsIdentity(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует новый экземпляр класса ClaimsIdentity из сериализованного потока, созданного с помощью ISerializable.
ClaimsIdentity(String)	Инициализирует новый экземпляр класса ClaimsIdentity пустой коллекцией требований и указанным типом аутентификации.
ClaimsIdentity(String, String, String)	Инициализирует новый экземпляр класса ClaimsIdentity с указанным типом аутентификации, типом требования имени и типом требования роли.

Поля

DefaultIssuer	Издатель по умолчанию; "ЛОКАЛЬНАЯ СИСТЕМА".
DefaultNameClaimType	Тип утверждения имени по умолчанию; Name.
DefaultRoleClaimType	Тип утверждения роли по умолчанию; Role.

Свойства

Actor	Получает или задает удостоверение вызывающей стороны, которой были предоставлены права делегирования.
AuthenticationType	Возвращает тип проверки подлинности.
BootstrapContext	Получает или задает токен, который использовался для создания данного удостоверения на основе требований.
Claims	Получает требования, связанные с данным удостоверением на основе требований.
CustomSerializationData	Содержит дополнительные данные, предоставленные производным типом. Обычно устанавливается при вызове WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Получает значение, определяющее, прошло ли удостоверение аутентификацию.
Label	Получает или задает метку для данного удостоверения на основе требований.
Name	Получает имя данного удостоверения на основе требований.
NameClaimType	Получает тип требования, используемый для определения того, какие требования предоставляют значение для свойства Name данного удостоверения на основе требований.
RoleClaimType	Возвращает тип утверждения, который будет интерпретироваться как роль .NET среди утверждений в данном удостоверении на основе утверждений.

Методы

AddClaim(Claim)	Добавляет одно требование к этому идентификатору требований.
AddClaims(IEnumerable<Claim>)	Добавляет список требований к этому идентификатору требований.
Clone()	Возвращает новый объект ClaimsIdentity, скопированный из данного удостоверение утверждений.
CreateClaim(BinaryReader)	Предоставляет точку расширяемости для производных типов с целью создания пользовательского Claim.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindAll(Predicate<Claim>)	Извлекает все утверждения, соответствующие указанного предикату.
FindAll(String)	Извлекает все утверждения, которые имеют указанный тип утверждения.
FindFirst(Predicate<Claim>)	Извлекает первое утверждение, соответствующие указанному предикату.
FindFirst(String)	Извлекает первое утверждение с указанным типом утверждения.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	Заполняет объект SerializationInfo данными, необходимыми для сериализации текущего объекта ClaimsIdentity.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HasClaim(Predicate<Claim>)	Определяет, имеет ли этот идентификатор утверждения утверждение, что соответствует заданному предикату.
HasClaim(String, String)	Определяет, имеет ли этот идентификатор утверждения утверждение с заданным типом и значением утверждения.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
RemoveClaim(Claim)	Пытается удалить утверждение на основе идентификатора утверждений.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TryRemoveClaim(Claim)	Пытается удалить утверждение на основе идентификатора утверждений.
WriteTo(BinaryWriter)	Выполняет сериализацию с помощью BinaryWriter.
WriteTo(BinaryWriter, Byte[])	Выполняет сериализацию с помощью BinaryWriter.

См. также раздел

• Claim
• ClaimsPrincipal
• GenericIdentity
• WindowsIdentity
• FormsIdentity