# Zoom **Automatize a gestão de usuários do Zoom com a integração do ADManager Plus** *Categoria: Provisionamento de identidade* ## Visão geral O Zoom é uma importante plataforma de colaboração e videoconferência usada pelas empresas para realizar reuniões virtuais e facilitar o trabalho remoto. A integração entre o Zoom e o ADManager Plus permite que as organizações otimizem a criação e o provisionamento de usuários, sincronizando as mudanças de gestão de acesso de usuários do AD à sua conta do Zoom. Além disso, o ADManager Plus simplifica os procedimentos de exclusão e offboarding de usuários, permitindo a gestão eficiente das contas de usuários durante todo o período em que estiverem na organização. ### Automatize o processo de onboarding de usuários Crie automaticamente contas no Zoom para novos contratados no processo de onboarding, facilitando sua participação em reuniões virtuais e sessões colaborativas desde o primeiro dia. ### Permita o processo de offboarding oportuno Simplifique o processo de offboarding desativando ou excluindo automaticamente as contas no Zoom de funcionários que estão saindo da empresa, minimizando a intervenção manual. ## Como integrar o ADManager Plus e o Zoom **Pré-requisitos:** - O Zoom usa o OAuth 2.0 para autorizar solicitações de API. - Ele requer um [client_id e client_secret](https://marketplace.zoom.us/develop/create?source=devdocs) para autorização. **Privilégios:** 1. **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. 2. Para executar qualquer ação ou consulta no Zoom (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 ajudam a executar ações básicas com a integração. Se a ação de que você precisa não estiver disponível, obtenha os detalhes necessários da API na documentação de API do Zoom para configurar webhooks de entrada ou saída para executar as ações necessárias. ### 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 **Zoom**. 4. Ative o botão **Enable Trello Integration**. 5. Na página Zoom *Configuration*, clique em **Authorization**. 6. Execute as [etapas para gerar um client_id e um client_secret do Zoom](https://developers.zoom.us/docs/integrations/oauth/) e cole-os nos respectivos campos de valor. 7. Clique em **Configure**. ### Configuração do webhook de entrada Os webhooks de entrada permitem buscar dados de usuário do Zoom 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](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html). Para configurar um webhook de entrada para o Zoom: 1. Em *Inbound Webhook*, clique em **Zoom Endpoint Configuration**. 2. Na aba **Endpoint Configuration**, um endpoint (Zoom USERS ENDPOINT) vem pré-configurado com campos Endpoint URL, API Method, Headers e Parameters para buscar contas de usuários do Zoom. - Para usar esse endpoint pré-configurado, substitua `{subdomain}` pelo nome de domínio de sua instância do Zoom no campo Endpoint URL. - Para usar um novo endpoint, clique em **+ Add API endpoint** e preencha os campos necessários de acordo com a [documentação de API do Zoom](https://developers.zoom.us/docs/api/#rest-apis). - Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) para saber como configurar. **Observação:** - O par de valores de chave de API é pré-configurado como um cabeçalho para autenticar solicitações de API, conforme definido durante a **configuração de autorização**. - Macros: Você pode adicionar macros à configuração de seu endpoint para ajustá-lo dinamicamente conforme suas necessidades usando o componente de seleção de macros. - Consulte a [documentação de API do Zoom](https://developers.zoom.us/docs/api/#rest-apis) 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. 3. 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 os parâmetros retornados, clique em **Proceed**. **Observação:** - Consulte a [documentação de API do Zoom](https://developers.zoom.us/docs/api/#rest-apis) 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 Zoom 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 Zoom. 5. Clique em **+ Add New Configuration** e: - 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* 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 Zoom. - Se desejar criar um novo formato personalizado, clique em **Add New Format**. - Clique em **Save**. ### Configuração do webhook de saída Os webhooks de saída permitem enviar mudanças feitas no AD para o Zoom, buscar dados do Zoom e executar tarefas no Zoom — 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 aos usuários desejados para executar uma sequência de ações em **Management > Advanced Management > Orchestration**. Para configurar webhooks de saída para o Zoom: 1. Em *Outbound Webhook*, clique em **Zoom Webhook Configuration**. 2. Clique em **+ Add Webhook**. 3. Digite um nome e uma descrição para o webhook. 4. Defina a ação a ser executada e consulte a [documentação de API do Zoom](https://developers.zoom.us/docs/api/#rest-apis) para obter detalhes como URL, cabeçalhos e parâmetros. 5. Selecione o método HTTP apropriado no menu suspenso. 6. Digite o URL do endpoint. 7. Configure Headers, Parameters e Message Type no formato apropriado com base na chamada de API que será executada. 8. Clique em **Test and Save**. 9. Na janela pop-up: - Selecione o usuário ou grupo do AD para testar a chamada de API. - Clique em **OK** para realizar a chamada em tempo real. 10. Verifique a resposta do webhook e os detalhes da solicitação. 11. Confirme se o comportamento corresponde ao esperado e clique em **Save**.