Configurar o kpifire para provisionamento automático de usuários com o Microsoft Entra ID

Este artigo descreve as etapas que você precisa executar no kpifire e no Microsoft Entra ID para configurar o provisionamento automático de usuários. Quando configurado, o Microsoft Entra ID provisiona e desprovisiona automaticamente usuários e grupos para kpifire usando o serviço de provisionamento do Microsoft Entra. Para obter detalhes importantes sobre o que esse serviço faz, como funciona e perguntas frequentes, consulte Automatizar o provisionamento e o desprovisionamento de usuários para aplicativos SaaS com o Microsoft Entra ID.

Capacidades suportadas

Pré-requisitos

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

• Uma conta de usuário do Microsoft Entra com uma assinatura ativa. Se ainda não tiver uma, pode criar uma conta gratuitamente.
• Uma das seguintes funções:
  • Administrador de aplicativos
  • Administrador de aplicativos na nuvem
  • Proprietário do aplicativo.

• Um inquilino kpifire.
• Uma conta de usuário no kpifire com permissões de administrador.

Etapa 1: Planear a implementação de provisionamento

1. Saiba mais sobre como funciona o serviço de provisionamento.
2. Determine quem está no âmbito do provisionamento.
3. Determine os dados a mapear entre o Microsoft Entra ID e o kpifire.

Etapa 2: Configurar o kpifire para dar suporte ao provisionamento com o ID do Microsoft Entra

1. Iniciar sessão no https://app.kpifire.com com direitos de administrador

2. Navegue até Definições-Configurações da API>-Adicionar> Novo Token para gerar o token SCIM.

   

3. Copie e salve o token SCIM. Esse valor é inserido no campo Token secreto na guia Provisionamento do seu aplicativo kpifire.

Etapa 3: Adicionar kpifire da galeria de aplicativos do Microsoft Entra

Adicione kpifire da galeria de aplicativos do Microsoft Entra para começar a gerenciar o provisionamento para o kpifire. Se você já configurou o kpifire para SSO, você pode usar o mesmo aplicativo. No entanto, é recomendável que você crie um aplicativo separado ao testar a integração inicialmente. Saiba mais sobre como adicionar um aplicativo da galeria aqui.

Etapa 4: Definir quem está no escopo do provisionamento

O serviço de provisionamento do Microsoft Entra permite definir o escopo de quem é provisionado com base na atribuição ao aplicativo ou com base nos atributos do usuário ou grupo. Se você optar por definir o escopo de quem é provisionado para seu aplicativo com base na atribuição, poderá usar as etapas para atribuir usuários e grupos ao aplicativo. Se você optar por definir o escopo de quem é provisionado com base apenas nos atributos do usuário ou grupo, poderá usar um filtro de escopo.

• Comece pequeno. Teste com um pequeno conjunto de usuários e grupos antes de distribuir para todos. Quando o escopo para provisionamento é definido como usuários e grupos atribuídos, você pode controlar isso atribuindo um ou dois usuários ou grupos ao aplicativo. Quando o escopo é definido para todos os usuários e grupos, você pode especificar um filtro de escopo baseado em atributo .

• Se precisar de funções extras, você pode atualizar o manifesto do aplicativo para adicionar novas funções.

Etapa 5: Configurar o provisionamento automático de usuários para o kpifire

Esta seção orienta você pelas etapas para configurar o serviço de provisionamento do Microsoft Entra para criar, atualizar e desabilitar usuários e/ou grupos no aplicativo kpifire com base em atribuições de usuário e grupo na ID do Microsoft Entra.

Para configurar o provisionamento automático de usuários para kpifire no Microsoft Entra ID:

1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.

2. Navegue até Entra ID>aplicativos empresariais

   

3. Na lista de aplicativos, selecione kpifire.

   

4. Selecione a guia Provisionamento .

   

5. Selecione + Nova configuração.

   

6. No campo Tenant URL, introduza o URL do Tenant e o Token Secreto do seu kpifire. Selecione Test Connection para garantir que Microsoft Entra ID pode ligar-se ao kpifire. Se a ligação falhar, certifique-se de que a sua conta kpifire tem as permissões de administrador necessárias e tente novamente.

   

7. Selecione Criar para criar a sua configuração.

8. Selecione Propriedades na página de Visão Geral.

9. Selecione o ícone Editar para editar as propriedades. Ative os emails de notificação e forneça um email para receber notificações de quarentena. Ativar a prevenção de eliminações acidentais. Selecione Aplicar para salvar as alterações.

10. No campo Email de notificação , digite o endereço de e-mail de uma pessoa que deve receber as notificações de erro de provisionamento e marque a caixa de seleção Enviar uma notificação por e-mail quando ocorrer uma falha .

    

11. Selecione Mapeamento de Atributos no painel esquerdo e selecione utilizadores.

12. Analise os atributos de utilizador que são sincronizados do Microsoft Entra ID para o kpifire na seção de Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no kpifire para operações de atualização. Se você alterar o atributo target correspondente, precisará garantir que a API kpifire ofereça suporte à filtragem de usuários com base nesse atributo. Selecione Salvar para confirmar as alterações.

    Atributo	Tipo	Suportado para filtragem
    nome de utilizador	Cadeia	✓
    ativo	booleano
    nome.dado	Cadeia
    nome.nomeDeFamília	Cadeia
    phoneNumbers[tipo eq "trabalho"].value	Cadeia
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departamento	Cadeia

13. Selecione Mapeamento de Atributos no painel esquerdo e selecione grupos.

14. Analise os atributos de grupo que são sincronizados do ID do Microsoft Entra para o kpifire na seção Mapeamento de Atributos . Os atributos selecionados como propriedades correspondentes são usados para corresponder aos grupos no kpifire para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributo	Tipo	Suportado para filtragem
    Nome de Exibição	Cadeia	✓
    Membros	Referência

15. Para configurar os filtros de escopo, consulte as instruções fornecidas no artigo sobre filtros de alcance.

16. Use provisionamento sob demanda para validar a sincronização com um pequeno número de utilizadores antes de uma implementação mais ampla na sua organização.

17. Quando estiver pronto para provisionar, selecione Iniciar Provisão na página de Visão Geral .

Etapa 6: Monitorar sua implantação

Depois de configurar o provisionamento, use os seguintes recursos para monitorar sua implantação:

1. Use os logs de provisionamento para determinar quais usuários são provisionados com ou sem êxito
2. Verifique a barra de progresso para ver o status do ciclo de provisionamento e quão perto ele está de ser concluído
3. Se a configuração de provisionamento parecer estar em um estado não íntegro, o aplicativo entrará em quarentena. Saiba mais sobre os estados de quarentena no artigo estado de quarentena de provisionamento de aplicações.

Mais recursos

• Gerenciando o provisionamento de conta de usuário para aplicativos corporativos
• O que é acesso ao aplicativo e logon único com o Microsoft Entra ID?

Conteúdo relacionado

• Saiba como revisar logs e obter relatórios sobre a atividade de provisionamento