Configure o Peakon para o provisionamento automático de utilizadores com o Microsoft Entra ID

O objetivo deste artigo é demonstrar as etapas a serem executadas no Peakon e no Microsoft Entra ID para configurar o Microsoft Entra ID para provisionar e desprovisionar automaticamente usuários e/ou grupos para o Peakon.

Nota

Este artigo descreve um conector baseado no serviço de provisionamento de utilizadores 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.

Este conector está atualmente em versão de pré-lançamento. Para obter mais informações sobre visualizações, consulte Termos de Licença Universal para Serviços Online.

Pré-requisitos

O cenário descrito neste artigo assume que já tem os seguintes pré-requisitos.

Nota

Essa integração também está disponível para uso no ambiente Microsoft Entra US Government Cloud. Pode encontrar esta aplicação na Microsoft Entra US Government Cloud Application Gallery e configurá-la da mesma forma que faz a partir da nuvem pública.

Passo 1: Atribuir utilizadores ao Peakon

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ários, 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ários, você deve decidir quais usuários e/ou grupos no Microsoft Entra ID precisam acessar o Peakon. Uma vez decidido, você pode atribuir esses usuários e/ou grupos ao Peakon seguindo as instruções aqui:

Passo 2: Dicas importantes para atribuir utilizadores ao Peakon

  • É recomendável que um único usuário do Microsoft Entra seja atribuído ao Peakon para testar a configuração de provisionamento automático de usuário. Usuários e/ou grupos adicionais podem ser atribuídos posteriormente.

  • Ao atribuir um usuário ao Peakon, você deve selecionar qualquer função válida específica do aplicativo (se disponível) na caixa de diálogo de atribuição. Os usuários com a função Acesso Padrão são excluídos do provisionamento.

Passo 3: Configurar o Peakon para provisionamento

  1. Faça login no Peakon Admin Console. Selecione Configuração.

    Console de Administração Peakon

  2. Selecione Integrações.

    Captura de tela das opções de configuração com a opção Integrações destacada.

  3. Habilite o provisionamento de funcionários.

    Captura de tela da seção Provisionamento de funcionários com a opção Ativar destacada.

  4. Copie os valores para SCIM 2.0 URL e OAuth Bearer Token. Esses valores são inseridos no campo URL do locatário e Token secreto na guia Provisionamento do seu aplicativo Peakon.

    Peakon Criar Token

Para configurar o Peakon para provisionamento automático do utilizador com o Microsoft Entra ID, precisa de adicionar o Peakon da galeria de aplicações Microsoft Entra à sua lista de aplicações SaaS geridas.

  1. Entre no centro de administração do Microsoft Entra como pelo menos um administrador de aplicativos na nuvem.
  2. Navegue até Entra ID>Enterprise apps>Novo aplicativo.
  3. Na seção Adicionar da galeria , digite Peakon, selecione Peakon na caixa de pesquisa.
  4. Selecione Peakon no painel de resultados e adicione o aplicativo. Aguarde alguns segundos enquanto o aplicativo é adicionado ao seu locatário. Peakon na lista de resultados

Passo 5: Configurar o provisionamento automático do utilizador para o Peakon

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 Peakon com base em atribuições de usuário e/ou grupo na ID do Microsoft Entra.

Gorjeta

Você também pode optar por habilitar o logon único baseado em SAML para o Peakon, seguindo as instruções fornecidas no artigo Logon único do Peakon. O logon único pode ser configurado independentemente do provisionamento automático do usuário, embora esses dois recursos se complementem.

Para configurar o provisionamento automático de utilizadores para o Peakon 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>Aplicações Empresariais

    Folha de aplicativos corporativos

  3. Na lista de aplicativos, selecione Peakon.

    O link Peakon na lista Aplicações

  4. Selecione a guia Provisionamento .

    Captura de tela das opções Gerenciar com a opção Provisionamento destacada.

  5. Selecione + Nova configuração.

    Captura de ecrã da aba Aprovisionamento automático.

  6. No campo URL de Inquilino , introduza o seu URL de Inquilino Peakon e o Token Secreto. Selecione Testar conexão para garantir que o Microsoft Entra ID possa se conectar ao Peakon. Se a ligação falhar, certifique-se de que a sua conta Peakon tem as permissões de administrador necessárias e tente novamente.

    Captura de ecrã da ligação de teste de provisionamento.

  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. Habilite e-mails de notificação e forneça um e-mail para receber e-mails de quarentena. Ative a opção para evitar eliminação acidental. Selecione Aplicar para salvar as alterações.

    Captura de ecrã das propriedades de provisionamento.

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

  11. Analise os atributos de usuário sincronizados do ID do Microsoft Entra para o Peakon na seção Mapeamento de Atributos. Os atributos selecionados como propriedades correspondentes são usados para corresponder às contas de usuário no Peakon para operações de atualização. Selecione o botão Salvar para confirmar as alterações.

    Atributos do usuário Peakon

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

  13. 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.

  14. 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 o estado de quarentena no artigo estado de quarentena de aprovisionamento de aplicativos.

Limitações do conector

  • Todos os atributos de utilizador personalizados no Peakon têm de ser estendidos desde a extensão SCIM de utilizador personalizada do Peakon urn:ietf:params:scim:schemas:extension:peakon:2.0:User.

Recursos adicionais