Como integrar o ADManager Plus e o Rippling

Pré-requisitos

O Rippling usa o OAuth 2.0 para autorizar solicitações de API.

Ele requer um client_id e client_secret para autorização.

Privilégios

Para importar usuários (ação de entrada): Certifique-se de que a conta usada para autorização tenha permissão para ler todas as contas de usuário.

Para executar qualquer ação ou consulta no Rippling (ação de saída): Certifique-se de que a conta usada para autorização tenha permissão para executar a ação desejada.

Configuração de autorização

• Efetue login no ADManager Plus e navegue até a aba Automation.
• No painel esquerdo, em Configuration, clique em Application Integrations.
• Em Enterprise Applications, clique em Rippling.
• Ative o botão Enable Rippling Integration.
• Na página Rippling Configuration, clique em Authorization.
• Execute as etapas para gerar um client_id e client_secret do Rippling e cole-os nos respectivos campos de valor.
• Clique em Configure.

Configuração do webhook de entrada

Os webhooks de entrada permitem buscar dados de usuário do Rippling e enviá-los para o ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como a fonte de dados durante a configuração da automação. Para configurar um webhook de entrada para o Rippling:

• Em Inbound Webhook, clique em Rippling Endpoint Configuration.

• Na aba Endpoint Configuration, um endpoint, Rippling USERS ENDPOINT, vem pré-configurado com campos Endpoint URL, API Method, Headers e Parameters para buscar contas de usuários do Rippling. Se quiser usar esse endpoint pré-configurado, substitua {TeamId} pelo nome de domínio de sua instância do Rippling no campo Endpoint URL. No entanto, se desejar usar um novo endpoint para importar usuários, você pode configurar um usando o + Add API endpoint button e preenchendo os campos necessários de acordo com a documentação de API do Rippling . Clique aqui para saber como.

  Observação:

  • O par de valores de chave de API é pré-configurado como um cabeçalho para autenticar solicitações de API, conforme configurado durante a authorization configuration.
  • Macros: Você pode adicionar macros à configuração de seu endpoint para mudá-lo dinamicamente conforme sua necessidade usando o componente macro chooser
  • Consulte a documentação de API do Rippling e configure cabeçalhos e parâmetros adicionais, se necessário. Na aba Settings , a opção Repeat calling this endpoint será configurada para buscar 30 registros por chamada. Isso será repetido até que nenhum token de próxima página seja recebido.

• Quando terminar, clique em Test & Save. Uma janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos usando a chamada de API. Após verificar se os parâmetros solicitados foram chamados à ação, clique em Proceed.

  Observação:

  • Consulte a documentação de API do Rippling para saber mais sobre os parâmetros que devem ser configurados para buscar apenas parâmetros específicos.
  • Você pode configurar vários endpoints para o Rippling usando o + Add API endpoint button. Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no Rippling.

• Clique em + Add New Configuration e faça o seguinte:

  • Digite o Configuration Name e a Description e selecione a Automation Category no menu suspenso.

  • No campo Select Endpoint, selecione o endpoint desejado e uma Primary Key que seja exclusiva de um usuário (por exemplo, employeeIdentifier).

    Observação: Quando vários endpoints são configurados, esse atributo deve ter o mesmo valor em todos os endpoints.
  • No campo Attribute Mapping, selecione o atributo no menu suspenso LDAP Attribute Name e mapeie-o com o respectivo atributo no Rippling.
  • Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.
  • Clique em Save.