Como Configurar Funções de Aplicativo do Microsoft Entra ID (Azure AD) & Declarações SAML para EloView SSO

Público Alvo: Público / Clientes Elo, Arquitetos de Identidade em Nuvem & Administradores de TI

Tipo de Artigo: Guia de Configuração de Single Sign-On (SSO) & Identidade em Nuvem

Este guia abrangente descreve como criar Funções de Aplicativo personalizadas no Microsoft Entra ID (anteriormente Azure Active Directory), mapeá-las para usuários e grupos do diretório e passá-las como declarações de token SAML para EloView® para Controle de Acesso Baseado em Funções (RBAC).

Arquitetura: Funções de Aplicativo vs. Grupos de Segurança

Compreendendo como o Entra ID lida com direitos em nível de aplicação em comparação com grupos de segurança em todo o diretório:

Exemplo de Mapeamentos de Função do EloView

Crie funções de segurança personalizadas no EloView que estejam alinhadas com suas equipes organizacionais:

Etapa 1: Declarar Funções de Aplicativo nos Registros de Aplicativos Azure

1. Faça login no Portal Azure (ou Centro de Administração do Microsoft Entra).
2. Navegue até Azure Active Directory (Microsoft Entra ID) > Registros de Aplicativo.

3. Selecione seu Aplicativo EloView Registrado.

   

4. No menu de navegação à esquerda sob Gerenciar, clique em Funções de Aplicativo, depois selecione Criar função de aplicativo.

   

5. Na janela Criar função de aplicativo, configure os parâmetros da função:

   • Nome de exibição: Pode conter espaços (por exemplo, EloView Admins).
   • Tipos de membros permitidos: Selecione Usuários/Grupos.
   • Valor: String exata do token de função — não pode conter espaços (por exemplo, EloView_Admins).
   • Descrição: Descrição administrativa interna.

   

6. Clique em Aplicar para salvar a função, e repita para todas as funções do EloView necessárias.

   

Etapa 2: Atribuir Usuários e Grupos às Funções de Aplicativo

1. No Portal Azure, navegue até Aplicativos empresariais > Todos os aplicativos e selecione seu Aplicativo Empresarial EloView.

   

2. Em Gerenciar, clique em Usuários e grupos, depois selecione Adicionar usuário/grupo.

   

3. Selecione o Usuário ou Grupo alvo, depois clique em Selecionar uma função para atribuir a Função de Aplicativo correspondente (por exemplo, EloView_Admins).

   

4. Clique em Selecionar, depois clique em Atribuir. Repita para todos os usuários e grupos de segurança restantes.

Etapa 3: Mapear a Declaração de Função SAML no Single Sign-On

1. Sob seu Aplicativo Empresarial, navegue até Gerenciar > Single sign-on (SAML).

2. Na seção Atributos & Declarações, clique em Editar.

   

3. Clique em Adicionar nova declaração e configure os seguintes parâmetros:

   • Nome: roles (Case-sensitive: Deve ser estritamente em letras minúsculas sem namespace)
   • Fonte: Atributo
   • Atributo de origem: user.assignedroles
   
4. Clique em Salvar.

Etapa 4: Testar SSO & Verificar Emissão de Token

1. Testar Token SAML no Azure: Use a ferramenta Testar Single Sign-On no Azure para inspecionar a declaração SAML emitida. Confirme que o atributo aparece com sua função configurada:

   roles = EloView_Admins

   

2. Verificar Atribuição de Funções no Portal: Faça login no Portal EloView via SSO e verifique se a sessão ativa do usuário reflete a função mapeada (por exemplo, (SAMLUser)EloView_Admins).