
- Overview
- Configuração
ClickUp
Automatize a gestão de usuários e grupos do ClickUp com a integração do AD
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.
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.
- 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.
- 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).
- 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.
- 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.
Observação:
Observação:
Observação: Quando vários endpoints são configurados, esse atributo deve ter o mesmo valor em todos os endpoints.
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: