• 一览表
  • 配置

相关应用程序

TopDesk

通过TOPdesk和ADManager Plus集成简化用户管理

身份配置

将领先的ITSM工具TOPdesk与ADManager Plus集成，使IT团队能够自动化和简化Active Directory（AD）、Exchange、Microsoft 365和其他关键平台的身份和访问管理任务。这种集成减少了手动工作量，最大限度地减少了错误，并通过自动化重复性任务（如用户配置、更新和取消配置）来确保高效的IT操作。

自动用户配置

整合TOPdesk的工单信息，以促进自动用户帐户管理。当需要创建、修改或删除新用户帐户时，可以从通过TOPdesk提交的工单中获取必要的详细信息，如员工姓名、部门、Personio和访问级别。

为访客提供临时用户帐户

管理Topdesk中访问者的临时请求，允许他们在特定时间内访问所需资源，而不会造成任何延迟，同时保护数据安全。

 

如何集成ADManager Plus和TopDesk

先决条件

TopDesk使用基本身份验证，并需要身份验证凭据：用户名、密码和子域凭据来授权API请求。

特权

导入用户（入站操作）：确保用于授权的帐户具有读取所有用户帐户的权限。

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

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

授权配置

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

入站webhook配置

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

  • 在“入站 Webhook”下，单击“TopDesk Endpoint Configuration”（TopDesk Endpoint Configuration）。

  • 在“端点配置”选项卡中，端点TopDesk USERS ENDPOINT预配置了端点URL、API方法、标题和参数字段，用于从TopDesk获取用户帐户。要使用此预配置的端点，请将{subdomain}替换为Endpoint URL字段中TopDesk实例的域名。如果您想使用新的端点导入用户，您可以使用+添加API端点按钮配置一个，并根据TopDesk的API引用填写必填字段。点击此处了解如何操作。

    笔记：

    • API键值对预先配置为用于验证授权配置期间配置的API请求的标头。
    • 宏：您可以将宏添加到端点配置中，以便使用宏选择器组件根据您的要求动态更改宏。
    • 参考TopDesk的API参考，如果需要，请配置其他标题和参数。

  • 完成后，单击“测试并保存”。响应窗口将显示可以使用API调用获取的所有请求参数。点按“继续”。

    笔记：

    • 参考TopDesk的API参考，了解必须配置的参数，以便仅获取特定参数。
    • 您可以使用+添加API端点按钮为TopDesk配置多个端点。点击此处了解如何操作。

  • 单击“数据源-LDAP属性映射”以匹配端点，并将AD LDAP属性与TopDesk中的相应属性进行映射。

    [ADManager Plus还允许您从TopDesk自定义属性格式]

  • 点按“+ 添加新配置”并执行以下操作：
    • 输入配置名称和描述，然后从下拉菜单中选择自动化类别。

    • 在“Select Endpoint”（选择端点）字段中，选择所需的端点和用户独有的主密钥（例如，employeIdentifier）。

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

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

出站webhook配置

出站webhook允许您使用ADManager Plus将AD中所做的更改更新到TopDesk，或从TopDesk获取或转发所需的详细信息，并将其与AD同步。要为TopDesk配置出站webhook：

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

注意：配置的webhook可以集成到编排模板中——启用计划或事件驱动的自动化——对一组用户或一组用户或对单个用户连续执行一系列操作。