# Integração do Paylocity ao Active Directory | ManageEngine ADManager Plus ## Paylocity ![Paylocity](https://www.manageengine.com/active-directory-360/marketplace/images/logos/marketplace-paylocity-logo-24.png) ### Integre o Paylocity ao ADManager Plus e intensifique a produtividade da força de trabalho **Categorias:** - Provisionamento de identidade - Sincronização AD & RH Paylocity é uma aplicação de folha de pagamento e HCM baseada em cloud projetada para ajudar as equipes de RH no processamento da folha de pagamento, administração de benefícios, gerenciamento de talentos e rastreamento de horário e mão de obra. A integração do Paylocity ao ADManager Plus ajuda as equipes de TI a simplificar o gerenciamento do ciclo de vida do usuário, automatizando várias tarefas de gerenciamento de identidade e acesso no AD, Exchange, Office 365 e outras plataformas. Ao automatizar a criação, modificação e exclusão de contas de usuário, as equipes de TI podem reduzir a carga de trabalho manual, minimizar erros e garantir a sincronização perfeita entre o Paylocity e o Active Directory. ### Criação de contas de usuário Inicie a criação de contas de usuário para novos colaboradores com base nos dados do Paylocity, assegurando que eles recebam as permissões de acesso necessárias para desempenhar suas funções de trabalho com eficiência. ### Modificação de contas de usuário Atualize automaticamente as contas de usuário no Active Directory quando houver mudanças nas informações ou funções dos colaboradores no Paylocity. ### Exclusão de usuários Simplifique o processo de desligamento automatizando a exclusão ou desativação de contas de usuários desativadas no Paylocity. ## Aplicações relacionadas - [UKG Pro](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/ukg-pro-active-directory-integration-with-admanager-plus.html) - [ADP](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/adp-workforce-active-directory-integration-with-admanager-plus.html) - [SAP SuccessFactors](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/sap-successfactors-active-directory-integration-with-admanager-plus.html) - [Ceridian Dayforce](https://www.manageengine.com/active-directory-360/marketplace/admanager-plus/ceridian-dayforce-active-directory-integration-with-admanager-plus.html) - [Workday](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/workday-active-directory-integration-with-admanager-plus.html) ## Como integrar o Paylocity ao ADManager Plus ### Pré-requisitos 1. O Paylocity usa o **OAuth 2.0** para autorizar solicitações de API. 2. Requer credenciais de [client_id e client_secret](https://developer.paylocity.com/integrations/reference/authentication) para autorização. ### Privilégios 1. **Para importar usuários (ação de entrada):** a conta usada na autorização deve ter permissão para ler todas as contas de usuário. 2. Para executar qualquer ação ou consulta no Paylocity (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 que auxiliam na execução das ações básicas da integração. Se a ação que você precisa não estiver disponível, consulte a documentação de API do Paylocity 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 autorização 1. Faça login no ADManager Plus e acesse a guia **Automation**. 2. No painel esquerdo, em *Configuration*, clique em **Application Integrations**. 3. Em *Enterprise Applications*, clique em **Paylocity**. 4. Ative o botão **Enable Paylocity Integration**. 5. Na página Zoom Configuration, clique em Authorization. 6. Execute as [etapas para gerar o client_id e o client_secret](https://developer.paylocity.com/integrations/reference/authentication) a partir do Paylocity e cole os dados nos respectivos campos de valor. 7. Clique em **Configure**. ## Configuração de webhook de entrada O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do Paylocity. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao [configurar automatizações](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) para executar a ação desejada na lista de usuários retornada pela resposta da API. Para configurar um webhook de entrada para o Paylocity: 1. Em *Inbound Webhook*, clique em **Paylocity Endpoint Configuration**. 2. Na guia **Endpoint Configuration**, você encontrará um endpoint pré-configurado (ENDPOINT DE USUÁRIOS do Paylocity) com campos para: - **URL do endpoint** - **Método de API** - **Cabeçalhos** - **Parâmetros** Se desejar usar esse endpoint pré-configurado, substitua `{host}` e `{port}` pelo respectivo nome do host e número da porta da sua instância do Paylocity no campo **Endpoint URL**. Caso deseje usar um novo endpoint para importar usuários, configure-o usando o botão **+ Add API endpoint** e preenchendo os campos obrigatórios de acordo com as [referências de API do Paylocity](https://developer.paylocity.com/integrations/reference/authentication). Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. **Nota:** - O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações, conforme definido na **Configuração de autorização**. - É possível adicionar macros na configuração do endpoint para alterá-lo dinamicamente. - Consulte as [referências de API do Paylocity](https://docs.sonarsource.com/sonarcloud/advanced-setup/web-api/) e configure cabeçalhos e parâmetros adicionais, se necessário. 3. Clique em **Endpoint URL**. Uma janela exibirá todos os parâmetros disponíveis via chamada de API. Clique em **Proceed**. **Nota:** - Consulte as [referências de API do Paylocity](https://developer.paylocity.com/integrations/reference/authentication) para verificar quais **parâmetros** devem ser configurados para obter apenas dados específicos. - É possível configurar múltiplos endpoints usando o botão **+ Add API endpoint**. Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. 4. Clique em **Data Source - LDAP Attribute Mapping** para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes no Paylocity. **Nota:** O ADManager Plus também permite personalizar formatos de atributo do Paylocity. 5. Clique em **+ Add New Configuration** e: - Insira o **Nome da configuração** e a **Descrição**. - Selecione a **Categoria de automação**. - No campo **Select Endpoint**, selecione o endpoint desejado e uma **chave primária** exclusiva para cada usuário (por exemplo, `employeeIdentifier`). **Nota:** Quando múltiplos endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles. - Em **Attribute Mapping**, selecione o atributo LDAP e associe-o à coluna correspondente no Paylocity. - Para criar um formato personalizado, clique em **Add New Format Attribute**. - Clique em **Save**. ## Configuração de webhook de saída Webhooks de saída permitem enviar alterações feitas no AD para o Paylocity e executar tarefas diretamente a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos em: - [Modelos de orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html) - [Automações acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) - [Automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) Eles também podem ser aplicados diretamente aos usuários desejados em: **Management > Advanced Management > Orchestration** Para configurar webhooks de saída para o Paylocity: 1. Em *Outbound Webhook*, clique em **Paylocity Webhook Configuration**. 2. Clique em **+ Add Webhook**. 3. Insira um nome e uma descrição. 4. Consulte as [referências de API do Paylocity](https://developer.paylocity.com/integrations/reference/authentication) para obter detalhes como URL, cabeçalhos e parâmetros necessários. 5. Selecione o método HTTP apropriado. 6. Insira a **URL do endpoint**. 7. Configure: - **Cabeçalhos** - **Parâmetros** - **Tipo de mensagem** 8. Clique em **Test and Save**. 9. Selecione um usuário ou grupo do AD para testar a chamada de API e clique em **OK**. 10. Verifique os detalhes da solicitação e resposta. Se estiver correto, clique em **Save**.