# Homebase ![Homebase](https://www.manageengine.com/active-directory-360/marketplace/images/logos/marketplace-homebase-logo-24.png) ## 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](https://app.joinhomebase.com/api-docs) para recuperar as informações desejadas e executar tarefas no Homebase. Para obter mais detalhes, consulte as [referências de API do Homebase](https://app.joinhomebase.com/api-docs). **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](https://app.joinhomebase.com/api-docs) 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](https://app.joinhomebase.com/api-docs) 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](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html). Para configurar um webhook de entrada para o Homebase: 1. Em Inbound Webhook, clique em **Homebase Endpoint Configuration**. 2. 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](https://app.joinhomebase.com/api-docs). Para saber como fazer isso, [clique aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html). **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](https://app.joinhomebase.com/api-docs) e configure cabeçalhos e parâmetros adicionais, se necessário. 3. 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](https://app.joinhomebase.com/api-docs) 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](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html). 4. Clique em **Data Source - LDAP Attribute Mapping** para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no Homebase. 5. 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](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html), que podem ser usados durante [automações programadas](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) e [orientadas por eventos](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html). 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: 1. Em Outbound Webhook, clique em **Homebase Webhook Configuration**. 2. Clique em **+ Add Webhook**. 3. Digite um **nome** e uma **descrição** para esse webhook. 4. Decida a **action** que deve ser executada e consulte as [referências de API do Homebase](https://app.joinhomebase.com/api-docs) para obter os detalhes da API, como URL, cabeçalhos, parâmetros e outros requisitos. 5. Selecione o **HTTP method** que permitirá que você execute a ação desejada no endpoint no menu suspenso. 6. Digite o **endpoint URL**. 7. Configure **Headers**, **Parameters**, e **Message Type** no formato apropriado com base na chamada de API que você gostaria de 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 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. 10. 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**.