Como configurar a integração do Zoho People no ADManager Plus

Pré-requisitos

• O Zoho People usa credenciais OAuth2.0 para autorizar a solicitação de API.
• Credenciais de autenticação necessárias: Client Id e Client Secret obtidas do Zoho People.

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 People (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

Configuração de autorização

• Faça login no ADManager Plus e acesse Directory/Application Settings.
• Vá para Application Integrations e, então, pesquise e selecione Zoho People.
• Ative o botão Enable Zoho People Integration.
• Ative o botão Enable Zoho People Integration.
• Em Server Details, insira - Client Id, Client Secret e a URL da instância da sua Conta Zoho.
• Clique em Configure.

Configuração de entrada

O webhook de entrada permite que você obtenha dados do usuário do Zoho People e os mova para o ADManager Plus. O mapeamento de atributos configurado nesta seção pode ser selecionado como fonte de dados durante a configuração de automações para executar a ação desejada na lista de usuários retornada pela resposta da API. Para configurar um webhook de entrada para o Zoho People:

• Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos respectivos atributos no Zoho People.

  [O ADManager Plus também permite que você personalize o formato de atributo a partir Zoho People]

• 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, escolha o endpoint desejado e defina uma Chave primária única para o usuário (por exemplo, employeeIdentifier).
  Nota: Quando vários endpoints estiverem configurados, essa chave deve manter o mesmo valor em todos eles.
  • No campo Attribute Mapping, selecione o atributo no menu suspenso Nome do atributo LDAP e associe ele à coluna correspondente no Zoho People.
  • Se quiser criar um formato personalizado, clique em Mapping Attribute.
  • Clique em Save.
• Configure uma automação informando a ação desejada, a frequência de repetição e mapeamento de atributos criado acima.

Configuração de webhook de saída

O webhook de saída permite que você atualize as mudanças feitas no AD usando o ADManager Plus para o Zoho People e sincronize elas com o AD. Para configurar um webhook de saída para o Zoho People:

• Em Outbound Webhook, clique em Zoho People Webhook Configuration.
• Clique em + Add Webhook.
• Insira um nome e uma descrição para este webhook.
• Decida sobre a ação que deve ser executada e consulte as de API do Zoho People 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 a Mensagem do corpo 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 enviará uma solicitação em tempo real para a URL do endpoint e aplicará as modificações configuradas aos objetos selecionados.
• Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em Save.
• Os webhooks podem ser integrados aos Modelos de orquestração, possibilitando automações agendadas ou acionadas por eventos para executar consecutivamente a ação configurada no webhook de saída entre as ações em um grupo de usuários ou em usuários individuais.
Nota: use macros para enviar os dados do objeto em que o webhook é executado