Créer un fournisseur de revendications dans SharePoint
Découvrez comment créer et implémenter un fournisseur de revendications SharePoint qui remplit les conditions requises pour l'augmentation des revendications et sélection des revendications.
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 augmenter supplémentaire basée sur les revendications dans le jeton de l'utilisateur. Par exemple, avec basé sur Windows journal-in, le service d'annuaire Active Directory peut augmenter tous les groupes de sécurité d'un utilisateur dans le jeton d'utilisateur Windows. Avec basée sur les revendications reconnectez-vous, une application de gestion (CRM) de relation client peut augmenter les rôles à partir d'une base de données CRM. Grâce à ces revendications de jeton de l'utilisateur, ressources peuvent être autorisés par rapport à ces demandes. En d'autres termes, ces revendications sont utilisées pour déterminer si un utilisateur donné a accès à des ressources spécifiques.Basée sur les revendications peut être affichées dans le contrôle de sélecteur de personnes par le biais de sélection des revendications. Revendications permet de sélectionner une application pour exposer basée sur les 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é vous permet de vous permettent de recherche, la résolution et affichage convivial de revendications.
Notes
[!REMARQUE] Un sélecteur de personnes avec la fonctionnalité de sélection des revendications est parfois appelé un sélecteur de revendications. Pour plus d'informations, consultez sélecteur de personnes et de la planification du fournisseur de revendications.
Pour écrire un fournisseur de revendications, la première étape consiste à créer une classe qui dérive de la classe SPClaimProvider.
Conseil : Pour obtenir un exemple de code et plus d’informations sur la classe SPClaimProvider et ses membres, voir SPClaimProvider . Pour les procédures pas à pas, des conseils et des exemples de code, consultez la rubrique basée sur les revendications et sécurité : articles techniques et des exemples de code sur MSDN.
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);
Requis pour la recherche basée sur les 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)