Como usar o controle de acesso baseado em função para aplicativos

Aplica-se a: Locatários da força de trabalho Locatários externos (saiba mais)

O RBAC (controle de acesso baseado em função) é um mecanismo comum usado para impor a autorização em aplicativos. Quando uma organização usa o RBAC, um desenvolvedor de aplicativos define as funções para o aplicativo. Em seguida, um administrador pode atribuir funções a diferentes usuários e grupos para controlar quem tem acesso ao conteúdo e à funcionalidade no aplicativo.

Normalmente, os aplicativos recebem informações de função de usuário como declarações em um token de segurança. Os desenvolvedores têm a flexibilidade de fornecer sua própria implementação de como as declarações de função devem ser interpretadas como permissões de aplicativo. Essa interpretação de permissões pode envolver o uso de middleware ou de outras opções fornecidas pela plataforma dos aplicativos ou por bibliotecas relacionadas.

Funções de aplicativo

A ID Externa do Microsoft Entra permite que você defina funções de aplicativo para o seu aplicativo e atribua essas funções a usuários e grupos. As funções atribuídas a um usuário ou grupo definem seu nível de acesso aos recursos e operações em seu aplicativo.

Quando a ID externa do Microsoft Entra emite um token de segurança para um usuário autenticado, ela inclui os nomes das funções que você atribuiu ao usuário ou grupo na declaração de funções do token de segurança. Um aplicativo que recebe esse token de segurança em uma solicitação pode, então, tomar decisões de autorização com base nos valores na declaração de funções.

Grupos

Os desenvolvedores também podem usar grupos de segurança para implementar o RBAC nos aplicativos, em que as associações do usuário em grupos específicos são interpretadas como as associações de função. Quando uma organização usa grupos de segurança, uma declaração de grupos é incluída no token. A declaração de grupos especifica os identificadores de todos os grupos aos quais o usuário está atribuído no locatário externo atual.

Funções de aplicativo versus grupos

Embora você possa usar funções de aplicativo ou grupos para autorização, as principais diferenças entre eles podem influenciar o que você decidir usar para seu cenário.

Adicionar um grupo de segurança

Os grupos de segurança gerenciam o acesso do computador e do usuário aos recursos compartilhados. Você pode criar um grupo de segurança para que todos os membros do grupo tenham o mesmo conjunto de permissões de segurança.

Para criar um grupo de segurança, siga as etapas a seguir:

1. Entre no Centro de administração do Microsoft Entra como, no mínimo, um Administrador de Grupos.
2. Se você tiver acesso a vários locatários, use o ícone Configurações no menu superior para alternar para o locatário externo no menu Diretórios + assinaturas.
3. Navegue atéIdentidade>Grupos>Todos os grupos.
4. Selecione Novo grupo.
5. No lista suspensa Tipo de grupo, selecione Segurança.
6. Insira o Nome do grupo para o grupo de segurança, como Contoso_App_Administrators.
7. Inserir Descrição do grupo para o grupo de segurança, como Administrador de segurança do aplicativo Contoso.
8. Selecione Criar.

O novo grupo de segurança aparece na lista Todos os grupos. Se você não o vir imediatamente, atualize a página.

A ID externa do Microsoft Entra pode incluir informações da associação de grupo de um usuário em tokens para uso em aplicativos. Saiba como adicionar a reivindicação de grupo aos tokens na seção Atribuir usuários e grupos a funções.

Declarar funções para um aplicativo

1. Entre no Centro de administração do Microsoft Entra como, no mínimo, um Administrador de funções com privilégios.

2. Se você tiver acesso a vários locatários, use o ícone Configurações no menu superior para alternar para o seu locatário externo do menu Diretórios + assinaturas.

3. Navegue até Identidade>Aplicativos>Registros do aplicativo.

4. Selecione o aplicativo no qual deseja definir funções.

5. Selecionar Funções de aplicativo e selecione Criar função de aplicativo.

6. No painel Criar função de aplicativo, insira as configurações para a função. A tabela a seguir descreve cada configuração e seus parâmetros.

   Campo	Descrição	Exemplo
   Nome de exibição	Nome para exibição da função do aplicativo que aparece nas experiências de atribuição de aplicativo. Esse valor pode conter espaços.	Orders manager
   Tipos de membro permitidos	Especifica se essa função de aplicativo pode ser atribuída a usuários, aplicativos ou ambos.	Users/Groups
   Valor	Especifica o valor da declaração de funções que o aplicativo deve esperar no token. O valor deve corresponder exatamente à cadeia de caracteres referenciada no código do aplicativo. O valor não pode conter espaços.	Orders.Manager
   Descrição	Uma descrição mais detalhada da função de aplicativo exibida durante as experiências de atribuição do aplicativo de administração.	Manage online orders.
   Deseja habilitar esta função de aplicativo?	Especifica se a função de aplicativo está habilitada. Para excluir uma função de aplicativo, desmarque essa caixa de seleção e aplique a alteração antes de tentar a operação de exclusão.	Verificado

7. Selecione Aplicar para criar a função de aplicativo.

Atribuir usuários e grupos a funções

Após adicionar funções de aplicativo em seu aplicativo, o administrador pode atribuir usuários e grupos a essas funções. A atribuição de usuários e grupos a funções pode ser feita por meio do centro de administração ou de maneira programática usando o Microsoft Graph. Quando os usuários atribuídos às várias funções de aplicativo entrarem no aplicativo, seus tokens terão suas funções atribuídas na declaração roles.

Para atribuir usuários e grupos às funções de aplicativo usando o portal do Azure:

1. Entre no Centro de administração do Microsoft Entra como, no mínimo, um Administrador de funções com privilégios.
2. Se você tiver acesso a vários locatários, use o ícone Configurações no menu superior para alternar para o seu locatário externo do menu Diretórios + assinaturas.
3. Navegue até Identidade>Aplicativos>Aplicativos empresariais.
4. Selecione Todos os aplicativos para exibir uma lista com todos os seus aplicativos. Se o aplicativo não aparecer na lista, use os filtros na parte superior da lista Todos os aplicativos para restringir a lista ou percorra a lista para localizar a lista para localizar seu aplicativo.
5. Selecione o aplicativo no qual deseja atribuir funções a usuários ou grupos de segurança.
6. Em Gerenciar, selecione Usuários e grupos.
7. Selecione Adicionar usuário para abrir o painel Adicionar atribuição.
8. No painel Adicionar Atribuição, selecione Usuários e grupos. Uma lista de usuários e grupos de segurança será exibida. Você pode selecionar vários usuários e grupos na lista.
9. Depois de selecionar usuários e grupos, escolha Selecionar.
10. No painel Adicionar Atribuição, escolha Selecionar uma função. Todas as funções definidas para o aplicativo serão exibidas.
11. Selecione uma função e escolha Selecionar.
12. Selecione Atribuir para finalizar a atribuição de usuários e grupos para o aplicativo.
13. Veja se os usuários e grupos que você adicionou aparecem na lista atualizada de Usuários e grupos.

Para testar seu aplicativo, saia e entre novamente com o usuário que você atribuiu às funções. Inspecione o token de segurança para garantir que ele contenha a função do usuário.

Adicionar declarações de grupo a tokens de segurança

Para emitir as declarações de associação de grupo em tokens de segurança, siga estas etapas:

1. Entre no Centro de administração do Microsoft Entra pelo menos como um Administrador de Aplicativo.
2. Se tiver acesso a vários locatários, use o ícone Configurações no menu superior para alternar para o seu locatário externo no menu Diretórios + assinaturas.
3. Navegue até Identidade>Aplicativos>Registros de aplicativo.
4. Selecione o aplicativo ao qual você quer adicionar usuários convidados.
5. Em Gerenciar, selecione Configuração de token.
6. Selecione Adicionar declaração de grupos.
7. Selecione os tipos de grupo para incluir nos tokens de segurança.
8. Em Personalizar propriedades de token por tipo, selecione ID do Grupo.
9. Selecione Adicionar para adicionar a declaração de grupos.

Adicionar membros a um grupo

Agora que você adicionou declarações de grupos de aplicativos no seu aplicativo, adicione usuários aos grupos de segurança. Se você não tiver um grupo de segurança, crie um.

1. Entre no Centro de administração do Microsoft Entra como, no mínimo, um Administrador de Grupos.
2. Se você tiver acesso a vários locatários, use o ícone Configurações no menu superior para alternar para o locatário externo no menu Diretórios + assinaturas.
3. Navegue atéIdentidade>Grupos>Todos os grupos.
4. Selecione o grupo que deseja gerenciar.
5. Selecione Membros.
6. Selecione + Adicionar membros.
7. Percorra a lista ou digite um nome na caixa de pesquisa. É possível escolher diversos nomes. Quando estiver pronto, escolha Selecionar.
8. A página Visão geral do grupo é atualizada para mostrar o número de membros que agora são adicionados ao grupo.

Para testar seu aplicativo, saia e entre novamente com o usuário que você adicionou ao grupo de segurança. Inspecione o token de segurança para verificar se ele contém a associação de grupo do usuário.

Suporte a funções de grupo e de aplicativo

Um locatário externo segue o modelo de gerenciamento de usuários e grupos e a atribuição de aplicativos do Microsoft Entra. Muitos dos principais recursos do Microsoft Entra estão sendo implementados em fases nos locatários externos.

A tabela a seguir mostra quais recursos estão disponíveis no momento.

Próximas etapas

• Aprenda a Usar o controle de acesso baseado em função em seu aplicativo Web.