Como configurar a integração do Hive com o ADManager Plus

Pré-requisitos

Certifique-se de fornecer o token de portador para recuperar as informações desejadas e executar tarefas no Hive. Consulte as referências de API do Hive para obter mais detalhes.

Privilégios

• 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.
• Para executar qualquer ação ou consulta no Hive (ações de saída): Certifique-se de que a conta usada para autorização tenha permissão para executar a ação desejada.

Configuração de autorização

• Efetue login no ADManager Plus e navegue até a aba Automation.
• No painel esquerdo, em Configuration, clique em Application Integrations.
• Em Enterprise Applications, clique em Hive.
• Na página Hive Configuration, ative o botão Enable Hive Integration.
• Clique em Authorization.
• Execute as etapas para gerar o token de portador no Hive e cole o token de portador no campo Value.
• Clique em Configure.

Configuração do webhook de entrada

Um webhook de entrada permite importar dados de usuário do Hive 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. Para configurar um webhook de entrada para o Hive:

• Em Inbound Webhook, clique em Hive Endpoint Configuration.

• Na aba Endpoint Configuration, o endpoint Hive USERS ENDPOINT vem pré-configurado com os campos Endpoint URL, Method, Headers e Parameters preenchidos para buscar contas de usuário do Hive. Para usar esse endpoint pré-configurado, substitua o valor API_Key em Headers e, em Parameters, substitua os valores de UserId pelo valor de sua instância do Hive no campo Endpoint URL. No entanto, se quiser usar um novo endpoint para importar usuários, você pode configurá-lo clicando no + Add API Endpoint e preenchendo os campos necessários de acordo com as referências de API do Hive. Clique aqui 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.
  • Você pode adicionar macros à configuração de seu endpoint para mudá-la dinamicamente conforme seus requisitos usando o macro chooser component ().
  • Consulte as referências de API do Hive para configurar cabeçalhos e parâmetros adicionais, se necessário.

• 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 se os parâmetros solicitados foram chamados à ação, clique em Proceed.

  Observação:

  • Consulte as referências de API do Hive para saber os parâmetros que devem ser configurados para buscar apenas parâmetros específicos.
  • Você pode configurar vários endpoints para o Hive usando o + Add API Endpoint button. Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para corresponder endpoints e mapear os atributos LDAP do AD com os respectivos atributos no Hive.
• Clique em + Add New Configuration.
• 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 o respectivo atributo no Hive.
• Se você quiser criar um novo formato personalizado para isso, clique em Add New Format.
• Clique em Save.

Configuração do webhook de saída

Um webhook de saída permite que você envie mudanças feitas no AD para o Hive e execute tarefas no Hive - tudo a partir do ADManager Plus. Os webhooks configurados nesta seção podem ser incluídos nos modelos de orquestração, que, por sua vez, podem ser usados durante automações programadas e orientadas por eventos. 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 Hive:

• Em Outbound Webhook, clique em Hive Webhook Configuration.
• Clique em + Add Webhook.
• Digite um nome e uma descrição para esse webhook.
• Decida a ação que deve ser executada e consulte as referências de API do Hive para obter os detalhes da API, como URL, cabeçalhos, parâmetros e outros requisitos.
• Selecione o método HTTP que permitirá que você execute a ação desejada no endpoint no menu suspenso.
• Digite o URL do endpoint.
• Configure Headers, Parameters e Message Type no formato apropriado com base na chamada de API que você gostaria de executar.
• Clique em Test and Save.
• Uma janela pop-up exibirá uma lista de usuários e grupos do AD nos quais você pode testar a chamada de API configurada. Selecione os usuários ou grupos desejados sobre os quais 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.
• 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.