ClickUp

查看更多 

先决条件

ClickUp使用OAuth 2.0来授权API请求，并需要client_id和client_secret凭据进行授权。

特权

• 导入用户（入站操作）：确保用于授权的帐户具有读取所有用户帐户的权限。
• 要在ClickUp（出站操作）中执行任何操作或查询：确保用于授权的帐户具有执行所需操作的权限。

注意：ADManager Plus附带一组预配置的API，可帮助您执行集成的基本操作。如果您所需的操作不可用，请从ClickUp API文档中收集必要的API详细信息，以配置入站或出站webhook以执行所需操作。

授权配置

• 登录 ADManager Plus，然后导航到“自动化”选项卡。
• 在左侧面板的“配置”下，单击“应用程序集成”。
• 在“企业应用程序”下，点按“ClickUp”。
• 在ClickUp配置页面上，打开启用ClickUp集成按钮。
• 点按“授权”。
• 输入凭据。
• 点按“配置”。

入站webhook配置

入站网络钩子允许您将用户数据从ClickUp导入ADManager Plus。本节中配置的属性映射可以在自动化配置期间选择为数据源，以便在从API响应中收到的用户列表中执行所需的操作。为ClickUp配置入站webhook：

• 在Inbound Webhook下，单击ClickUp Endpoint Configuration。
• 在“端点配置”选项卡上，将 {teamId} 替换为“端点 URL”字段中 ClickUp 实例的 teamId。如果您想使用新的端点导入用户，您可以通过单击+添加API端点按钮并根据ClickUp的API参考填写必填字段来配置一个。点击此处了解如何操作。

笔记：

• API键值对预先配置为身份验证API请求的标头，如授权配置期间配置的那样。
• 您可以将宏添加到端点配置中，以便使用宏选择器组件根据您的要求动态更改它。
• 如果需要，请参考ClickUp的API参考来配置其他标题和参数。
• 点按“测试并保存”。响应窗口将显示可以使用API调用获取的所有请求参数。点按“继续”。

笔记：

• 参考ClickUp的API参考，了解必须配置的参数，以便仅获取特定参数。
• 您可以使用+添加API端点按钮为ClickUp配置多个端点。点击此处了解如何操作。
• 单击数据源-LDAP属性映射以匹配端点，并将AD LDAP属性映射到ClickUp中的相应属性。ADManager Plus还允许您自定义ClickUp中的属性格式。
• 单击“+ 添加新配置”。
• 输入配置名称和描述，然后从下拉菜单中选择自动化类别。
• 在“选择端点”字段中，选择所需的端点和用户独有的主密钥（例如，员工标识符）。

注意：当配置了多个端点时，此属性必须在所有端点上保持相同的值。

• 在“Attribute Mapping”（属性映射）字段中，从“LDAP Attribute Name”（LDAP Attribute Name）下拉菜单中选择该属性，并将其映射到 ClickUp 中的相应列。
• 如果您想为此创建新的自定义格式，请单击“映射属性”。
• 点按“保存”。

出站webhook配置

出站webhook允许您将AD中所做的更改发送到ClickUp，并在ClickUp中执行任务——所有这些都来自ADManager Plus。出站Webhook部分中配置的webhook可以包含在编排模板中，这些模板又可以在事件驱动和计划自动化期间使用。它们也可以直接应用于所需的用户，在管理>高级管理>编排下对他们执行一系列操作。要为ClickUp配置出站webhook：

• 在“Outbound Webhook”下，单击“ClickUp Webhook Configuration”（ClickUp Webhook配置）。
• 点击+添加Webhook。
• 输入此webhook的名称和描述。
• 决定必须执行的操作，并参考ClickUp的API参考，了解API详细信息，如URL、标题、参数和其他要求。
• 从下拉菜单中选择HTTP方法，使您能够在端点上执行所需的操作。
• 输入端点网址。
• 根据您想要执行的API调用，以适当的格式配置标题、参数和消息类型。
• 点按“测试并保存”。
• 然后，弹出窗口将显示AD用户和组的列表，您可以在其中测试配置的API调用。选择需要测试此API请求的所需用户或组，然后单击OK。这将实时调用端点URL，所选对象将根据配置进行修改。
• 然后将显示webhook响应和请求详细信息。验证它们是否符合预期的 API 行为，然后单击“保存”。