• Overview
  • Configuração

Aplicações relacionadas

PeopleXD

Otimize os workflows de RH e de TI com a sincronização PeopleXD-AD

Provisionamento de identidade

O PeopleXD, anteriormente conhecido como CoreHR, é uma solução de RH de ponta a ponta com folha de pagamento integrada e análise de pessoas, projetada para otimizar processos de RH, como integração de colaboradores, gerenciamento de dados e relatórios. Ao integrar o PeopleXD ao ADManager Plus, as equipes de TI podem automatizar tarefas de gerenciamento de usuários, como provisionamento, atualizações e desprovisionamento, sincronizando os registros de usuários no Active Directory (AD) com o PeopleXD.

 

Provisionamento automático de usuário

Automatize o provisionamento de usuários com base em registros de colaboradores do AD para o PeopleXD automaticamente, garantindo que detalhes precisos como cargo e departamento, sejam adicionados sem atrasos ou esforço manual.

 

Sincronizar mudanças do AD

Faça atualizações nos registros de usuários no Active Directory, como promoções ou alterações de contato, e sincronize-os automaticamente com o PeopleXD.

 

Documento de configuração: Integração do PeopleXD com o ADManager Plus

Pré-requisitos

O PeopleXD não necessita de autenticação para configurar a integração.

Privilégios

Importar usuários (ação de entrada): A conta utilizada na autorização deve ter permissão para ler todas as contas de usuário.

Para executar qualquer ação ou consulta no PeopleXD (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

Nota: O ADManager Plus oferece um conjunto pré-configurado de APIs para efetuar as ações básicas da integração. Se a ação que você precisa não estiver disponível, consulte a referência de API da PeopleXD para obter os detalhes de API necessários para a configuração de webhooks de entrada/saída para executar as ações requeridas.

Configuração de webhook de entrada

O webhook de entrada permite que você busque dados de usuários do PeopleXD para o ADManager Plus e execute a ação desejada neles, a partir daquelas disponíveis no recurso de Automação. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a configuração de automações para executar a ação desejada na lista de usuários retornada pela resposta da API.

Para configurar um webhook de entrada para o PeopleXD:

  • Em Inbound Webhook, clique em PeopleXD Endpoint Configuration.
  • guia Endpoint Configuration, você encontrará um endpoint pré-configurado, (ENDPOINT DE USUÁRIOS do PeopleXD), com os campos URL do endpoint, Método de API, Cabeçalhos e Parâmetros para obter contas de usuário do PeopleXD. Se desejar usar esse endpoint pré-configurado, substitua o valor da {API Key} no corpo da mensagem pelo da sua instância do PeopleXD. No entanto, se você desejar usar um novo endpoint para importar usuários, você poderá configurar um usando o botão + Add API endpoint e preenchendo os campos obrigatórios de acordo com as referências de API do PeopleXD. Clique aqui para saber como.

    • Nota:

    • Chave API: O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações de API, conforme definido durante a Configuração de Autorização.
    • Macros: É possível adicionar macros na configuração do endpoint para alterá-lo dinamicamente por meio do componente de seleção de macros.
    • Cabeçalhos adicionais: Consulte as referências de API do PeopleXD e configure cabeçalhos e parâmetros adicionais, se necessário.
  • Após concluir, clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Clique em Proceed.

    • Nota:

    • Consulte as referências de API do PeopleXD para saber os parâmetros que devem ser configurados para obter apenas parâmetros específicos.
    • Você pode configurar diversos endpoints para o PeopleXD usando o botão + Add API endpoint. Clique aqui para saber como.
  • Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos respectivos atributos no PeopleXD.
  • Clique em + Add New Configuration e faça o seguinte:
    • Insira o Nome da configuração e a Descrição, e selecione a Categoria de automação no menu suspenso.
    • No campo Select Endpoint, escolha o endpoint desejado e defina uma Chave primária única para o usuário (por exemplo, employeeIdentifier).
      • Nota: Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.
    • No campo Attribute Mapping, selecione o atributo no menu suspenso LDAP Attribute Name e associe ele à coluna correspondente no PeopleXD.
    • Se quiser criar um formato personalizado, clique em Mapping Attribute.
    • Clique em Save.

Configuração de webhook de saída

Os webhooks de saída permitem que você atualize as mudanças feitas no AD enviando as informações do ADManager Plus para o PeopleXD ou busque ou encaminhe os detalhes necessários do PeopleXD e sincronize-os com o AD. Para configurar um webhook de saída para o PeopleXD:

  • Em Outbound Webhook, clique em PeopleXD Webhook Configuration.
  • Clique em + Add Webhook.
  • Insira um nome e uma descrição para este webhook.
  • Decida sobre a ação que deve ser executada e consulte as referências de API do PeopleXD para obter os detalhes de API, como URL, cabeçalhos e parâmetros.
  • Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint.
  • Insira a URL do endpoint.
  • Configure os cabeçalhos, parâmetros e o tipo de mensagem no formato apropriado para a chamada de API desejad.
  • Clique em Test and Save.
  • Uma janela pop-up exibirá uma lista de usuários e grupos do AD para testar a chamada de API configurada. Selecione o usuário ou grupo desejado para testar a chamada de API e clique em OK. Isso enviará uma solicitação em tempo real para a URL do endpoint e aplicará as modificações configuradas aos objetos selecionados.
  • Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em Save.