Compartilhar via


Adicionar um trecho de Corte de Segurança no SharePoint

Você pode usar um trecho de corte de segurança para exibir o conteúdo somente a usuários específicos, com base em uma permissão específica que esses usuários devem ter e se os usuários são autenticado ou anônimo.

Introdução ao trecho de corte de segurança

Você pode usar um trecho de corte de segurança para exibir o conteúdo somente a usuários específicos, com base em uma permissão específica que esses usuários devem ter, e se esses usuários serão autenticado ou anônimo. Você pode adicionar um painel de corte de segurança para uma página mestra ou layout de página. Um painel de corte de segurança é um contêiner que pode incluir outros componentes ou trechos, como web parts, além de conteúdo estático.

Por exemplo, você pode usar um painel de corte de segurança para exibir o seguinte conteúdo para usuários específicos:

  • Uma web part de Conteúdo por Pesquisa que exibe em quais documentos um usuário autenticado está trabalhando atualmente.

  • Um modo de exibição de lista de documentos modificados recentemente para que os usuários autenticados possam ver as novidades no site.

  • Uma web part de Conteúdo por Pesquisa que exibe para visitantes não-autenticados uma lista de links recomendados com base no artigo atual. Tal uma lista de recomendações pode ser ruído para autores de conteúdo autenticados trabalhando no site, mas é importante que os visitantes não-autenticados.

  • Um entrada link separado da faixa de opções, para usuários não-autenticados ou que ainda precisam ser autenticados.

    Observação

    Este link entrar é inserido automaticamente em uma página mestra que é criada usando o Gerenciador de Design, mas você pode excluí-lo se ele não é necessário.

Um painel de segurança Trim tem configurações de duas propriedades importantes, um para autenticação e outro para permissões (ou autorização). Por exemplo, você pode usar um painel de corte de segurança para exibir o conteúdo a seguir para usuários específicos:

  • AuthenticationRestrictions Com essa propriedade, você pode restringir o painel aos usuários autenticados ou anônimos ou escolha todos os usuários (todos os usuários é a configuração padrão).

  • Permissões Com essa propriedade, você pode selecionar uma permissão específica que os usuários devem ter para exibir o conteúdo no painel.

    Observação

    Você está selecionando uma permissão individual, não um nível de permissão. (Um nível de permissão é um conjunto de permissões concedidas.)

É claro que, se você restringir a autenticação a apenas usuários anônimos, normalmente não é necessário especificar uma permissão específica porque os usuários anônimos geralmente não receberam nenhuma permissão do SharePoint. Faz sentido usar permissões somente com todos os usuários ou com todos os usuários autenticados.

O painel de segurança Trim tem três opções na faixa de opções, listado na coluna esquerda da tabela 1. A Tabela 1 mostra como essas configurações determinam a permissão específica que os usuários devem ter, o nível de permissão padrão mais baixo que inclui essa permissão específica e o grupo vinculado a esse nível de permissão por padrão.

Observação

Estas são as configurações padrão, que podem ser alteradas para qualquer determinado escopo, como um conjunto de sites, site, lista ou item.

Por exemplo, se você definir um painel de corte de segurança para Mostrar aos autores, por conteúdo padrão dentro desse painel fica visível para os usuários no grupo membros e o grupo de proprietários.

Tabela 1. Mapeamento de opções de painel para níveis e grupos de permissão padrão

Opção do painel de corte de segurança Propriedade Permissions Permissão Nível de permissão Group
Mostrar aos autores AddAndCustomizePages Adicionar e Personalizar Páginas Contribuir (ou superior) Members
Mostrar a usuários autenticados ViewPages Exibir Páginas Leitura (ou superior) Visitantes
Mostrar para administradores FullMask Selecionar Tudo Controle Total Proprietários

Inserir um painel de corte de segurança

Como todos trechos de código, você pode adicionar o trecho de corte de segurança da Galeria trecho. Para navegar na Galeria de trechos, primeiro você deve selecionar uma página mestra ou layout de página para editar.

Inserir um painel de corte de segurança

  1. Navegue até o seu site de publicação.

  2. No canto superior direito da página, escolha engrenagem as configurações e clique em Gerenciador de Design.

  3. No Gerenciador de Design, no painel de navegação esquerdo, escolha Editar páginas mestras ou Editar Layouts de página, dependendo de qual tipo de arquivo que você está editando.

  4. Selecione o nome da página mestra ou layout de página que você deseja adicionar o trecho de código para.

  5. Para abrir a Galeria de trechos, escolha trechos no canto superior direito da visualização do servidor.

  6. Na faixa de opções, na guia Design, escolha O corte de segurança.

    Opcionalmente, na lista suspensa do botão Segurança Trim, você pode selecionar os usuários aos quais o conteúdo do painel será visível ou você pode ver mais opções, definindo os valores de propriedade importantes para o painel.

  7. No lado direito da Galeria trecho, sob sobre este componente, clique ou selecione cabeçalhos de seção para expandir ou recolher grupos de propriedades e, em seguida, configure quaisquer configurações personalizadas que você deseja.

  8. Depois de configurar todas as propriedades, escolha a atualização. Isso atualiza o trecho de código HTML no lado esquerdo da página, para que a marcação reflete suas configurações personalizadas. Você sempre pode escolher Redefinir para retornar todas as propriedades para suas configurações padrão.

  9. No lado esquerdo da Galeria trecho, sob Trecho HTML, escolha Copiar para área de transferência.

  10. No seu editor de HTML, abra a unidade de rede mapeada no seu computador e abra o arquivo HTML para a página mestra ou layout de página que você está adicionando o trecho de código para.

  11. No arquivo HTML, cole o trecho de onde você deseja que a marca seja exibida.

    Se você estiver adicionando o trecho de código a um layout de página, certifique-se colar o trecho de PlaceHolderMain.

  12. Substituir o <div> onde class="DefaultContentBlock" com seu próprio conteúdo específico.

  13. Salve a página e, em seguida, atualize a visualização do servidor no Gerenciador de Design para certificar-se de que o painel de segurança Trim aparece como esperado.

Como entender as marcações de trecho

As partes mais importantes de um trecho de corte de segurança são a propriedade AuthenticationRestrictions e a propriedade Permissions e o <div> em negrito abaixo. AuthenticationRestrictions aparece na marcação somente quando alterado de AllUsers, que é o padrão. Se você escolher Redefinir para o trecho de código na Galeria de trechos, AuthenticationRestrictions é removido da marcação, o que significa que o trecho de código usa o valor padrão, AllUsers.

O <div> onde class="DefaultContentBlock" é o que você substitua seu próprio conteúdo, que pode incluir outros trechos e controles.

<div data-name="SecurityTrimmedAuthors">
    <!--CS: Start Security Trim Snippet-->
    <!--SPM:<%@Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <!--MS:<SharePoint:SPSecurityTrimmedControl runat="server" AuthenticationRestrictions="AuthenticatedUsersOnly" Permissions="AddAndCustomizePages" PermissionContext="RootSite">-->
        <!--PS: Start of READ-ONLY PREVIEW (do not modify)--><span><!--PE: End of READ-ONLY PREVIEW-->
        <div class="DefaultContentBlock" style="border:medium black solid; background:yellow; color:black; margin:20px; padding:10px;">
        You should replace this div with content that renders based on your Security Trim Properties.
        </div>
        <!--PS: Start of READ-ONLY PREVIEW (do not modify)--></span><!--PE: End of READ-ONLY PREVIEW-->
    <!--ME:</SharePoint:SPSecurityTrimmedControl>-->
    <!--CE: End Security Trim Snippet-->
</div>

Confira também