# LearnUpon ## Integre o LearnUpon com o ADManager Plus para automatizar a gestão de usuários Provisionamento de identidade O LearnUpon é um sistema de gestão de aprendizagem (LMS) projetado para oferecer experiências de treinamento impactantes e uma ampla variedade de atividades de treinamento, incluindo processo de onboarding de funcionários, educação de clientes, treinamento em conformidade e muito mais. Ele atende a organizações de todos os tamanhos, oferecendo ferramentas para criar, gerenciar e acompanhar programas de aprendizagem on-line. A integração do LearnUpon com o ADManager Plus permite que as empresas automatizem a gestão de contas de usuário no Active Directory (AD), Exchange, Microsoft 365 e outras aplicações empresariais. Qualquer mudança no status ou nos detalhes de um funcionário no LearnUpon será automaticamente sincronizada com esses sistemas, garantindo que os direitos de acesso permaneçam atualizados e impedindo o acesso não autorizado. ### Automatize o provisionamento de usuários Crie automaticamente contas de usuário no AD e atribua-as a grupos relevantes ou conceda as permissões necessárias às aplicações, garantindo que os funcionários tenham acesso imediato aos recursos de que precisam desde o primeiro dia. ### Atualizações de usuários Sincronize os dados dos funcionários no AD, Exchange, Microsoft 365 e outros sistemas em tempo real. ## Como integrar o ADManager Plus e o LearnUpon ### Pré-requisitos O LearnUpon usa a **Basic Authentication** para autorizar solicitações de API e requer credenciais de [username e password](https://docs.learnupon.com/api/) para autorização. ### Privilégios Para importar usuários (ação de entrada): Certifique-se de que a conta usada para autenticação tenha permissão para ler todas as contas de usuário. Para executar qualquer ação ou consulta no LearnUpon (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 puder ser executada, obtenha os detalhes necessários da API na documentação de API do LearnUpon para configurar webhooks de entrada/saída para executá-los. ## Configuração de autorização 1. Efetue login no **ADManager Plus** e navegue até a aba **Automation**. 2. No painel esquerdo, em Configuration, clique em **Application Integrations**. 3. Em Enterprise Applications, clique em **LearnUpon**. 4. Ative o botão **Enable LearnUpon Integration**. 5. Na página LearnUpon Configuration, clique em **Authorization**. 6. Insira as **credentials**. 7. Clique em **Configure**. ## Configuração do webhook de entrada O webhook de entrada permite buscar dados de usuário do LearnUpon 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 executar a ação desejada na lista de usuários recebida da resposta da API. Para configurar um webhook de entrada para o LearnUpon: 1. Em Inbound Webhook, clique em **LearnUpon Endpoint Configuration**. 2. Na aba Endpoint Configuration, um endpoint, LearnUpon USERS ENDPOINT, vem pré-configurado com campos **Endpoint URL**, **API Method**, **Headers**, e **Parameters** para buscar contas de usuários do LearnUpon. Para usar esse endpoint pré-configurado, substitua **{yourdomain}** pelo nome de domínio de sua instância do LearnUpon no campo Endpoint URL. Se desejar usar um novo endpoint para importar usuários, você pode configurar um usando o botão **+ Add API endpoint** e preenchendo os campos necessários de acordo com as [referências de API do LearnUpon](https://docs.learnupon.com/api/). Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) 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 as [referências de API do LearnUpon](https://docs.learnupon.com/api/) e configure cabeçalhos e parâmetros adicionais, se necessário. 3. Quando terminar, clique em **Test and Save**. Uma janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos usando a chamada de API. Clique em **Proceed**. **Observação:** - Consulte as [referências de API do LearnUpon](https://docs.learnupon.com/api/) para saber os **Parameters** que devem ser configurados para buscar apenas parâmetros específicos. - Você pode configurar vários endpoints para o LearnUpon usando o botão **+ Add API endpoint**. Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como. 4. Clique em **Data Source - LDAP Attribute Mapping** para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no LearnUpon. O ADManager Plus também permite que você personalize o formato do atributo do LearnUpon. 5. 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 a respectiva coluna no LearnUpon. - Se você quiser criar um novo formato personalizado para isso, clique em **Mapping Attribute**. - Clique em **Save**. ## Configuração do webhook de saída Um webhook de saída permite que você envie as mudanças feitas no AD usando o ADManager Plus para o LearnUpon e execute tarefas no LearnUpon — 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, por sua vez, podem ser usados em [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 (em **Management** > **Advanced Management** > **Orchestration**). Para configurar um webhook de saída para o LearnUpon: 1. Em Outbound Webhook, clique em **LearnUpon Webhook Configuration**. 2. Clique em **+ Add Webhook**. 3. Digite um **nome** e uma **descrição** para esse webhook. 4. Decida a ação que deve ser executada e consulte as [referências de API do LearnUpon](https://docs.learnupon.com/api/) para obter os detalhes da API, como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários. 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**.