Como configurar a integração do Domo no ADManager Plus

Pré-requisitos

Certifique-se de fornecer a chave de API e as credenciais para recuperar as informações desejadas e executar tarefas no Domo. Consulte as referências de API do Domo 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 Domo (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.
• Em Application Integrations, localize e selecione Domo.
• Ative o botão Enable Domo Integration.
• Na página Domo Configuration, clique em Authorization.
• Escolha Bearer como o tipo de autorização para a integração do API.
• Navegue e clique em API widget com o painel de configuração da integração para configurar a autenticação personalizada.
• Na janela API for Authorization:
  • Vá para o campo Endpoint URL e substitua {hostname} pelo nome do host da sua instância do Domo.
  • Na seção Headers, insira os seguintes detalhes:
    • client_id: Insira o ID do cliente associado à sua instância do Domo.
    • client_secret: Insira o segredo do cliente correspondente à sua instância do Domo.
    • Escopo: Especifique o escopo necessário para sua integração.
    • Na seção Parameters, substitua os espaços reservados {username}, {password} e {company} pelas credenciais e pelo identificador da empresa correspondentes à sua instância do Domo.
  • Clique no botão Test and Configure para validar as configurações e concluir a integração.
  • Selecione o access token gerado e clique em Save.
• Clique em Configure.

Configuração de webhook de entrada

O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do Domo. O mapeamento de atributos definido aqui poderá ser selecionado como fonte de dados ao configurar automatizações. Para configurar um webhook de entrada para o Domo:

• Em Inbound Webhook, clique em Domo Endpoint Configuration.
• No campo Endpoint URL, substitua {hostname} pelo nome do host da sua instância do Domo.
• Insira a API-Key associada à sua instância do Domo na seção Headers.
• Substitua {username}, {password} e {company} no campo Message Type pelas respectivas credenciais para sua instância do Domo.
• Clique em Test and Configure para validar as configurações e concluir o processo de configuração.
• Clique em Test & Save. A janela de resposta exibirá todos os parâmetros solicitados que podem ser obtidos pela chamada da API. Após verificar se os parâmetros desejados foram retornados, clique em Proceed.

Nota:

• Consulte as referências de API do Domo para saber os parâmetros que devem ser configurados para obter apenas parâmetros específicos.
• Você pode configurar diversos endpoints para o Domo 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 Domo.
• 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 LDAP Attribute Name e associe ele ao atributo correspondente no Domo.
  • Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.
  • Clique em Save.

Configuração de webhook de saída

Webhooks de saída permitem que você envie mudanças feitas no AD para o Domo e execute tarefas no Domo — tudo 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 automações 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 Domo:

• Em Outbound Webhook, clique em Domo 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 referências de API do Domo 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 para a chamada de API desejada.
• 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.