Como integrar o Zoho Mail ao ADManager Plus

Pré-requisitos:

Certifique-se de fornecer o client_id e o client_secret para acessar as informações desejadas e executar tarefas no Zoho Mail. Consulte as referências da API do Zoho Mail para mais detalhes.

Privilégios:

• Importar usuários (ação de entrada): A conta utilizada na autorização deve ter permissão para ler todas as contas de usuário.
• Para executar qualquer ação ou consulta no Zoho Mail (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

NotaConfiguração de autorização

• Faça login no ADManager Plus e acesse a guia Automation.
• No painel esquerdo, em Configuration, clique em Application Integrations.
• Em Enterprise Applications, clique em Zoho Mail.
• Ative o botão Enable Zoho Mail Integration.
• Na página Zoho Mail Configuration, clique em Authorization.
• Execute as etapas para gerar o client_id e o client_secret a partir do Zoho Mail e cole os dados nos respectivos campos de valor.
• Clique em Configure.

Configuração de webhook de entrada

O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do Zoho Mail. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a configuração das automações para

Para configurar um webhook de entrada para o Zoho Mail:

• Em Inbound Webhook, clique em Zoho Mail Endpoint Configuration.
• Na guia Endpoint Configuration, você encontrará um endpoint pré-configurado, o ENDPOINT DE USUÁRIOS do Zoho Mail, com campos para a URL do endpoint, Método de API, Cabeçalhos e Parâmetros para obter contas de usuário do Zoho Mail. Se você desejar usar esse endpoint pré-configurado, substitua {subdomain} pelo nome de domínio da sua instância do Zoho Mail no campo Endpoint URL. No entanto, se você desejar usar um novo endpoint para importar usuários, você poderá configurar um usando o botão + Add API endpoint e preenchendo os campos obrigatórios de acordo com as referências de API do Zoho Mail. Clique aqui para saber como.

Nota:

• O par chave-valor da API já vem pré-configurado como cabeçalho para autenticar as solicitações de API, conforme configurado durante a Configuração de autorização.
• Macros: É possível adicionar macros na configuração do endpoint para alterá-lo dinamicamente por meio do componente de seleção de macros.
• Consulte as referências de API do Zoho Mail e configure cabeçalhos e parâmetros adicionais, se necessário.
• Na guia Settings, a opção Repeat Calling This Endpoint foi habilitada por padrão para chamar repetidamente a API até que você obtenha todos os dados requeridos. A Repeat Call Configuration foi pré-configurada para aumentar o valor do parâmetro de página em 1 para obter 100 objetos em cada chamada de endpoint da API. No campo Repeat Call Criteria, a condição foi pré-configurada para repetir a chamada de API até que a resposta não apresente valores.
• Após concluir, clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Clique em Proceed.

Nota:

• Consulte as referências de API do Zoho Mail para saber os parâmetros que devem ser configurados para obter apenas parâmetros específicos.
• Você pode configurar diversos endpoints para a SurveyMonkey usando o botão + Add API endpoint. Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos respectivos atributos no Zoho Mail.
• Clique em + Add New Configuration e faça o seguinte:
  • Insira o Nome da configuração e a Descrição, e selecione a Categoria de automação no menu suspenso.
  • No campo Select Endpoint, selecione o endpoint desejado e uma chave primária exclusiva a cada usuário (por exemplo, employeeIdentifier).
  Nota: Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.
  • NotaNo campo Attribute Mapping, selecione o atributo no menu suspenso Nome do atributo LDAP e associe ele à coluna correspondente no Zoho Mail.
  • NoSe você quiser criar um novo formato personalizado para isso, clique em Add New Format.
  • Clique em Save.

Configuração de webhook de saída

Os webhooks de saída permitem que você envie mudanças feitas no AD para o Zoho Mail, obtenha dados do Zoho Mail e execute tarefas no Zoho Mail a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos em Modelos de orquestração, que, por sua vez, podem ser usados durante automações acionadas por eventos e agendadas. Eles também podem ser aplicados diretamente aos usuários desejados para executar uma sequência de ações neles (Management > Advanced Management > Orchestration).

Para configurar webhooks de saída para o Zoho Mail:

• Em Outbound Webhook, clique em Zoho Mail Webhook Configuration.
• Clique em + Add Webhook.
• Insira um nome e uma descrição para este webhook.
• Defina a ação a ser executada e consulte as referências de API do Zoho Mail para obter os detalhes de API, tais como URL, cabeçalhos, parâmetros e outros requisitos que serão necessários.
• Selecione, no menu suspenso, o método HTTP que permitirá executar a ação desejada no endpoint.
• Insira a URL do endpoint.
• Configure os cabeçalhos, os parâmetros e o tipo de mensagem no formato apropriado com base na chamada de API que você deseja 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 para testar a chamada de API e clique em OK. Isso fará uma chamada em tempo real para a URL do endpoint e os objetos selecionados serão modificados de acordo com a configuração.
• Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em Save.