Criar um provedor de declarações no SharePoint
Saiba como criar e implementar um provedor de declarações do SharePoint que atenda aos requisitos de aumento e separação de declarações.
Um provedor de declarações emite declarações e empacota declarações em tokens de segurança. Um provedor de declarações possui duas funções: aumento da capacidade e a separação.
um aplicativo para aumentar as declarações adicionais para o token do usuário. Por exemplo, com baseado no Windows log-in, o serviço de diretório do Active Directory pode aumentar todos os grupos de segurança do usuário no token do Windows do usuário. Com baseada em declarações log-in, um aplicativo de gerenciamento (CRM) de relacionamento do cliente pode aumentar as funções de um banco de dados do CRM. Ao ter essas declarações no token do usuário, os recursos podem ser autorizados contra essas declarações. Isto é, estas declarações são usadas para determinar se um determinado usuário tem acesso a recursos específicos. Declarações podem ser exibidas no controle do seletor de pessoas através de separação de declarações. A escolha de declarações permite que um aplicativo exiba declarações no seletor de pessoas, por exemplo, ao configurar a segurança de um site do SharePoint ou serviço do SharePoint. Essa funcionalidade permite que você forneça a pesquisa, a resolução e a exibição amigável de declarações.
Observação
[!OBSERVAçãO] Um selecionador de pessoas com funcionalidade de separação de declarações às vezes é conhecido como um Selecionador de declarações. Para obter mais informações, consulte Pessoas planejamento do provedor de declarações e seletor.
Para escrever um provedor de declarações, sua primeira etapa é criar uma classe derivada da classe SPClaimProvider.
Ponta: Para obter um exemplo de código e mais informações sobre a classe SPClaimProvider e seus membros, consulte SPClaimProvider . Para instruções passo a passo, dicas e exemplos de código, consulte declarações e segurança: artigos técnicos e códigos de exemplo no MSDN.
Implementações necessárias
A seguir estão propriedades e métodos necessários ao escrever um provedor de declarações.
Obrigatório
A propriedade Name a seguir é uma propriedade necessária. O nome deve ser exclusivo em todo o farm.
public abstract String Name
Necessário para o seletor de declarações
Declarações podem ser exibidas no controle do seletor de pessoas através de separação de declarações. Os métodos a seguir na classe SPClaimProvider são métodos necessários se você quiser implementar a escolha de declaração no controle de seletor de pessoas.
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);
Necessário para o aumento da capacidade de declarações
Ao incluir declarações adicionais no token de segurança do usuário, você está aumentando declarações. Se você quiser aumentar as declarações, deverá implementar os seguintes métodos na classe SPClaimProvider .
public abstract bool SupportsEntityInformation
protected abstract void FillClaimsForEntity(Uri context, SPClaim entity, List<SPClaim> claims);
Necessário para exibir a hierarquia no painel esquerdo do seletor de declarações
Se você quiser exibir hierarquia no painel esquerdo do seletor de declarações, deverá implementar os seguintes métodos na classe SPClaimProvider .
public abstract bool SupportsHierarchy
protected abstract void FillHierarchy(Uri context, String[] entityTypes, String hierarchyNodeID, int numberOfLevels, bool includeEntityData, SPProviderHierarchyTree hierarchy);
Necessário para a resolução de declarações no tipo de controle do seletor de declarações
Se você quiser ser capaz de resolver declarações usando o controle de tipo do seletor de declarações, você deve implementar os seguintes métodos na 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);
Necessário para a procura de declarações no seletor de declarações
Se você quiser ser capaz de pesquisar declarações no seletor de declarações, você deve implementar a propriedade e o método a seguir na classe SPClaimProvider .
public abstract bool SupportsSearch
protected abstract void FillSearch(Uri context, String[] entityTypes, String searchPattern, String hierarchyNodeID, int maxCount, SPProviderHierarchyTree searchTree);
Método auxiliar útil
Você também pode implementar um método auxiliar para ajudar a criar objetos SPClaim .
Método auxiliar útil para criar objetos de SPClaim
A seguir está um método auxiliar que você pode implementar para ajudar a criar objetos SPClaim .
protected SPClaim CreateClaim(String claimType, String value, String valueType)