Como configurar a integração ServiceNow no ADManager Plus

O ADManager Plus oferece duas formas de integração com o ServiceNow:

• Widget: Execute ações do Active Directory (AD) diretamente no console do ServiceNow. Clique AQUI para saber mais sobre a integração do ADManager Plus com o ServiceNow.
• Integração via aplicação baseada em API: Otimize o gerenciamento de tickets no ServiceNow importando periodicamente os tickets relevantes e executando as ações necessárias no ADManager Plus. O guia a seguir traz instruções passo a passo para configurar essa integração por aplicação baseada em API.

Pré-requisitos

Certifique-se de ter em mãos seu nome de usuário e sua senha do ServiceNow. Essas credenciais podem ser obtidas diretamente no console do ServiceNow e são indispensáveis para autenticar o processo de integração.

Privilégios

Para importar usuários (ação de entrada): a conta usada na autorização deve ter permissão para ler todas as contas de usuário.

Para executar qualquer ação ou consulta no ServiceNow (ação de saída): a conta usada na autorização 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 ServiceNow.
• Ative a opção Enable ServiceNow Integration.
• Na página Enable ServiceNow Integration, clique em Authorization.
• Insira o nome de usuário e a senha do ServiceNow.
Clique em Configure. .

Configuração de webhook de entrada

O webhook de entrada permite ao ADManager Plus obter dados de usuários diretamente do ServiceNow. 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 ServiceNow:

• Em Inbound Webhook, clique em ServiceNow Endpoint Configuration.
• Na aba Endpoint Configuration, você encontrará um endpoint pré-configurado ServiceNow USERS ENDPOINT, com campos para a URL do endpoint, Método de API, Cabeçalhos e Parâmetros.
• Para usar este endpoint pré-configurado, substitua {SERVICENOW-INSTANCE} pelo nome da sua instância do ServiceNow e {TABLE_NAME} pelo nome da tabela de usuários correspondente (por exemplo, sys_user). No entanto, se desejar usar um novo endpoint para importar usuários, clique em + Add API endpoint e preencha os campos obrigatórios conforme as referências de API do ServiceNow.. 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 definido durante a Configuração de Autorização.
• É 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 ServiceNow e configure cabeçalhos ou parâmetros, se necessário.
• 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 ServiceNo para verificar quais parâmetros configurar e retornar apenas os dados desejados.
• Clique em + Add API endpoint para criar quantos endpoints forem necessários. Clique aqui para saber como.
• Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes no ServiceNow.

(O ADManager Plus também permite personalizar o formato de atributos importados do ServiceNow.)

• 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).
• 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 alterações feitas no AD usando o ADManager Plus para o ServiceNow ou busque ou encaminhe os detalhes necessários do ServiceNow e sincronize-os com o AD.

Para configurar um webhook de saída para o ServiceNow:

• Em Outbound Webhook, clique em ServiceNow 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 ServiceNow para obter detalhes como URL, Cabeçalhos, Parâmetros e demais requisitos.
• 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, 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..
• Os webhooks configurados podem ser incorporados a Modelos de Orquestração—permitindo automações agendadas ou acionadas por eventos—para que a ação definida no webhook de saída seja executada sequencialmente em um grupo de usuários ou em usuários individuais.
Nota: use macros para enviar os dados do objeto no qual o webhook é executado.