Exercício: proteger o acesso aos dados do Dataverse

  • 15 minutos

O objetivo deste laboratório prático é usar o Power Pages Design Studio para criar uma página da Web segura que exiba os dados do Dataverse.

Ao fim destes exercícios, você poderá executar as seguintes tarefas no Power Pages Design Studio:

  • Adicionar novas colunas a uma tabela do Dataverse.
  • Criar novas exibições para uma tabela do Dataverse.
  • Adicionar um componente de lista a uma página da Web.
  • Aplicar permissões de página e de tabela para proteger os dados

Para este exercício, você precisará ter o seguinte:

Cenário

A empresa gostaria de ter uma página de diretório em seu site com a lista de contas do Dataverse, incluindo colunas de nome, email e número de telefone. Por motivos de privacidade, esse diretório deve ser acessível somente para usuários autenticados. Por padrão, as contas não devem ser incluídas no diretório, mas devem aceitar ser incluídas nele.

Etapas de alto nível

  1. Abra seu site no estúdio de design do Power Pages.
  2. Usando o espaço de trabalho Dados, adicione uma nova exibição e uma nova coluna de aceitação de coluna à tabela de contas.
  3. Adicione uma nova página e inclua um componente de lista. Adicione permissões de leitura para a tabela de contas.
  4. Restrinja o acesso às páginas somente a usuários autenticados.

Etapas detalhadas

Inicie o estúdio de design do Power Pages

  1. Entre no Power Pages.
  2. Selecione um ambiente de destino usando o seletor de ambiente no canto superior direito.
  3. Selecione seu site e a opção Editar para iniciar o estúdio de design.
  4. Selecione o espaço de trabalho Dados.

Modificações de tabela

  1. Selecione a tabela Conta. Captura de tela da tabela de conta selecionada no espaço de trabalho Dados.

  2. Selecione o botão + mais, selecione a coluna Email (encontre a coluna rapidamente digitando email na caixa de texto de pesquisa) e pressione Salvar para adicionar a coluna à exibição. Captura de tela do diálogo Mostrar coluna existente para adicionar a coluna Email à exibição de dados.

  3. Crie a coluna de aceitação.

    1. Pressione + Nova coluna.
    2. Insira Mostrar no diretório para o Nome para exibição.
    3. Selecione Opção > Sim/Não para o Tipo de dados.
    4. Defina Opção padrão como Não.
    5. Pressione Salvar.

    Captura de tela da adição de nova coluna Mostrar no diretório sim/não à tabela de conta.

  4. Verifique se a tabela de conta tem pelo menos 8-10 linhas de dados; insira mais algumas linhas, conforme necessário ao preencher as colunas de Telefone Principal e Email. Defina o sinalizador Mostrar no diretório como true para algumas das linhas. Captura de tela da tabela de conta com algumas linhas de dados inseridas.

  5. Criar nova exibição

    1. Selecione a guia Exibições.
    2. Insira Diretório como o Nome da exibição.
    3. Pressione Criar.
    4. Pressione + Exibir coluna e localize e selecione Telefone principal.
    5. Pressione + Exibir coluna novamente e localize e selecione Email.
    6. Expanda o painel Propriedades da exibição e selecione Editar filtros.
    7. Pressione + Adicionar > Adicionar linha, selecione a coluna Status, defina Igual como condição e selecione Ativo para o valor.
    8. Pressione + Adicionar > Adicionar linha, selecione a coluna Mostrar no diretório, defina Igual como condição e selecione Sim como o valor.
    9. Pressione OK.

    Captura de tela das condições de filtro da exibição.

  6. Observe que, agora, as linhas estão restritas às linhas nas quais a opção Mostrar no diretório está definida como Sim.

  7. Selecione Classificar por e, depois, Nome da conta.

  8. A exibição deverá ter esta aparência: Captura de tela de exibição concluída da página de diretório.

  9. Pressione Salvar e, depois, Publicar exibição.

Criar uma página da Web

  1. Selecione o espaço de trabalho Páginas.

    Captura de tela do estúdio de design do Power Pages com um site no modo de edição.

  2. Selecione o botão + Página.

  3. Insira Diretório como o nome da página.

  4. Selecione o layout padrão Começar do zero e pressione Adicionar.

  5. Selecione Lista na seção Escolha um componente para adicionar a esta seção.Captura de tela da página criada com o layout Começar do zero.

  6. Selecione a tabela Conta e a lista Diretórios e pressione OK. Captura de tela do diálogo Criar lista com tabela de conta e exibição de diretório selecionadas.

  7. Agora, a página deverá ter esta aparência: Captura da página de diretório com o componente lista criado e configurado, mas sem permissões aplicadas.

Adicionar permissões

Se você visualizar a página agora, o componente de lista exibirá: "Você não tem permissões para exibir esses registros". Essa exibição é esperada porque, por padrão, não há permissões para acessar as linhas, independentemente das funções do usuário.

  1. Configurar permissões de tabela

    1. Pressione o botão +Nova permissão.
    2. Insira Leitura da Conta para o Nome.
    3. Selecione Conta para a Tabela.
    4. Marque Leitura em Permissões para.
    5. Selecione + Adicionar funções e marque Usuários Autenticados.
    6. Pressione Salvar.

    Captura de tela das permissões de tabela configuradas para tabela de conta.

  2. Selecione Visualizar > Área de Trabalho.

  3. A lista exibirá uma mensagem de erro se você não estiver conectado. Nesse caso, pressione Entrar, selecione a opção do Microsoft Entra ID e entre com suas credenciais do Azure, se solicitado. Você pode ser levado para sua página de perfil. Nesse caso, selecione Diretório no menu.

  4. A lista deve ser exibida agora. Teste a classificação clicando em cabeçalhos de coluna. Página concluída com a lista de contas exibida.

  5. Selecione seu nome de usuário e, depois, Sair. Agora a lista deve exibir a mensagem de erro.

  6. Restrinja o acesso às páginas somente a usuários autenticados.

    1. No espaço de trabalho Página, selecione a página Diretório.
    2. Selecione as reticências e Configurações de página.
    3. Selecione a guia Permissões.
    4. Selecione Desejo escolher quem pode ver esta página e, depois, Usuários Autenticados na lista de funções.
    5. Pressione OK.

    Captura de tela do diálogo de propriedades da página com a guia Permissões selecionada e o acesso à página restrito somente a usuários autenticados.

  7. Selecione Visualizar > Área de Trabalho. Observe que você é redirecionado para a página de entrada, e o link de Diretório não está mais na navegação.

    Importante

    Os visitantes anônimos, a quem era negado anteriormente apenas o acesso à lista de contas na página, não têm mais visibilidade ou acesso à página inteira. As permissões de página protegem toda a página, independentemente de quais componentes estão presentes. As permissões de tabela regem o acesso às linhas da tabela, independentemente de onde a tabela é usada no site.

  8. Captura de tela da página de entrada padrão no Power Pages.

  9. Entre usando o Microsoft Entra ID. O link de Diretório será exibido na navegação, e você poderá acessar a página e a lista de contas.