ClaimsPrincipal Класс

Определение

public ref class ClaimsPrincipal : System::Security::Principal::IPrincipal

public class ClaimsPrincipal : System.Security.Principal.IPrincipal

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

type ClaimsPrincipal = class
    interface IPrincipal

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

Public Class ClaimsPrincipal
Implements IPrincipal

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

Object

ClaimsPrincipal

Производный

System.Security.Principal.GenericPrincipal

System.Security.Principal.WindowsPrincipal

System.Web.Security.RolePrincipal

Атрибуты

ComVisibleAttribute SerializableAttribute

Реализации

IPrincipal

Примеры

В следующем примере извлекаются утверждения, представленные пользователем в HTTP-запросе, и они записываются в HTTP-ответ. Текущий пользователь считывается из как HttpContextClaimsPrincipal. Затем утверждения считываются из него и записываются в ответ.

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

Комментарии

Начиная с платформа .NET Framework 4.5, Windows Identity Foundation (WIF) и удостоверение на основе утверждений полностью интегрированы в платформа .NET Framework. Это означает, что многие классы, представляющие субъект в платформа .NET Framework теперь являются производными от ClaimsPrincipal , а не просто реализуют IPrincipal интерфейс . Помимо реализации IPrincipal интерфейса, предоставляет свойства и методы, ClaimsPrincipal которые полезны для работы с утверждениями.

ClaimsPrincipalпредоставляет коллекцию удостоверений, каждое из которых является .ClaimsIdentity В обычном случае эта коллекция, доступ к которой осуществляется через Identities свойство , будет иметь только один элемент.

Введение ClaimsPrincipal в .NET 4.5 в качестве участника, от которого наследуются большинство основных классов, не вынуждает вас изменять способ работы с удостоверениями. Он, однако, открывает больше возможностей и предлагает больше шансов осуществлять более точное управление доступом. Пример:

• Код приложения может работать непосредственно с утверждениями, содержащимися в текущем субъекте, для выполнения дополнительных задач проверки подлинности, авторизации и персонализации.

• Для ресурсов можно использовать конвейер обработки утверждений, который может обрабатывать запросы проверки подлинности и политику авторизации еще до того, как выполнение достигнет кода. Например, можно настроить веб-приложение или службу с пользовательским диспетчером проверки подлинности утверждений, экземпляром класса, производного от ClaimsAuthenticationManager класса . Если это настроено, конвейер обработки запросов вызывает Authenticate метод в диспетчере проверки подлинности утверждений, передавая ClaimsPrincipal ему значение , представляющее контекст входящего запроса. Затем диспетчер проверки подлинности утверждений может выполнять проверку подлинности на основе значений входящих утверждений. Он также может фильтровать, преобразовывать или добавлять утверждения во входящий набор утверждений. Например, его можно использовать для обогащения входящего набора утверждений новыми утверждениями, созданными из локального источника данных, например из профиля локального пользователя.

• Вы можете настроить веб-приложение с помощью пользовательского диспетчера авторизации утверждений, экземпляра класса, производного от ClaimsAuthorizationManager класса . Если это настроено, конвейер обработки запросов упаковывает входящий ClaimsPrincipal в и вызывает CheckAccess метод в диспетчере авторизации утвержденийAuthorizationContext. Затем диспетчер авторизации утверждений может применять авторизацию на основе входящих утверждений.

• Встроенные проверки доступа на основе утверждений можно выполнить, настроив приложение с помощью пользовательского диспетчера авторизации утверждений и используя ClaimsPrincipalPermission класс для выполнения императивных проверок доступа или ClaimsPrincipalPermissionAttribute для выполнения декларативной проверки доступа. Проверки доступа к коду на основе утверждений выполняются встроенным образом, за пределами конвейера обработки и поэтому доступны для всех приложений, если настроен диспетчер авторизации утверждений.

Вы можете получить ClaimsPrincipal экземпляр для субъекта, связанного с запросом, или субъекта, от имени которого выполняется поток, в приложении проверяющей стороны (RP), приведение свойства к Thread.CurrentPrincipalClaimsPrincipal. Утверждения, связанные с ClaimsPrincipal объектом , доступны через его Claims свойство . Свойство Claims возвращает все утверждения, содержащиеся в удостоверениях, связанных с субъектом. В редких случаях, когда ClaimsPrincipal содержит несколько ClaimsIdentity экземпляров, можно использовать Identities свойство или получить доступ к основному Identity удостоверению с помощью свойства . ClaimsPrincipal предоставляет несколько методов, с помощью которых можно выполнять поиск в этих утверждениях, и полностью поддерживает языковой интегрированный запрос (LINQ). Удостоверения можно добавить в субъект с помощью AddIdentities методов или AddIdentity .

По умолчанию WIF определяет приоритет WindowsIdentity объектов при выборе основного удостоверения, возвращаемого Identity через свойство . Это поведение можно изменить, предоставив делегат через PrimaryIdentitySelector свойство для выполнения выбора. Свойство ClaimsPrincipalSelector предоставляет аналогичные функциональные Current возможности для свойства .

В модели на основе утверждений, находится ли субъект в указанной роли, определяется утверждениями, представленными его базовыми удостоверениями. Метод IsInRole по существу проверяет каждое удостоверение, связанное с субъектом, чтобы определить, имеет ли он утверждение с указанным значением роли. Тип утверждения (представленного его Claim.Type свойством), используемый для определения утверждений, которые должны проверяться во время проверки ролей, указывается для удостоверения через его ClaimsIdentity.RoleClaimType свойство. Таким образом, утверждения, проверенные во время проверки роли, могут иметь другой тип для разных удостоверений, связанных с субъектом.

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

Свойства

Методы

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

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

• Claim
• ClaimsIdentity
• ClaimsAuthenticationManager
• ClaimsAuthorizationManager