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

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.

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.
- 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).
- 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).
- 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.
- 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.
# 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.Id2. 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.
- No centro de administração da Power Platform, vá em Gerenciar (Manage), Ambientes (Environments) e selecione o ambiente.
- Abra Configurações (Settings), Usuários + permissões (Users + permissions) e Perfis de segurança (Security roles).
- Selecione o perfil Usuário Básico, escolha Copiar perfil (Copy role) e dê um nome como
Solicitacoes - Usuario. - 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.
- No mesmo ambiente, abra Configurações (Settings), Usuários + permissões (Users + permissions) e Equipes (Teams), e selecione Criar equipe (Create team).
- 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.
- Em Administrador (Administrator), indique uma pessoa responsável da TI.
- 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.
- Em Tipo de associação (Membership type), escolha entre Membros (Members), Proprietários (Owners), Convidados (Guests) ou Membros e convidados (Members and guests).
- 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.
- Na página do ambiente no centro de administração da Power Platform, vá ao bloco Detalhes (Details) e selecione Editar (Edit).
- 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, 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.



