• Overview
  • Configuração

Aplicações relacionadas

Homebase

Automatize o processo de onboarding de usuários com a integração Homebase-ADManager Plus

Provisionamento de identidade

O Homebase é um software de gestão da força de trabalho baseado em nuvem que ajuda as organizações a melhorar a eficiência operacional e reduzir os encargos administrativos, simplificando o agendamento de funcionários, o controle de tempo, a folha de pagamento e a comunicação da equipe. Por meio da integração do ADManager com o Homebase, as equipes de TI podem sincronizar os dados dos funcionários entre o Active Directory (AD) e o Homebase, automatizando o processo de criação de usuários. Essa integração garante que um novo usuário seja criado quando um novo registro de funcionário for adicionado ao Homebase e que essas mudanças sejam automaticamente refletidas no AD e em outras plataformas conectadas, reduzindo os esforços manuais e minimizando os erros.

 

Automatize a criação de usuários

Orquestre workflows para automatizar a criação de usuários no AD quando um novo funcionário for adicionado ao Homebase, garantindo um processo de onboarding perfeito. Da mesma forma, quando um usuário é criado no AD, os workflows podem acionar a adição desse funcionário ao Homebase, mantendo os dois sistemas sincronizados.

 

Sincronize mudanças de usuários

Quando os detalhes do usuário, como função, departamento ou informações de contato, são atualizados no AD, eles são automaticamente sincronizados com o Homebase, garantindo perfis de usuário consistentes e precisos em todas as plataformas.

 

Como integrar o ADManager Plus e o Homebase

Pré-requisitos

Forneça o token de portador para recuperar as informações desejadas e executar tarefas no Homebase. Para obter mais detalhes, consulte as referências de API do Homebase.

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 Homebase (ação de saída): Certifique-se de que a conta usada para autorização tenha permissão para executar a ação desejada.

Observação: O ADManager Plus vem com um conjunto pré-configurado de APIs que ajuda a executar ações básicas com a integração. Se a ação que você deseja não estiver disponível, obtenha os detalhes necessários da API na documentação de API do Homebase para configurar webhooks de entrada/saída para executar as ações necessárias.

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 Homebase.
  • Ative o botão Enable Homebase Integration.
  • Na página Homebase Configuration, clique em Authorization.
  • Execute as etapas para gerar o token do portador no Homebase e cole o token do portador no campo Value.
  • Clique em Configure.

Configuração do webhook de entrada

O webhook de entrada permite buscar dados de usuário do Homebase 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 Homebase:

  • Em Inbound Webhook, clique em Homebase Endpoint Configuration.

  • Se quiser usar esse endpoint pré-configurado, substitua {location_uuid} e {Employee Id} pelos de sua instância do Homebase 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 as referências de API do Homebase. Para saber como fazer isso, clique aqui.

    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 suas necessidades usando o componente macro chooser.
    • Consulte as referências de API do Homebase e configure cabeçalhos e parâmetros adicionais, se necessário.

  • 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 as referências de API do Homebase para obter os Parameters que devem ser configurados para buscar apenas parâmetros específicos.
    • Você pode configurar vários endpoints para o Homebase usando o + Add API endpoint button. Para saber como fazer isso, clique aqui.
  • Clique em Data Source - LDAP Attribute Mapping para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no Homebase.

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

    • Digite o Configuration Name e 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 Homebase.
    • Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.
    • Clique em Save.

Configuração do webhook de saída

O webhook de saída permite que você envie mudanças feitas no AD para o Homebase e execute tarefas no Homebase - tudo a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos nos modelos de orquestração, que podem ser usados durante automações programadas e orientadas por eventos. Eles também podem ser aplicados diretamente nos usuários desejados para executar uma sequência de ações neles (Management > Advanced Management > Orchestration).

Para configurar webhooks de saída para o Homebase:

  • Em Outbound Webhook, clique em Homebase Webhook Configuration.
  • Clique em + Add Webhook.
  • Digite um nome e uma descrição para esse webhook.
  • Decida a action que deve ser executada e consulte as referências de API do Homebase para obter os detalhes da API, como URL, cabeçalhos, parâmetros e outros requisitos.
  • Selecione o HTTP method que permitirá que você execute a ação desejada no endpoint no menu suspenso.
  • Digite o endpoint URL.
  • Configure Headers, Parameters, e Message Type no formato apropriado com base na chamada de API que você gostaria de 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 sobre o qual essa solicitação de API deve ser testada e clique em OK. Isso fará uma chamada em tempo real para o URL do endpoint e os objetos selecionados serão modificados de acordo com a configuração.
  • A resposta do webhook e os detalhes da solicitação serão exibidos. Verifique se eles correspondem ao comportamento esperado da API e clique em Save.