How to: Create a Claims Provider
Applies to: SharePoint Foundation 2010
A claims provider issues claims and packages claims into security tokens. A claims provider has two roles: augmentation and picking.
Claims augmentation enables an application to augment additional claims into the user's token. For example, with Windows-based log-in, the Active Directory directory service can augment all of a user's security groups into the user's Windows token. With claims-based log-in, a customer relationship management (CRM) application can augment roles from a CRM database. By having these claims in the user's token, resources can be authorized against these claims. That is, these claims are used to determine whether a particular user has access to specific resources.
Claims can be displayed in the People Picker control through claims picking. Claims picking enables an application to surface claims in the people picker, for example, when configuring the security of a SharePoint site or SharePoint service. This functionality enables you to provide search, resolve, and friendly display of claims.
Note
A People Picker with claims picking functionality is sometimes referred to as a claims picker. For more information, see People Picker and claims provider planning.
To write a claims provider, your first step is to create a class that derives from the SPClaimProvider class.
Tip
For a code example and more information about the SPClaimProvider class and its members, see SPClaimProvider.
Required Implementations
The following are required methods and properties when writing a claims provider.
Required
The following Name property is a required property. The name should be unique across the farm.
public abstract String Name
Required for Claims Picker
Claims can be displayed in the People Picker control through claims picking. The following methods in the SPClaimProvider class are required methods if you want to implement claim picking in the People Picker control.
protected abstract void FillSchema(SPProviderSchema schema);
protected abstract void FillClaimTypes(List<String> claimTypes);
protected abstract void FillClaimValueTypes(List<String> claimValueTypes);
protected abstract void FillEntityTypes(List<String> entityTypes);
Required for Claims Augmentation
When you include additional claims in a user's security token, you are augmenting claims. If you want to augment claims, you must implement the following methods in the SPClaimProvider class.
public abstract bool SupportsEntityInformation
protected abstract void FillClaimsForEntity(Uri context, SPClaim entity, List<SPClaim> claims);
Required for Displaying Hierarchy on the Left Pane of the Claims Picker
If you want to display hierarchy on the left pane of the claims picker, you must implement the following methods in the SPClaimProvider class.
public abstract bool SupportsHierarchy
protected abstract void FillHierarchy(Uri context, String[] entityTypes, String hierarchyNodeID, int numberOfLevels, bool includeEntityData, SPProviderHierarchyTree hierarchy);
Required for Resolving Claims in the Type-in Control of the Claims Picker
If you want to be able to resolve claims by using the type-in control of the claims picker, you must implement the following methods in the SPClaimProvider class.
public abstract bool SupportsResolve
protected abstract void FillResolve(Uri context, String[] entityTypes, String resolveInput, List<PickerEntity> resolved);
protected abstract void FillResolve(Uri context, String[] entityTypes, SPClaim resolveInput, List<PickerEntity> resolved);
Required for Searching for Claims in the Claims Picker
If you want to be able to search for claims in the claims picker, you must implement the following property and method in the SPClaimProvider class.
public abstract bool SupportsSearch
protected abstract void FillSearch(Uri context, String[] entityTypes, String searchPattern, String hierarchyNodeID, int maxCount, SPProviderHierarchyTree searchTree);
Useful Helper Method
You can also implement a helper method to help you create SPClaim objects.
Useful Helper Method for Creating SPClaim Objects
The following is a helper method that you can implement to help you create SPClaim objects.
protected SPClaim CreateClaim(String claimType, String value, String valueType)