• Overview
  • Configuração

Aplicações relacionadas

Payspace

Otimize o gerenciamento de usuários com a integração do PaySapce ao ADManager Plus

Provisionamento de identidade

O PaySpace é uma plataforma de folha de pagamento e gerenciamento de RH baseada em nuvem, projetada para otimizar a administração de colaboradores e os processos de folha de pagamento para empresas. Conecte facilmente o PaySpace ao seu AD com o ADManager Plus da ManageEngine. A integração PaySpace-ADManager Plus permite que as equipes de TI automatizem as tarefas de provisionamento e desprovisionamento de usuários, sincronizando os registros de usuários no AD com o PaySpace. Ao manter o Active Directory (AD), o Exchange, o Microsoft 365 e outros sistemas conectados sincronizados com os dados de RH, essa integração assegura informações precisas e atualizadas dos colaboradores em todas as plataformas, reduz o esforço manual e melhora a eficiência operacional.

 

Provisionamento e desprovisionamento automatizados de usuários

Crie, modifique ou exclua automaticamente contas de usuários no AD com base em eventos do ciclo de vida dos colaboradores no PaySpace, como novas contratações, promoções ou demissões.

 

Gerenciamento de acesso baseado em funções

Atribua ou atualize automaticamente as permissões de usuários no AD com base nas funções definidas no PaySpace. Garanta que os colaboradores tenham acesso a recursos alinhados às suas responsabilidades.

 

Como integrar o PaySpace com o ADManager Plus

Pré-requisitos

O PaySpace usa autenticação bearer token para autorizar solicitações de API. Consulte PaySpace API para mais detalhes.

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 PaySpace (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 do PaySpace para obter os detalhes de API necessários para a configuração de webhooks de entrada ou saída para executar as ações requeridas.

Configuração de autorização

  • Faça login no ADManager Plus e acesse Directory/Application Settings.
  • Em Application Integrations, localize e selecione Payspace.
  • Ative o botão Enable PaySpace Integration.
  • Na página PaySpace Configuration, clique em Authorization.
  • Escolha Bearer como o tipo de autorização para a integração do API.
  • Navegue e clique em API widget com o painel de configuração da integração para configurar a autenticação personalizada.
  • Na janela API for Authorization:
    • Vá para o campo Endpoint URL e substitua {hostname} pelo nome do host da sua instância do PaySpace.
    • No campo Message Type, substitua os espaços reservados {client_id}, {client_secret}, e {api.full_access} pelas respectivas credenciais e pelo identificador da empresa à sua instância do PaySpace.
    • Clique no botão Test and Configure para validar as configurações e concluir a integração.
    • Selecione o access token gerado e clique em Save.
  • Clique em Configure.

Configuração de webhook de entrada

Um webhook de entrada permite que você obtenha dados do usuário diretamente do PaySpace e os envie para o ADManager Plus. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao configurar automatizações. Para configurar um webhook de entrada para o PaySpace:

  • Em Inbound Webhook, clique em PaySpace Endpoint Configuration.
  • No campo Endpoint URL, substitua {hostname} pelo nome do host da sua instância do PaySpace.
  • Insira a API-Key associada à sua instância do PaySpace na seção Headers.
  • Substitua {username}, {password} e {company} no campo Message Type pelas respectivas credenciais para sua instância do PaySpace.
  • Clique em Test and Configure para validar as configurações e concluir o processo de configuração.
  • Clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Após verificar se os parâmetros desejados foram retornados, clique em Proceed.

    • Nota:

    • Consulte as referências de API do PaySpace para saber quais parâmetros devem ser configurados para obter apenas parâmetros específicos.
    • Você pode configurar diversos endpoints para o PaySpace 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 PaySpace.
  • 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 ao atributo correspondente no PaySpace.
  • Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.
  • Clique em Save.

Configuração de webhook de saída

Webhooks de saída permitem que você envie mudanças feitas no AD para o PaySpace e execute tarefas no PaySpace — tudo a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos em Modelos de orquestração, que, por sua vez, podem ser usados durante automações acionadas por eventos e automações agendadas. Eles também podem ser aplicados diretamente aos usuários desejados para executar uma sequência de ações neles (Management > Advanced Management > Orchestration).

Para configurar webhooks de saída para o PaySpace:

  • Em Outbound Webhook, clique em PaySpace 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 PaySpace para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários.
  • Selecione o método HTTP que possibilitará que você execute a ação desejada no endpoint do menu suspenso.
  • Insira a URL do endpoint.
  • Configure os cabeçalhos, os parâmetros e o tipo de mensagem no formato apropriado para a chamada de API desejada.
  • 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.