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

O objetivo deste tutorial é demonstrar as etapas a serem executadas no Peakon 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 Peakon.

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.

Atualmente, esse conector está em versão prévia. Para obter mais informações, consulte Termos de Licença Universal para Serviços Online.

Pré-requisitos

O cenário descrito neste tutorial pressupõe que você já tenha os pré-requisitos a seguir

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

Observação

Essa integração também está disponível para uso no ambiente de Nuvem do Governo dos EUA do Microsoft Entra. Você pode encontrar esse aplicativo na Galeria de Aplicativos de Nuvem do Governo dos EUA do Microsoft Entra e configurá-lo da mesma forma que você faz isso na nuvem pública.

Como atribuir usuários 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á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 Peakon. Depois de decidir isso, você poderá atribuir esses usuários e/ou grupos ao Peakon seguindo estas instruções:

Dicas importantes para atribuir usuários ao Peakon

  • Recomendamos que um só usuário do Microsoft Entra seja atribuído ao Peakon 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 Peakon, você precisa 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 Peakon para provisionamento

  1. Entre no Console de Administração do Peakon. Clique em Configuração.

    Console de Administração do Peakon

  2. Selecione Integrações.

    Captura de tela de Opções de configuração com a opção Integrações em destaque.

  3. Habilite o Provisionamento de Funcionário.

    Captura de tela da seção Provisionamento de Funcionário com a opção Habilitar em destaque.

  4. Copie os valores de URL do SCIM 2.0 e Token de Portador OAuth. Esses valores serão inseridos nos campos URL do Locatário e Token Secreto na guia Provisionamento do seu aplicativo Peakon.

    Criar Token no Peakon

Para configurar o Peakon 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.

  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 pela galeria, digite Peakon e 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

Como configurar o provisionamento automático de usuário no Peakon

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 Peakon 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 Peakon seguindo as instruções fornecidas no tutorial de logon único do Peakon. O logon único pode ser configurado independentemente do provisionamento automático de usuário, embora esses dois recursos sejam complementares.

Para configurar o provisionamento automático de usuário para o Peakon 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

    Folha de aplicativos empresariais

  3. Na lista de aplicativos, selecione Peakon.

    O link do Peakon na lista Aplicativos

  4. Selecione a guia Provisionamento.

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

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

    Captura de tela da lista suspensa Modo de Provisionamento com a opção Automático destacada.

  6. Na seção Credenciais de Administrador, insira os valores de URL do SCIM 2.0 e Token de Portador OAuth recuperados anteriormente em URL do Locatário e Token Secreto, respectivamente. Clique em Testar Conectividade para verificar se a ID do Microsoft Entra pode se conectar ao Peakon. Se a conexão falhar, verifique se a sua conta do Peakon tem permissões de Administrador e tente novamente.

    URL do locatário + token

  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.

    Email de notificação

  8. Clique em Save (Salvar).

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

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

    Atributos de Usuário no Peakon

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

    Escopo de provisionamento

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

    Salvando a configuração de provisionamento

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 de 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 Peakon.

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

Limitações do conector

  • Todos os atributos de usuário personalizados no Peakon precisam ser estendidos da extensão personalizada de usuário do SCIM do Peakon urn:ietf:params:scim:schemas:extension:peakon:2.0:User.

Recursos adicionais

Próximas etapas