# ServiceDesk Plus

![ServiceDesk Plus](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/marketplace-servivedeskplus-logo-24.png)

Unifique o gerenciamento de serviços de TI e de identidades com o ServiceDesk Plus e o ADManager Plus

**Categorias:** Provisionamento de identidade · Gerenciamento de tickets

A integração do ServiceDesk Plus ao AD por meio do ADManager Plus permite que os administradores de TI automatizem o gerenciamento do ciclo de vida de identidades diretamente no console do ServiceDesk Plus. Essa integração simplifica o gerenciamento de contas de usuário no Active Directory, Exchange, Microsoft 365 e outras plataformas conectadas, vinculando solicitações de serviço de TI a tarefas gerenciamento de identidade e acesso.

## Visão geral do produto

### Gerenciamento de incidentes

Registre, acompanhe e resolva incidentes rapidamente, reduzindo o tempo de inatividade com um console centralizado que oferece monitoramento e geração de relatórios em tempo real.

### Gerenciamento de mudanças

As equipes de TI podem acompanhar e priorizar solicitações de mudança com facilidade, aproveitando automação avançada e workflows. Simplifique o processo de solicitações, defina prioridades e implemente as mudanças para minimizar possíveis impactos negativos no sistema.

### Gerenciamento de Active Directory pelo help desk

Crie, modifique e desprovisione automaticamente contas de usuário no AD, Exchange e Microsoft 365 diretamente pelo console do ServiceDesk Plus.

## Configuração

### 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:

1. **Widget**: Execute ações do Active Directory (AD) diretamente no console do ServiceDesk Plus.  
   Clique [aqui](https://www.manageengine.com/products/ad-manager/admanager-kb/how-to-integrate-admanager-plus-with-service-desk-plus.html) para saber mais sobre a integração do ADManager Plus com o ServiceDesk Plus.

2. **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](https://help.servicedeskplus.com/api/rest-api.html%24key) 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.

> **Nota:** O ADManager Plus oferece um conjunto pré-configurado de APIs para efetuar as ações básicas da integração. Se precisar executar alguma ação não suportada por padrão, consulte a documentação de API do [ServiceDesk Plus](https://help.servicedeskplus.com/api/rest-api.html) para obter os detalhes necessários para a configuração de webhooks de entrada e saída.

### 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](https://www.manageengine.com/products/service-desk/sdpod-v3-api/SDPOD-V3-API.html) 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](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html).

Para configurar um webhook de entrada para o ServiceDesk Plus:

1. Em *Inbound Webhook*, clique em **ServiceDesk Plus Endpoint Configuration**.
2. 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**.
3. Caso queira usar este endpoint pré-configurado, substitua **{SDP_SERVER}** pela [URL do porta](https://www.manageengine.com/products/service-desk/sdpod-v3-api/getting-started/portals.html) da sua instância do ServiceDesk Plus no campo **Endpoint URL**.
4. Na seção **Header**, substitua **{SDP INSTANCE HOST}** pelo nome do host da sua instância do ServiceDesk Plus.
5. 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"}]}}`

![Inbound webhook configuration](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/servicedesk-plus-active-directory-integration-with-admanager-plus.png)

6. 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](https://www.manageengine.com/products/service-desk/sdpod-v3-api/SDPOD-V3-API.html). Clique [aqui](https://www.manageengine.com/products/ad-manager/help/admin-settings/third-party-integrations/hrms.html) 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](https://www.manageengine.com/products/service-desk/sdpod-v3-api/SDPOD-V3-API.html) e configure cabeçalhos ou parâmetros, se necessário.

7. 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](https://www.manageengine.com/products/service-desk/sdpod-v3-api/SDPOD-V3-API.html) para verificar quais **parâmetros** configurar e retornar apenas os dados desejados.

8. Clique em **Data Source - LDAP Attribute Mapping** para vincular endpoints e mapear atributos LDAP do AD aos atributos correspondentes nos tickets do ServiceDesk Plus.
9. 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 ticket (por exemplo, ID(request.id)).
   - No campo **Attribute Mapping**, selecione o atributo LDAP 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**.

10. [Configure an automation](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) com a ação necessária, frequência de repetição e a configuração de mapeamento de atributos criada acima.

### 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](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html), permitindo ações [acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) e [automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html).

Para configurar webhooks de saída para o ServiceDesk Plus:

1. Em *Outbound Webhook*, clique em **ServiceDesk Plus Webhook Configuration**.
2. Clique em **+ Add Webhook**.
3. Insira um nome e uma descrição para este webhook.
4. Defina a ação a ser executada e consulte as [referências de API do ServiceDesk Plus](https://www.manageengine.com/products/service-desk/sdpod-v3-api/SDPOD-V3-API.html) para obter detalhes como URL, Cabeçalhos, Parâmetros e demais requisitos.
5. Selecione no menu suspenso o método HTTP que permitirá executar a ação desejada no endpoint.
6. Insira a URL do endpoint.
7. Configure **Cabeçalhos, Parâmetros** e **Corpo da mensagem** no formato apropriado para a chamada de API desejada.

![Inbound webhook configuration](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/servicedesk-plus-active-directory-integration-with-admanager-plus-01.png)

8. 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 e clique em **OK**.
9. Os detalhes da solicitação e da resposta do webhook serão exibidos. Verifique se a API está respondendo corretamente e clique em **Save**.
10. Os webhooks configurados podem ser incorporados a [Modelos de Orquestração](https://www.manageengine.com/products/ad-manager/help/orchestration/new-orchestration-template.html) — permitindo [automações agendadas](https://www.manageengine.com/products/ad-manager/help/automation/configuring-automation.html) ou [acionadas por eventos](https://www.manageengine.com/products/ad-manager/help/orchestration/orchestration-profile.html) — 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.

### Vídeo tutorial

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

![Thumbnail](https://cdn.manageengine.com/sites/meweb/images/br/active-directory-360/images/servicedesk-plus-active-directory-integration-with-admanager-plus-video-thumbnail-25.png)

## Ações suportadas

- Provisionamento de usuário
- Habilitar ou desabilitar contas de usuário
- Redefinir senhas
- Desbloquear contas de usuário
- Desprovisionamento de usuário
- Adicionar usuários a grupos
- Remover usuários de grupos
- Modificar departamento
- Modificar gestor
- Definir permissões de pasta
- Revogar permissões de pasta