Power Platform

Acesso por grupo do Entra ID no Power Apps sem liberar um a um

Luiz Antonio Sgargeta
- Sócio fundador e CEO da Trinapse, IA aplicada, Microsoft 365 e Power Platform
· 15 min de leitura
Entrar no grupo já dá app, perfil e ambiente

Em resumo

  • O acesso por grupo do Entra ID no Power Apps funciona ligando um grupo de segurança a uma equipe do Dataverse do tipo grupo do Entra ID, que carrega o perfil de segurança, e restringindo o ambiente a esse grupo ou a um grupo que o contenha.
  • O app model-driven é liberado pelo perfil de segurança e não pelo grupo; o canvas app pode ser compartilhado direto com o grupo, mas os dados continuam protegidos pelo perfil da equipe.
  • O membro novo só vira usuário do ambiente e da equipe no primeiro acesso, então ele não aparece para atribuição antes de entrar, a menos que a sincronização seja forçada.
  • Cada usuário continua precisando de licença compatível com Dataverse, e esconder botão por perfil dentro do app não é segurança, porque a proteção está no dado.
  • Este caminho não serve para app que grava em lista do SharePoint sem Dataverse, porque nesse caso quem manda é a permissão da lista.

Como configurar o acesso por grupo do Entra ID no Power Apps sem liberar um a um?

Crie um grupo de segurança no Entra ID, crie no ambiente uma equipe do Dataverse do tipo grupo do Entra ID apontando para esse grupo, atribua à equipe o perfil de segurança mínimo do app e restrinja o ambiente ao grupo. Depois disso, entrar no grupo ou sair dele concede ou retira app, perfil e ambiente, e o caminho vale para qualquer app corporativo sobre Dataverse, model-driven ou canvas, que é o ponto em que a liberação individual já virou chamado semanal.

O mecanismo está descrito em Manage group teams, no Microsoft Learn: a equipe do Dataverse aponta para um grupo do Microsoft Entra ID, os membros do grupo passam a ser membros da equipe e os perfis atribuídos à equipe valem para cada um deles, então a TI mexe no grupo e o Dataverse acompanha. O roteiro abaixo fala sobre compartilhar um app model-driven com um grupo de segurança, com o caminho de menu que o centro de administração da Power Platform usa hoje, que mudou desde aquele texto, e com as armadilhas que só aparecem em sustentação.

Pense num app de solicitações internas usado por todas as agências de uma cooperativa de crédito, onde a central de atendimento, o time de crédito e a retaguarda abrem e acompanham pedidos. A cada admissão, transferência de agência ou desligamento chega um chamado para a TI incluir ou retirar a pessoa do app, do perfil e do ambiente, três ajustes em três telas, e alguém esquece um deles uma vez por mês. Com a equipe ligada ao grupo, os três ajustes viram um só, e a TI decide quem é dono do grupo sem precisar abrir o Dataverse a cada mudança.

O caminho só faz sentido quando existe Dataverse por trás do app. Se o app grava em lista do SharePoint, a permissão da lista é quem decide o que cada pessoa vê, e o grupo do Entra ID entra ali, não numa equipe do Dataverse. Para tabelas, relacionamentos e o jeito como o perfil de segurança decide o que cada pessoa enxerga, o conceito está em Dataverse por dentro: tabelas, relacionamentos e segurança, e aqui só usamos o resultado dele.

O que precisa estar pronto antes de começar

  • Um ambiente da Power Platform com Dataverse, e o papel de Administrador do sistema (System Administrator) nele para criar equipe e editar perfis, conforme a documentação de segurança do Dataverse.
  • Permissão no Entra ID para criar grupos, como Administrador de grupos (Groups Administrator) ou Administrador de usuários (User Administrator), conforme a referência de funções do Entra ID.
  • Papel de administrador da Power Platform para alterar o grupo de segurança do ambiente, como descrito em Control user access to environments.
  • Licença compatível com Dataverse para cada usuário do grupo, porque o grupo dá acesso e não dá licença; o resumo de licenciamento da Power Platform mostra quais planos cobrem o app que você vai liberar.
  • O app já publicado no ambiente, model-driven ou canvas sobre Dataverse, para que o perfil possa ser conferido contra as tabelas que ele realmente usa.

Passo a passo: do grupo ao primeiro acesso

A ordem importa porque cada peça depende da anterior: o grupo precisa existir para a equipe apontar para ele, o perfil precisa existir para a equipe recebê-lo, e o ambiente só deve ser restringido quando o grupo já tem as pessoas certas. Os nomes de menu abaixo seguem a interface em inglês, com a tradução entre parênteses, porque o centro de administração muda de rótulo com o idioma do navegador e com as atualizações.

Sete passos em sequência: grupo no Entra ID, perfil mínimo, equipe de grupo, perfil na equipe, ambiente, app e teste.

O passo 3 concentra a armadilha: a equipe nasce vazia e só recebe cada membro no primeiro acesso dele ao ambiente.

1. Criar o grupo de segurança no Entra ID

O grupo é a única peça que a TI vai mexer no dia a dia, então nomeie por app e por papel, como SG-App-Solicitacoes-Usuarios, para que ninguém reaproveite o grupo de outra coisa e acabe dando acesso sem querer. Use o tipo Segurança (Security) e deixe os usuários como membros diretos, porque a equipe do Dataverse lê quem está nesse grupo e é mais fácil auditar um grupo sem camadas dentro dele.

  1. Abra o centro de administração do Microsoft Entra (entra.microsoft.com) e vá em Identidade (Identity), Grupos (Groups), Todos os grupos (All groups) e Novo grupo (New group).
  2. Em Tipo de grupo (Group type), escolha Segurança (Security), informe o nome e deixe o Tipo de associação (Membership type) como Atribuído (Assigned).
  3. Em Proprietários (Owners), coloque quem vai administrar a entrada e a saída de pessoas, e em Membros (Members) coloque os primeiros usuários.
  4. Selecione Criar (Create).

Quem prefere criar por script, por exemplo para repetir o padrão em vários apps, pode usar o módulo Microsoft Graph PowerShell, porque ele deixa o desenho do grupo registrado em um arquivo que a TI consegue reaproveitar e revisar depois. O bloco abaixo conecta com o escopo mínimo para gerenciar grupos, cria o grupo de segurança e adiciona um usuário como membro direto, então basta trocar o nome do grupo e o e-mail pelos seus.

powershell
# Conecta com permissão para criar grupos e alterar membros
Connect-MgGraph -Scopes "Group.ReadWrite.All","User.Read.All"

# Cria o grupo de segurança (sem e-mail, com segurança habilitada)
$grupo = New-MgGroup -DisplayName "SG-App-Solicitacoes-Usuarios" `
-MailEnabled:$false `
-MailNickname "sg-app-solicitacoes-usuarios" `
-SecurityEnabled:$true

# Adiciona um usuário como membro direto
$usuario = Get-MgUser -UserId "maria.souza@cooperativa.exemplo"
New-MgGroupMember -GroupId $grupo.Id -DirectoryObjectId $usuario.Id

2. Definir o perfil de segurança mínimo no ambiente

O perfil é o que de fato decide o que a pessoa lê e grava, então ele precisa nascer pequeno: parta de uma cópia do perfil Usuário Básico (Basic User) e dê privilégio só nas tabelas que o app usa. No app de solicitações, por exemplo, o atendente da agência cria, lê e altera as próprias solicitações (nível de acesso Usuário) e só lê as tabelas de apoio, como tipo de solicitação e agência (nível Organização), e a coordenação ganha um segundo perfil, em outro grupo, com leitura no nível da unidade de negócios.

  1. No centro de administração da Power Platform, vá em Gerenciar (Manage), Ambientes (Environments) e selecione o ambiente.
  2. Abra Configurações (Settings), Usuários + permissões (Users + permissions) e Perfis de segurança (Security roles).
  3. Selecione o perfil Usuário Básico, escolha Copiar perfil (Copy role) e dê um nome como Solicitacoes - Usuario.
  4. Na aba Tabelas (Tables) do perfil copiado, ajuste os níveis de acesso das tabelas do app e salve.

A pegadinha desse passo é o privilégio que falta numa tabela de apoio, porque o app abre e a tela de lista sai vazia ou com erro só para quem tem o perfil mínimo. Teste o perfil com um usuário comum antes de seguir, e não com a conta de administrador, que enxerga tudo e esconde o problema.

3. Criar a equipe do tipo grupo do Entra ID

Esta é a peça que liga o Entra ID ao Dataverse, e por isso ela costuma confundir quem testa pela primeira vez: a equipe nasce vazia mesmo com o grupo cheio, o que é o comportamento esperado, porque o membro só é trazido para a equipe quando acessa o ambiente pela primeira vez.

  1. No mesmo ambiente, abra Configurações (Settings), Usuários + permissões (Users + permissions) e Equipes (Teams), e selecione Criar equipe (Create team).
  2. Em Nome da equipe (Team name), repita o nome do grupo para que a correspondência seja óbvia, e em Unidade de negócios (Business unit) deixe a unidade padrão do ambiente, a menos que o desenho de segurança já use outra.
  3. Em Administrador (Administrator), indique uma pessoa responsável da TI.
  4. Em Tipo de equipe (Team type), escolha Grupo de segurança do Microsoft Entra ID (Microsoft Entra ID Security Group), e em Nome do grupo (Group name) selecione o grupo criado no passo 1.
  5. Em Tipo de associação (Membership type), escolha entre Membros (Members), Proprietários (Owners), Convidados (Guests) ou Membros e convidados (Members and guests).
  6. Selecione Avançar (Next).

A escolha do tipo de associação define quem do grupo entra na equipe, e o normal é Membros, que traz quem está no grupo como membro. Use Membros e convidados quando o grupo tiver contas de fora da organização, como um prestador que atua numa agência, e Proprietários apenas se quiser que quem administra o grupo também vire parte da equipe, o que raramente é o desejado num app de operação. Os tipos estão detalhados em Manage group teams.

4. Atribuir o perfil de segurança à equipe

Na tela seguinte do assistente, selecione o perfil criado no passo 2 e confirme com Salvar (Save). Na página de gerenciamento da equipe, a lista de membros aparece vazia, e não há erro nisso. Se precisar trocar o perfil depois, volte à equipe e use Gerenciar perfis de segurança (Manage security roles), porque o perfil mora na equipe e não em cada pessoa, e é isso que faz o acesso acompanhar o grupo.

5. Restringir o ambiente ao grupo

Sem esse passo, qualquer pessoa da organização com licença pode ser adicionada ao ambiente, o que enfraquece o controle que você acabou de montar. Há dois desenhos possíveis: usar o próprio grupo do app, que é o mais simples quando o ambiente tem um app só, ou criar um grupo de ambiente (por exemplo SG-Ambiente-Operacoes) que contém como membro o grupo do app, como Devaney faz, o que permite acrescentar outros grupos de outros apps no mesmo ambiente sem abrir o acesso de um app para os usuários do outro.

  1. Na página do ambiente no centro de administração da Power Platform, vá ao bloco Detalhes (Details) e selecione Editar (Edit).
  2. No campo Grupo de segurança (Security group), selecione o grupo de ambiente e salve.

Antes de salvar, confira quem já usa o ambiente: segundo Control user access to environments, o grupo de segurança passa a ser o critério de entrada, então um usuário que já está no ambiente e fica fora do grupo perde o acesso. Faça primeiro num ambiente de homologação e valide com o grupo aninhado, se for o desenho escolhido, porque é o teste do passo 7 que confirma que o aninhamento funciona no seu tenant.

6. Compartilhar o app

O app model-driven não é compartilhado com o grupo, e sim com o perfil de segurança, e é por isso que a equipe precisa ter o perfil. O canvas app, ao contrário, aceita o grupo direto no painel de compartilhamento, mas o dado continua dependendo do perfil que a equipe carrega, então os dois passos se somam.

Para o app model-driven, abra o Power Apps, escolha o ambiente, vá em Aplicativos (Apps), selecione o app e use Compartilhar (Share). Escolha o perfil Solicitacoes - Usuario e confirme, como descreve o Microsoft Learn sobre compartilhar app model-driven. Se o usuário de teste ainda não abrir o app mesmo com o perfil liberado, confirme na equipe que o perfil está de fato atribuído a ela, porque há relatos de que o compartilhamento sozinho não basta.

Para o canvas app, use Compartilhar (Share) no app, digite o nome do grupo e dê a permissão de uso, conforme Share a canvas app with your organization. Duas armadilhas costumam aparecer aqui: o grupo do Microsoft 365 só aparece na busca se estiver com a segurança habilitada, e a regra de compartilhamento do ambiente gerenciado pode impedir compartilhar com grupos de segurança, o que se confere nas configurações de compartilhamento do ambiente, descritas na visão geral de ambientes gerenciados. Se o grupo não aparece e a regra está bloqueando, a decisão é da governança da Power Platform e não do dono do app.

Evite compartilhar o app direto com o grupo e, ao mesmo tempo, criar a equipe à mão. Um comentário no texto do Devaney relata que o compartilhamento direto cria uma equipe com o nome do grupo, e quem criou a sua também fica com duas equipes lado a lado, uma com o perfil certo e outra sem, o que confunde a sustentação. Escolha um caminho e documente qual é.

Uma observação sobre segurança vale aqui: esconder um botão ou uma tela para quem tem o perfil de coordenação ausente deixa o app mais limpo, mas não impede ninguém de chegar ao dado por outro caminho, como uma exportação, uma visão ou outro app sobre as mesmas tabelas. A segurança está no perfil e no nível de acesso da tabela, e o que o app esconde é só conveniência.

7. Testar com um usuário novo

Peça a alguém que acabou de entrar no grupo, e que nunca abriu o ambiente, para abrir o app pelo link. Na primeira abertura o Dataverse cria o usuário no ambiente, coloca-o na equipe e aplica o perfil, e só então ele aparece nas listas de usuários e da equipe. O reflexo prático é que o usuário novo não aparece para atribuição de registro, por exemplo como responsável por uma solicitação, até ter entrado ao menos uma vez.

Quando a TI precisa que a pessoa já exista antes do primeiro acesso, há como forçar a sincronização dos membros do grupo para a equipe. Matthew Devaney descreve o procedimento em outro texto, Force Sync Users From Entra Security Group To Dataverse Team, e do lado da API do Dataverse o nome a procurar é a ação SyncGroupMembersToTeam; confira a assinatura na referência da Web API e rode primeiro num ambiente de teste, porque a ação traz de uma vez todos os membros do grupo para o ambiente, e convém ter revisado o grupo antes.

Como validar que deu certo

Com o usuário novo, o critério é objetivo: ele abre o app pelo link sem tela de acesso negado, vê as solicitações do próprio nível de acesso e consegue criar uma. Depois, no centro de administração, em Configurações, Usuários + permissões, Usuários (Users), ele aparece como habilitado, e na página da equipe ele aparece na lista de membros, com o perfil herdado da equipe.

Faça também o caminho inverso, porque o que protege a cooperativa é a saída: retire o usuário do grupo e confirme que o acesso é revogado. Isso não é instantâneo, já que a equipe só reconcilia os membros em novos acessos ou numa sincronização, então para desligamento mantenha o bloqueio da conta no Entra ID como controle principal e trate a saída do grupo como a limpeza que acompanha.

Erros comuns e o que fazer

A equipe está vazia, embora o grupo tenha gente. É o comportamento esperado até o primeiro acesso de cada pessoa ao ambiente, então, se a TI precisa dos usuários antes disso, use a sincronização forçada do passo 7.

O app abre, mas a lista vem vazia ou aparece uma mensagem como "Principal user (Id=...) is missing prvReadNomeDaTabela privilege". O perfil da equipe não tem leitura numa tabela que o app usa; volte ao passo 2, abra o perfil na aba Tabelas e conceda o privilégio no nível adequado. O prefixo prvRead seguido do nome da tabela diz qual é.

No primeiro acesso, um fluxo ou uma carga de dados falha só para o usuário novo. Como o perfil chega junto com o primeiro acesso, nessa primeira execução a pessoa pode ainda não ter todos os privilégios, o que já derrubou um fluxo disparado na abertura do app num caso relatado nos comentários do texto do Devaney. A saída é avisar na primeira execução que o app precisa ser recarregado, ou evitar dependência de privilégios da equipe nessa carga inicial.

O grupo não aparece ao compartilhar o canvas app. Verifique primeiro se é um grupo do Microsoft 365 sem segurança habilitada, e depois se a regra de compartilhamento do ambiente gerenciado bloqueia grupos de segurança, porque qualquer um dos dois casos esconde o grupo na hora de compartilhar.

Duas equipes com o mesmo nome no ambiente. Costuma ser resultado de compartilhar o app com o grupo depois de criar a equipe manualmente, então decida qual equipe fica, mova o perfil para ela e remova a outra depois de conferir que ninguém depende dela.

O usuário está no grupo, entra no app e é barrado pela licença. O grupo não licencia ninguém, então a licença precisa vir de outro lugar: se a TI já usa licenciamento por grupo no Entra ID, descrito em Assign licenses to users by group membership, o mesmo grupo pode carregar a licença, desde que o plano de licenciamento do tenant permita.

O que levar para quem aprova

Depois de pronto, dar e tirar acesso ao app corporativo vira incluir ou retirar a pessoa de um grupo do Entra ID, e o perfil, a equipe do Dataverse e o acesso ao ambiente acompanham sem chamado para mexer em tela da Power Platform. O custo está na licença, porque cada usuário continua precisando de licença compatível com Dataverse, no esforço de desenhar grupo, equipe e perfil uma vez por app e testar a entrada e a saída, e na sustentação, que passa a ser a revisão periódica de dono e membros de cada grupo. O risco fica sob controle da TI porque a segurança mora no perfil e no dado, o desligamento continua apoiado no bloqueio da conta no Entra ID e tudo está registrado em objetos que a TI já administra depois que o fornecedor sai.

Se ajudar, a Trinapse monta com a TI o desenho de grupos, equipes e perfis por app num resumo de uma página, pronto para o gerente de TI aprovar, e depois acompanha o primeiro teste de entrada e saída, para que o desenho seja conferido na prática antes de virar padrão.

Luiz Antonio Sgargeta
Sócio fundador e CEO da Trinapse, IA aplicada, Microsoft 365 e Power Platform

Luiz Antonio Sgargeta é sócio fundador e CEO da Trinapse, consultoria brasileira de Microsoft 365 com quase duas décadas de operação, acumula mais de 20 anos em desenvolvimento de software e em ambientes corporativos de alta complexidade.

Ver maisVer menos

Trabalha com SharePoint desde o SharePoint Portal Server 2003 e com .NET desde a versão 1.0. Acompanhou a plataforma em todas as suas reinvenções, do portal de documentos on-premises ao SharePoint Online dentro do Microsoft 365, o que dá a ele uma leitura rara sobre o que muda de verdade e o que é apenas nome novo para o mesmo problema.

No início da carreira atuou em uma das maiores operações de e-commerce do país, em sistemas que não toleram degradação de performance nem indisponibilidade, essa origem definiu o critério que ele aplica até hoje: solução boa é a que sustenta volume real, integra com o legado que já existe e não quebra no pico.

Depois disso, passou por praticamente todo tipo de projeto corporativo, de portais e intranets de milhares de usuários a integrações críticas e automação de processos de ponta a ponta, sempre em grandes empresas e em desafios de alta exigência.

A marca do trabalho dele é a tradução entre tecnologia e negócio, levanta a necessidade real por trás do pedido do cliente, questiona o processo antes de automatizá-lo e desenha a solução pelo resultado esperado, não pela ferramenta disponível, é o que permite conversar com a diretoria sobre retorno e com o time técnico sobre arquitetura na mesma reunião.

Hoje lidera a frente comercial e estratégica da Trinapse e conduz a empresa no novo ciclo da inteligência artificial, com foco em agentes de IA e operação de processos assistida por IA para cooperativas de crédito, agronegócio e indústria. Escreve no blog da Trinapse desde 2019, com mais de 450 artigos sobre IA, SharePoint, Power Platform, Modern Workplace e transformação de processos, sempre a partir de projeto entregue e não de teoria.

LinkedIn
Compartilhar:

Precisa aplicar isso na sua empresa? Fale com nossos especialistas.

Falar com um especialista