Procédure : créer un fournisseur de revendications
Dernière modification : mercredi 23 mars 2011
S’applique à : SharePoint Foundation 2010
Un fournisseur de revendications émet des revendications et les regroupe dans des jetons de sécurité. Un fournisseur de revendications joue deux rôles : augmentation et sélection.
L’augmentation des revendications permet à une application d’augmenter des revendications supplémentaires dans le jeton de l’utilisateur. Par exemple, avec la connexion basée sur Windows, le service d’annuaire Active Directory peut augmenter tous les groupes de sécurité d’un utilisateur dans le jeton Windows de l’utilisateur. Avec la connexion basée sur les revendications, une application de gestion de relation client (CRM, Customer Relationship Management) peut augmenter des rôles à partir d’une base de données CRM. Grâce à leur présence dans le jeton de l’utilisateur, ces revendications peuvent déterminer si les ressources sont autorisées. En d’autres termes, ces revendications permettent de déterminer si un utilisateur donné a accès à des ressources spécifiques.
Les revendications peuvent être affichées dans le contrôle du sélecteur de personnes par le biais de la sélection des revendications. La sélection des revendications permet à une application d’exposer des revendications dans le sélecteur de personnes, par exemple lors de la configuration de la sécurité d’un site SharePoint ou d’un service SharePoint. Cette fonctionnalité facilite la recherche, la résolution et l’affichage convivial des revendications.
Notes
Un sélecteur de personnes doté de la fonctionnalité de sélection des revendications est parfois appelé sélecteur de revendications.
Pour écrire un fournisseur de revendications, la première étape consiste à créer une classe qui dérive de la classe SPClaimProvider.
.gif "Conseil") Conseil |
|---|
Pour un exemple de code et pour plus d’informations sur la classe SPClaimProvider et ses membres, voir SPClaimProvider. |
Implémentations obligatoires
Les méthodes et les propriétés suivantes sont obligatoires lors de l’écriture d’un fournisseur de revendications.
Obligatoire
La propriété Name suivante est une propriété obligatoire. Le nom doit être unique dans la batterie de serveurs.
public abstract String Name
Obligatoires pour le sélecteur de revendications
Les revendications peuvent être affichées dans le contrôle du sélecteur de personnes par le biais de la sélection des revendications. Les méthodes suivantes dans la classe SPClaimProvider sont des méthodes obligatoires si vous souhaitez implémenter la sélection des revendications dans le contrôle du sélecteur de personnes.
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);
Obligatoires pour l’augmentation des revendications
Lorsque vous incluez des revendications supplémentaires dans le jeton de sécurité d’un utilisateur, vous augmentez les revendications. Si vous souhaitez augmenter les revendications, vous devez implémenter les méthodes suivantes dans la classe SPClaimProvider.
public abstract bool SupportsEntityInformation
protected abstract void FillClaimsForEntity(Uri context, SPClaim entity, List<SPClaim> claims);
Obligatoires pour afficher la hiérarchie dans le volet de gauche du sélecteur de revendications
Si vous souhaitez afficher la hiérarchie dans le volet de gauche du sélecteur de revendications, vous devez implémenter les méthodes suivantes dans la classe SPClaimProvider.
public abstract bool SupportsHierarchy
protected abstract void FillHierarchy(Uri context, String[] entityTypes, String hierarchyNodeID, int numberOfLevels, bool includeEntityData, SPProviderHierarchyTree hierarchy);
Obligatoires pour résoudre les revendications dans le contrôle d’entrée du sélecteur de revendications
Pour pouvoir résoudre les revendications en utilisant le contrôle d’entrée du sélecteur de revendications, vous devez implémenter les méthodes suivantes dans la classe SPClaimProvider.
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);
Obligatoires pour rechercher des revendications dans le sélecteur de revendications
Pour pouvoir rechercher des revendications dans le sélecteur de revendications, vous devez implémenter la propriété et la méthode suivantes dans la classe SPClaimProvider.
public abstract bool SupportsSearch
protected abstract void FillSearch(Uri context, String[] entityTypes, String searchPattern, String hierarchyNodeID, int maxCount, SPProviderHierarchyTree searchTree);
Méthode d’assistance utile
Vous pouvez également implémenter une méthode d’assistance qui vous aide à créer des objets SPClaim.
Méthode d’assistance utile pour la création d’objets SPClaim
Voici une méthode d’assistance que vous pouvez implémenter en vue de créer des objets SPClaim.
protected SPClaim CreateClaim(String claimType, String value, String valueType)