# Staffology ![Staffology](https://www.manageengine.com/active-directory-360/marketplace/images/logos/marketplace-staffology-logo-24.png) ## Automatize a folha de pagamento e o gerenciamento de usuários com a integração Staffology-AD **Categoria:** Provisionamento de identidade Staffology é um software de folha de pagamento baseado em nuvem que ajuda equipes financeiras a automatizar operações complexas de folha de pagamento e reduzir despesas administrativas. Ele auxilia as empresas a gerenciar pagamentos, impostos e benefícios dos colaboradores, garantindo a conformidade com as regulamentações mais recentes. A integração do Staffology com o ADManager Plus permite que as empresas automatizem o provisionamento de usuários e sincronizem os dados dos colaboradores entre os sistemas de RH e de TI. A integração permite que as contas de usuário sejam gerenciadas com precisão e eficiência no Active Directory (AD), Exchange, Microsoft 365 e outras aplicações corporativas, aprimorando o gerenciamento da força de trabalho e minimizando a intervenção manual. ### Criação automática de usuário Automatize a criação de usuários do Staffology para o AD e conceda as permissões necessárias no Exchange, Microsoft 365 e outras aplicações corporativas quando novos registros de colaboradores são adicionados ao Staffology. ### Desligamento eficiente Otimize a remoção de acesso e permissões de usuários para garantir desativações de contas seguras e em conformidade. ## Aplicações relacionadas - [Monday](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/monday-active-directory-integration-with-admanager-plus.html) - [Slack](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/slack-active-directory-integration-with-admanager-plus.html) - [Asana](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/asana-active-directory-integration-with-admanager-plus.html) - [Trello](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/trello-active-directory-integration-with-admanager-plus.html) - [Jira](https://www.manageengine.com/br/active-directory-360/marketplace/admanager-plus/jira-active-directory-integration-with-admanager-plus.html) ## Como integrar o ADManager Plus e o Staffology ### Pré-requisitos O Staffology usa autenticação básica para autorizar solicitações de API e requer credenciais de [nome do usuário e senha](https://app.staffology.co.uk/api/docs/guides/intro/auth) para a autorizaçã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 Staffology (ação de saída):** A conta usada deve ter permissão para realizar a ação desejada. **Nota:** O ADManager Plus é disponibilizado com um conjunto pré-configurado de APIs que auxiliam na execução de ações básicas com a integração. Se a ação que você precisa não estiver disponível, consulte a referência de API do Staffology para obter os detalhes de API necessários para a configuração de webhooks de entrada e 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 **Staffology**. 4. Ative o botão **Enable Staffology Integration**. 5. Na página Staffology Configuration, clique em **Authorization**. 6. Insira as credenciais de autenticação. 7. Clique em **Configure**. ## Configuração de webhook de entrada Os webhooks de entrada permitem que você obtenha dados do usuário diretamente do Staffology e os envie para o ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a [configuração de automaçõ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 Staffology: 1. Em Inbound Webhook, clique em **Staffology Endpoint Configuration**. 2. Na guia **Endpoint Configuration**, você encontrará um endpoint pré-configurado, o ENDPOINT DE USUÁRIOS do Staffology, com campos URL do endpoint, Método de API, Cabeçalhos e Parâmetros para obter contas de usuário do Staffology. - Para usar esse endpoint pré-configurado, substitua `{subdomain}` pelo nome de domínio da sua instância do Staffology no campo Endpoint URL. - Para usar um novo endpoint para importar usuários, clique em **+ Add API endpoint** e preencha os campos obrigatórios conforme os [detalhes de API do Staffology](https://app.staffology.co.uk/api/docs/guides/intro/auth). - 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 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. - Consulte as [referências de API do Staffology](https://app.staffology.co.uk/api/docs/guides/intro/auth) e configure cabeçalhos e parâmetros adicionais, se necessário. 3. 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 Staffology](https://app.staffology.co.uk/api/docs/guides/intro/auth) para visualizar os **parâmetros** que devem ser configurados para obter apenas parâmetros específicos. - Você pode configurar diversos endpoints para o Staffology 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 respectivos atributos no Staffology. O ADManager Plus também permite personalizar o formato de atributos importados do Staffology. 5. 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-o à coluna correspondente no Staffology. - 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 usando o ADManager Plus para o Staffology ou busque ou encaminhe os detalhes necessários do Staffology e sincronize-os com o AD. Para configurar um webhook de saída para o Staffology: 1. Em Outbound Webhook, clique em **Staffology Webhook Configuration**. 2. Clique em **+ Add Webhook**. 3. Insira um nome e uma descrição para este webhook. 4. Defina a ação a ser executada e consulte as [referências de API do Staffology](https://app.staffology.co.uk/api/docs/guides/intro/auth) para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos necessários. 5. Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint. 6. Insira a URL do endpoint. 7. Configure os cabeçalhos, os parâmetros e o tipo de mensagem no formato apropriado com base na chamada de API que você deseja executar. 8. Clique em **Test and Save**. 9. 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**. 10. Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em **Save**. **Nota:** Os webhooks configurados podem ser integrados aos [Modelos de orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html), possibilitando [automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) ou [acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) para executar consecutivamente uma sequência de ações em um grupo de usuários ou em usuários individuais.