• Overview
  • Configuração

ClickUp

Automatize a gestão de usuários e grupos do ClickUp com a integração do AD

Gestão de projetosProvisionamento de identidade

Ao integrar o ADManager Plus com o ClickUp, as organizações podem gerenciar com eficiência as funções de usuário, as permissões e as estruturas de projeto, aumentando a eficiência operacional, a segurança e o alinhamento entre os processos de TI e de negócios. Essa integração aproveita os dados existentes de usuários e grupos do AD para provisionar automaticamente grupos de usuários, espaços e equipes no ClickUp, garantindo a consistência entre os sistemas e reduzindo a necessidade de intervenção manual.

 

Provisione permissões de grupos

Garanta que as estruturas de grupos de usuários no ClickUp sejam espelhadas no AD, simplificando os controles de acesso e as permissões baseadas em grupos em toda a organização.

 

Crie espaços no ClickUp

A integração do ADManager Plus com o ClickUp permite que as organizações provisionem automaticamente os espaços no ClickUp com base nas permissões de usuários e grupos no AD, garantindo controles de acesso contínuos e o alinhamento dos espaços do projeto com as funções organizacionais.

 

Crie equipes no ClickUp

Quando integrado ao ADManager Plus, o ClickUp permite que as organizações criem e gerenciem automaticamente grupos de usuários, ou equipes, com base nas funções e permissões do AD, garantindo o agrupamento adequado de usuários no espaço de trabalho.

 

Pré-requisitos

O ClickUp usa o OAuth 2.0 para autorizar solicitações de API e requer as credenciais client_id e client_secret para autorização.

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 ClickUp (ações de saída): Certifique-se de que a conta usada para autorização tenha permissão para executar a ação desejada.
Observação: O ADManager Plus vem com um conjunto pré-configurado de APIs que ajuda a executar ações básicas com a integração. Se a ação de que você precisa não estiver disponível, obtenha os detalhes necessários da API na documentação de API do ClickUp para configurar um webhook de entrada ou saída para executar a ação necessária.

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 ClickUp.
  • Na página ClickUp Configuration, ative o botão Enable ClickUp Integration .
  • Clique em Authorization.
  • Insira as credenciais.
  • Clique em Configure.

Configuração do webhook de entrada

Um webhook de entrada permite importar dados de usuário do ClickUp 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 executar a ação desejada na lista de usuários recebida da resposta da API. Para configurar um webhook de entrada para o ClickUp:

  • Em Inbound Webhook, clique em ClickUp Endpoint Configuration.
  • Na aba Endpoint Configuration, substitua {teamId} pelo teamId de sua instância do ClickUp 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 ClickUp. 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 ClickUp 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. Clique em Proceed.
  • Observação:

    • Consulte as referências de API do ClickUp para saber os parâmetros que devem ser configurados para buscar apenas parâmetros específicos.
    • Você pode configurar vários endpoints para o ClickUp 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 ClickUp. O ADManager Plus também permite que você personalize o formato do atributo do ClickUp.
    • 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 a respectiva coluna no ClickUp.
    • Se você quiser criar um novo formato personalizado para isso, clique em Mapping Attribute.
    • 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 ClickUp e execute tarefas no ClickUp - tudo a partir do ADManager Plus. Os webhooks configurados na seção Outbound Webhook 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 ClickUp:

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