Integrar ao Azure Active Directory

Artigo
03/09/2022
2 minutos para o fim da leitura

Neste artigo, veremos como integrar aplicativos criados usando o Power Apps no Microsoft Teams ao Azure Active Directory (AD).

A integração ao Azure AD habilita muitos recursos profundos na hierarquia da sua organização, as pessoas nas suas organizações e grupos. Por exemplo, você pode obter informações sobre uma pessoa, seu cargo, departamento ou foto. Você também pode obter informações sobre a hierarquia da organização do usuário, como seu gerente.

Essa integração também pode ser usada para conceder acesso a funcionalidades do aplicativo com base em sua função ou associação a um grupo e, portanto, ser usada para controlar a segurança de funcionalidades ou dados confidenciais.

Neste artigo, vamos criar um aplicativo do Power Apps com um botão que inclui acesso administrativo. A visibilidade do botão dependerá se o usuário é um membro do grupo de administradores ou não.

Assista a este vídeo para aprender como integrar o aplicativo do Power Apps ao Azure Active Directory:

Pré-requisitos

Para concluir esta lição, precisaremos da capacidade de criar aplicativos no Teams que estarão disponíveis como parte da seleção de assinaturas do Microsoft 365. Também precisaremos de acesso ao Azure AD para criar o grupo de administradores e atribuir membros a ele.

Faça logon no Teams usando o aplicativo Desktop ou o aplicativo Web.

Criar uma equipe

Nesta seção, criaremos uma nova equipe e, em seguida, criaremos um aplicativo dentro dessa equipe. Ignore esta seção se você já tem uma equipe que deseja usar em vez de criar uma nova.

Para criar uma nova equipe, selecione a guia Teams e, em seguida, selecione Ingressar em ou criar uma equipe na parte inferior esquerda da tela.
Selecione Criar Equipe > Do Zero > Pública, dê à equipe um nome como "Integração ao Azure AD" e selecione Criar.
(Opcional) Se houver membros na sua organização que você gostaria de adicionar à equipe para fins de teste, selecione-os e adicione-os na pop-up de adição de membros.
Selecione Fechar.

A nova equipe é criada e listada na guia Teams.

Criar um novo Grupo do Azure AD

Entre no portal do Azure usando a mesma conta com a qual você se conectou ao Teams anteriormente.
Na barra de pesquisa superior, pesquise e selecione Grupos.
Selecione + Novo Grupo.

Configure o grupo com os seguintes valores:

Opção	Valor
Tipo de grupo	Microsoft 365
Nome do grupo	Acesso de Administrador
Endereço de email do grupo	Atualizado automaticamente
Descrição do grupo	Grupo para usuários com acesso de administrador

Selecione Criar.
Copie a ID de objeto do grupo da tela de visão geral do grupo para uso posterior.

Criar um novo aplicativo

Vamos criar um aplicativo com um botão que só aparecerá se o usuário for um membro da equipe que criamos acima.

Abra o aplicativo do Teams.
Selecione Power Apps.
Selecione + Novo aplicativo em Aplicativos recentes.
Selecione a equipe criada anteriormente e, em seguida, selecione Criar.
O aplicativo é criado e o Power Apps Studio é aberto para permitir a edição do aplicativo.
Insira um nome para o aplicativo como "Integrar-se ao Azure AD" e, em seguida, selecione Salvar.
Selecione Dados > Adicionar dados.
Na lista de conectores, procure o Azure AD e selecione-o para adicioná-lo como uma conexão.
Selecione Conectar.
Entre e selecione Aceitar para se conectar.
No Modo de exibição de árvore, selecione + Nova tela para adicionar uma nova tela ao aplicativo.
Selecione o ícone + (Inserir) no painel esquerdo.
Selecione Botão.
Defina a propriedade "Texto" do botão como "Acesso de administrador".
Selecione + (Inserir) novamente e, em seguida, selecione o controle de rótulo a ser adicionado.
Atualize o texto do rótulo para "Nível de administrador:".
Selecione o aplicativo no modo de exibição de árvore e abra a propriedade OnStart na parte superior esquerda da tela.

Insira a fórmula a seguir para o aplicativo OnStart:

If(
    !IsEmpty(
        AzureAD.CheckMemberGroups(
            User().Email,
            ["Enter your Azure group ID here"]
        ).Value
    ),
    Set(varAdmin,true),
    Set(varAdmin,false)
)

Observação

Atualize a fórmula com a ID de grupo (GUID) para o grupo que você copiou anteriormente.

Selecione ... (reticências) ao lado do aplicativo e, em seguida, selecione Executar OnStart.
Selecione ... (reticências) ao lado de Configurações na faixa de opções superior e, em seguida, selecione para exibir variáveis. varAdmin é definido como Falso.
Selecione a Tela 2 no Modo de exibição de árvore e atualize a fórmula de texto do rótulo para "Admin Level: " & varAdmin. O rótulo será exibido atualmente como "Nível de administrador: falso" na tela.

Agora controlaremos a visibilidade do botão Acesso de Administrador para que ele apareça apenas quando o usuário for um administrador (por exemplo, pertencer ao grupo Acesso de administrador no Azure AD)
Selecione o botão e defina a propriedade Visível como "varAdmin".

O botão não aparece mais, pois não temos acesso de administrador.

Testar a integração

Entre no portal do Azure.
Selecione o grupo criado anteriormente.
Selecione Membros em Gerenciar no painel esquerdo.
Selecione + Adicionar membros para adicionar membros ao grupo.
Selecione usuários na lista de usuários em Adicionar membros para adicionar ao grupo.
Selecione Selecionar. Os usuários selecionados são adicionados ao grupo.
Volte ao Teams.
Selecione Exibição de árvore.
Selecione o aplicativo > Executar OnStart.

O botão de acesso de administrador agora está visível na Tela 2, e o rótulo mostra o nível de administrador como verdadeiro já que agora somos membros do grupo Acesso de administrador.

Ver a integração do Azure AD em ação

Você pode ver um exemplo de integração do Azure AD no aplicativo de exemplo Perfil+ para Teams.

Ver a integração do Active Directory em ação

O conector Usuários do Office 365 é usado para recuperar o perfil do usuário, incluindo nome, foto, gerente e outros detalhes.
O conector Grupos do Office 365 é usado para recuperar as pessoas que se reportam a um usuário selecionado.

Consulte também

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).