• Overview
  • Configuração

Aplicações relacionadas

Staffology

Automatize a folha de pagamento e o gerenciamento de usuários com a integração Staffology-AD

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 seguros e em conformidade.

 

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

  • Faça login no ADManager Plus e acesse a guia Automation.
  • No painel esquerdo, em Configuration, clique em Application Integrations.
  • Em Enterprise Applications, clique em Staffology.
  • Ative o botão Enable Staffology Integration.
  • Na página Staffology Configuration, clique em Authorization.
  • Insira as credenciais de autenticação.
  • 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 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:

  • Em Inbound Webhook, clique em Staffology Endpoint Configuration.

  • 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. No entanto, se desejar 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. Clique aqui 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 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 Staffology 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 para saber como.

  • 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.]

  • 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 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:

  • Em Outbound Webhook, clique em Staffology Webhook Configuration.
  • Clique em + Add Webhook.
  • nsira um nome e uma descrição para este webhook.
  • Defina a ação a ser executada e consulte as referências de API do Staffology para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários.
  • 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, os parâmetros e o tipo de mensagem no formato apropriado com base na chamada de API que você deseja executar.
  • 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.
Nota: Os webhooks configurados podem ser integrados aos Modelos de orquestração possibilitando automações agendadas ou acionadas por eventos para executar consecutivamente uma sequência de ações em um grupo de usuários ou em usuários individuais.