Tutorial: Configurar o Promapp para provisionamento automático de usuário

O objetivo deste tutorial é demonstrar as etapas a serem executadas no Promapp e na ID do Microsoft Entra para configurar a ID do Microsoft Entra a fim de provisionar e desprovisionar usuários e/ou grupos automaticamente no Promapp.

Observação

Este tutorial descreve um conector criado sobre o serviço de provisionamento de usuário do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como ele funciona e perguntas frequentes, confira Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Pré-requisitos

O cenário descrito neste tutorial pressupõe que você já tem os seguintes pré-requisitos:

• Um locatário do Microsoft Entra
• Um locatário do Promapp
• Uma conta de usuário no Promapp com permissões de administrador.

Atribuindo usuários ao Promapp

O Microsoft Entra ID usa um conceito chamado atribuições para determinar quais usuários devem receber acesso aos aplicativos selecionados. No contexto do provisionamento automático de usuário, somente os usuários e/ou grupos que foram atribuídos a um aplicativo no Microsoft Entra ID são sincronizados.

Antes de configurar e habilitar o provisionamento automático de usuário, decida quais usuários e/ou grupos da ID do Microsoft Entra precisam ter acesso ao Promapp. Depois de decidir, é possível atribuir esses usuários e/ou grupos ao Promapp seguindo estas instruções:

• Atribuir um usuário ou um grupo a um aplicativo empresarial

Dicas importantes para atribuir usuários ao Promapp

• Recomendamos que um só usuário do Microsoft Entra seja atribuído ao Promapp para testar a configuração de provisionamento automático de usuário. Outros usuários e/ou grupos podem ser atribuídos mais tarde.

• Ao atribuir um usuário ao Promapp, é necessário selecionar qualquer função específica ao aplicativo válida (se disponível) na caixa de diálogo de atribuição. Usuários com a função Acesso padrão são excluídos do provisionamento.

Configurar o Promapp para provisionamento

1. Entre no Console de Administração do Promapp. Sob o nome de usuário, navegue até Meu Perfil.

   

2. Em Tokens de Acesso, clique no botão Criar Token.

   

3. Forneça qualquer nome no campo Descrição e selecione SCIM no menu de seleção Escopo. Clique no ícone salvar.

   

4. Copie o token de acesso e salve-o, porque essa será a única vez que poderá vê-lo. Esse valor será inserido no campo Token Secreto na guia Provisionamento do aplicativo Promapp.

   

Adicionar o Promapp da galeria

Para configurar o Promapp para o provisionamento automático de usuário com a ID do Microsoft Entra, você precisará adicioná-lo à lista de aplicativos SaaS gerenciados por meio da galeria de aplicativos do Microsoft Entra.

Para adicionar o Promapp por meio da galeria de aplicativos do Microsoft Entra, execute as seguintes etapas:

1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.
2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.
3. Na seção Adicionar da galeria, digite Promapp e selecione Promapp na caixa de pesquisa.
4. Selecione Promapp no painel de resultados e, em seguida adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário.

Configurando o provisionamento automático de usuário no Promapp

Esta seção descreve as etapas de configuração do serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no Promapp com base nas atribuições de usuário e/ou de grupo da ID do Microsoft Entra.

Dica

Você também pode optar por habilitar o logon único baseado em SAML para o Promapp seguindo as instruções fornecidas no Tutorial de logon único do Promapp. O logon único pode ser configurado de modo independente do provisionamento automático de usuário, embora os dois sejam complementares.

Para configurar o provisionamento automático de usuário para o Promapp na ID do Microsoft Entra:

1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.

2. Navegue até Identidade>Aplicativos>Aplicativos empresariais

   

3. Na lista de aplicativos, escolha Promapp.

   

4. Selecione a guia Provisionamento.

   

5. Defina o Modo de Provisionamento como Automático.

   

6. Na seção Credenciais de Administrador, insira https://api.promapp.com/api/scim em URL do Locatário. Insira o valor do Token de Autenticação do SCIM recuperado anteriormente em Token Secreto. Clique em Testar Conectividade para verificar se a ID do Microsoft Entra pode se conectar ao Promapp. Se a conexão falhar, verifique se a sua conta Promapp tem permissões de administrador e tente novamente.

   

7. No campo Notificação por Email, insira o endereço de email de uma pessoa ou grupo que deverá receber as notificações de erro de provisionamento e selecione a caixa de seleção - Enviar uma notificação por email quando ocorrer uma falha.

   

8. Clique em Save (Salvar).

9. Na seção Mapeamentos, selecione Sincronizar usuários do Microsoft Entra com o Promapp.

10. Revise os atributos de usuário que serão sincronizados da ID do Microsoft Entra com o Promapp na seção Mapeamento de Atributos. Os atributos selecionados como propriedades Correspondentes serão usados para fazer a correspondência entre as contas de usuário no Promapp para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    

11. Para configurar filtros de escopo, consulte as seguintes instruções fornecidas no tutorial do Filtro de Escopo.

12. Para habilitar o serviço de provisionamento do Microsoft Entra para o Promapp, altere o Status de Provisionamento para Ativado na seção Configurações.

    

13. Defina os usuários e/ou os grupos que deseja provisionar no Promapp escolhendo os valores desejados em Escopo na seção Configurações.

    

14. Quando estiver pronto para provisionar, clique em Salvar.

    

Essa operação inicia a sincronização inicial de todos os usuários e/ou grupos definidos no Escopo na seção Configurações. A sincronização inicial leva mais tempo para ser executada do que as sincronizações seguintes, que ocorrem aproximadamente a cada 40 minutos, desde que o serviço de provisionamento do Microsoft Entra esteja em execução. Use a seção Detalhes da Sincronização para monitorar o progresso e siga os links para o relatório de atividades de provisionamento, que descreve todas as ações executadas pelo serviço de provisionamento do Microsoft Entra no Promapp.

Para obter mais informações sobre como ler os logs de provisionamento do Microsoft Entra, confira Relatórios sobre o provisionamento automático de contas de usuário.

Recursos adicionais

• Gerenciamento do provisionamento de conta de usuário para Aplicativos Empresariais
• O que é o acesso a aplicativos e logon único com o Microsoft Entra ID?

Próximas etapas

• Saiba como fazer revisão de logs e obter relatórios sobre atividade de provisionamento