Defines the data and behavior of a claims-based representation of a single user.
Assembly: Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)
This interface extends the IIdentity interface to incorporate functionality needed to implement claims-based identity. It defines the basic functionality required for an object model representation of a user, service, or other identity that participates in a Windows® Identity Foundation (WIF) application. All classes that represent an identity in WIF must implement the IClaimsIdentity interface. Some examples are ClaimsIdentity, WindowsClaimsIdentity, and RsaClaimsIdentity. It is recommended that the IClaimsIdentity interface be used to access the methods and properties of claims-based identity objects rather than using the properties and methods of those objects directly.
In addition to the information about an identity exposed by the IIdentity interface, objects that implement IClaimsIdentity can expose much richer information about an identity through the claims contained in the Claims property. For example, the email address of a user could be one such claim. In fact, an identity in a claims-based system is largely defined by the collection of assertions (claims) that one or more issuers has made about it. In WIF, the claims contained in IClaimsIdentity objects (typically accessed through IClaimsPrincipal objects) are used to make decisions about authorization and authentication; as well as to provide information about an entity that vastly exceeds the capability of role-based access models. For an example of how to access claims through an IClaimsIdentity object in an RP application, see IClaimsPrincipal.
The IClaimsIdentity interface extends both the IClaimsIdentity.Name property and the IClaimsPrincipal.IsInRole method to the claims-based model by providing the NameClaimType and RoleClaimType properties. These properties enable you to specify a claim type that should be used to evaluate the claims contained by the identity when performing these operations.
Target PlatformsWindows 7, Windows Server 2008 R2, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2003 SP2 (32-bit or 64-bit)
Copyright © 2008 by Microsoft Corporation. All rights reserved.