Поделиться через


ClaimsIdentity Класс

Определение

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

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
Наследование
ClaimsIdentity
Производный
Атрибуты
Реализации

Комментарии

Класс 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.

Применяется к

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