• Overview
  • Configuração

Aplicações relacionadas

TopDesk

Simplifique o gerenciamento de usuários com a integração do TOPdesk ao ADManager Plus

Provisionamento de identidade

A integração do TOPdesk, uma ferramenta líder em ITSM, com o ADManager Plus permite que as equipes de TI automatizem e otimizem tarefas de gerenciamento de identidade e acesso no Active Directory (AD), Exchange, Microsoft 365 e outras plataformas críticas. Essa integração reduz o esforço manual, minimiza erros e garante a eficiência das operações de TI, automatizando tarefas repetitivas, como provisionamento, atualizações e desprovisionamento de usuários.

 

Provisionamento de usuário automatizado

Integre informações de tickets do TOPdesk para facilitar o gerenciamento automatizado de contas de usuários. Quando novas contas de usuário precisam ser criadas, modificadas ou excluídas, os detalhes necessários, como nome do colaborador, departamento, função e níveis de acesso, podem ser obtidos nos tickets enviados através do TOPdesk.

 

Provisionar conta de usuário contingente para visitantes

Gerencie solicitações ad hoc de visitantes no TOPdesk, concedendo a eles acesso aos recursos necessários por uma duração específica, sem causar atrasos e, ao mesmo tempo, protegendo a segurança dos dados.

 

Como integrar o ADManager Plus e o TopDesk

Pré-requisitos

O TopDesk usa autenticação básica e requer credenciais de autenticação: Nome de usuário, senha e credenciais de subdomínio para autorizar a chamada de API.

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 TopDesk (ação de saída): A conta usada deve ter permissão para realizar a ação desejada.

Nota: O ADManager Plus oferece um conjunto pré-configurado de APIs que auxiliam na execução das ações básicas da integração. Se precisar executar alguma ação não suportada por padrão, consulte a referência de API do TopDesk 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 a guia Automation.
  • No painel esquerdo, em Configuration, clique em Application Integrations.
  • Em Enterprise Applications, clique em TopDesk.
  • Ative o botão Enable TopDesk Integration.
  • Na página TopDesk Configuration, clique em Authorization.
  • Insira as credenciais de autenticação.
  • Clique em Configure.

Configuração de webhook de entrada

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

  • Em Inbound Webhook, clique em TopDesk Endpoint Configuration.

  • Na guia Endpoint Configuration, você encontrará um endpoint pré-configurado, o ENDPOINT DE USUÁRIOS do TopDesk, com campos URL do endpoint, Método de API, Cabeçalhos e Parâmetros para obter contas de usuário do TopDesk. Para usar esse endpoint pré-configurado, substitua {subdomain} pelo nome de domínio da sua instância do TopDesk no campo Endpoint URL. 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 TopDesk. 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 configurado durante a Configuração de autorização.
    • Macros: É 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 TopDesk e configure cabeçalhos e parâmetros adicionais, 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 TopDesk para saber os parâmetros que devem ser configurados para obter apenas parâmetros específicos.
    • Você pode configurar diversos endpoints para o TopDesk 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 TopDesk.

    [O ADManager Plus também permite que você personalize formatos de atributo do TopDesk]

  • 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, selecione o endpoint desejado e uma Chave primária exclusiva a cada 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 à coluna correspondente no TopDesk.
    • Se quiser criar um formato personalizado, clique em Mapping Attribute.
    • Clique em Save.

Configuração de webhook de saída

O webhook de saída permite que você atualize as mudanças feitas no AD usando o ADManager Plus para o TopDesk ou busque ou encaminhe os detalhes necessários do TopDesk e os sincronize com o AD. Para configurar um webhook de saída para o TopDesk:

  • Em Outbound Webhook, clique em TopDesk 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 TopDesk 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, 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.

Nota: Os webhooks configurados podem ser integrados aos Modelos de orquestração, possibilitando automações agendadas ou acionadas por eventos para executar consecutivamente uma sequência de ações em um grupo de usuários ou em um grupo de usuários ou em usuários individuais.