Como configurar a integração ServiceDesk Plus no ADManager Plus

Documento de configuração: Integrando o ServiceDesk Plus ao ADManager Plus

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

• Widget: Execute ações do Active Directory (AD) diretamente no console do ServiceDesk Plus.

  Clique aqui para saber mais sobre a integração do ADManager Plus com o ServiceDesk Plus.

• Integração via aplicação baseada em API: Otimize o gerenciamento de tickets no ServiceDesk Plus 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

O ServiceDesk Plus utiliza chaves de API para autorizar solicitações.

Privilégios

Para importar usuários de tickets (ação de entrada): a conta usada na autorização deve ter permissão para ler todos os tickets.

Para executar qualquer ação ou consulta no ServiceDesk Plus (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 ServiceDesk Plus Integration.
• Ative a opção Enable ServiceDesk Plus Integration.
• Na página Enable ServiceDesk Plus Integration, clique em Authorization..
• Execute as etapas para gerar as chaves e o token de API no ServiceDesk Plus e substitua {AUTH_TOKEN_SDP_OP} pelo valor obtido.
• Clique em Configure.

Configuração de webhook de entrada

O webhook de entrada permite ao ADManager Plus obter dados de usuários do ServiceDesk Plus, extraindo as informações necessárias dos campos do ticket. 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 ServiceDesk Plus:

• Em Inbound Webhook, clique em ServiceDesk Plus Endpoint Configuration.
• Na aba ServiceDesk Plus Endpoint Configuration, você encontrará o endpoint pré-configurado ENDPOINT DE USUÁRIOS ServiceDesk Plus, com campos para a URL do endpoint, Método de API, Cabeçalhos e Parâmetros.
• Caso queira usar este endpoint pré-configurado, substitua {SDP_SERVER} pela URL do porta da sua instância do ServiceDesk Plus no campo Endpoint URL.
• Na seção Header , substitua {SDP INSTANCE HOST} pelo nome do host da sua instância do ServiceDesk Plus.
• Substitua o parâmetro {INPUT_DATA} pelos dados de entrada desejados. Nos dados de entrada gerados, forneça as chaves dos campos necessários para a integração. Para campos personalizados, você encontra as chaves em Setup > Customization > Additional Fields.

  Exemplos de dados de entrada:

  • Exemplo 1: {"list_info": {"row_count": 20,"start_index": 1,"sort_field": "subject","sort_order": "asc","get_total_count": true,"search_fields": {"subject": "New hire","priority.name": "high"}}}
  • Exemplo 2: {"list_info":{"row_count":"100","start_index":1,"fields_required":["subject","status","udf_fields.udf_char1","udf_fields.udf_char2","udf_fields.udf_long1"],"search_criteria":[{"field":"last_updated_time","condition":" is","value":"$(LAST_24_HRS)"},{"field":"subject","condition":"like","value":"Novo colaborador ingressa na organização","logical_operator":"and"}],"sort_fields":[{"field":"subject","order":"asc"}]}}

  

• 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 ServiceDesk Plus. 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 ServiceDesk Plus 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. Após verificar se os parâmetros desejados foram retornados, clique em Proceed.

  Nota:

  • Consulte as referências de API do ServiceDesk Plus para verificar quais parâmetros configurar e retornar apenas os dados desejados.
• Clique em Data Source - LDAP Attribute Mapping para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes no tickets do ServiceDesk Plus./li>
• Clicque 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 ticket [por exemplo, ID(resquest.id)].
  • No campo Attribute Mapping, selecione o atributo LDAP Attribute Name no menu suspenso e associe-o à coluna correspondente no ServiceDesk Plus.
  • Se quiser criar um formato personalizado, clique em Add New Format.
  Clique em Save.

Configuração de webhook de saída

Webhooks de saída permitem enviar alterações feitas no AD para o ServiceDesk Plus e executar tarefas no ServiceDesk Plus diretamente do ADManager Plus. Os webhooks configurados podem ser incorporados a Modelos de Orquestração, permitindo acionadas por eventos and automações agendadas. To configure outbound webhooks for ServiceDesk Plus:

• Em Outbound Webhook, clique em ServiceDesk Plus 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 ServiceDesk Plus 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 Cabeçalhos, Parâmetros, e Corpo da mensagem no formato apropriado para a chamada de API desejada.

  

• 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.

Assista a este vídeo passo a passo para integrar o ADManager Plus da ManageEngine ao ServiceDesk Plus de maneira simples.