
- 一览表
- 配置
Homebase
通过Homebase-ADManager Plus集成自动执行用户导流程
Homebase是一款基于云的员工管理软件,通过简化员工调度、时间跟踪、工资单和团队沟通,帮助组织提高运营效率并减轻行政负担。通过将ADManager集成到Homebase,IT团队可以跨Active Directory(AD)和Homebase同步员工数据,实现用户创建过程的自动化。这种集成确保了当新员工记录添加到Homebase时创建新用户,这些更改会自动反映在AD和其他连接的平台上,从而减少人工工作量并最大限度地减少错误。
自动创建用户
当新员工被添加到Homebase时,协调工作流程以自动在AD中创建用户,确保无缝导流程。同样,在 AD 中创建用户时,工作流程可以触发将该员工添加到 Homebase,使两个系统保持同步。
同步用户更改
当Personio、部门或联系信息等用户详细信息在AD中更新时,它们会自动与Homebase同步,确保跨平台一致和准确的用户配置文件。
如何集成ADManager Plus和Homebase
先决条件
提供持有人令牌以检索所需的信息并在Homebase中执行任务。有关更多详细信息,请参阅 Homebase API 参考资料。
特权
导入用户(入站操作):确保用于授权的帐户具有读取所有用户帐户的权限。
要在 Homebase 中执行任何操作或查询(出站操作):确保用于授权的帐户具有执行所需操作的权限。
注意:ADManager Plus附带一组预配置的API,有助于执行集成的基本操作。如果您所需的操作不可用,请从Homebase API文档中收集必要的API详细信息,以便在入站/出站webhook下进行配置,以执行所需操作。授权配置
- 登录 ADManager Plus,然后导航到“自动化”选项卡。
- 在左侧窗格的“配置”下,单击“应用程序集成”。
- 在“企业应用程序”下,单击“Homebase”。
- 打开“启用 Homebase 集成”按钮。
- 在“Homebase 配置”页面中,点按“授权”。
- 执行在Homebase中生成B earer令牌的步骤,并将Bearer令牌粘贴到Value字段中。
- 点按“配置”。
入站webhook配置
入站webhook允许您从Homebase获取用户数据到ADManager Plus。本节中配置的属性映射可以在自动化配置期间选择为数据源。
要为 Homebase 配置入站 webhook:
- 在“Inbound Webhook”下,单击“Homebase Endpoint Configuration”(Homebase Endpoint Configuration)。
如果您想使用此预配置的端点,请将{location_uuid}和{Employee Id}替换为Endpoint URL字段中的Homebase实例。但是,如果您想使用新的端点来导入用户,您可以使用+添加API端点按钮进行配置,并根据Homebase API参考填写必填字段。要了解如何操作,请单击此处。
笔记:
- API键值对被预配置为标题,用于在authorization配置期间配置的API请求进行身份验证。
- 宏:您可以将宏添加到端点配置中,以便使用宏选择器组件根据您的要求动态更改宏。
- 参考Homebase API参考,并在需要时配置其他标题和参数。
完成后,单击“测试并保存”。响应窗口将显示可以使用API调用获取的所有请求参数。验证请求的参数是否已调用操作后,单击“继续”。
笔记:
- 要仅获取特定参数,请参考Homebase API参考以获取必须配置的参数。
- 您可以使用+添加API端点按钮为Homebase配置多个端点。要了解如何操作,请单击此处。
- 单击“数据源 - LDAP 属性映射”以匹配端点,并将 AD LDAP 属性与 Homebase 中的相应属性映射。
点按“+ 添加新配置”并执行以下操作:
- 输入配置名称和描述,然后从下拉菜单中选择自动化类别。
在“选择端点”字段中,选择所需的端点和用户独有的主密钥(例如,employeeIdentifier)。
注意:当配置多个端点时,此属性必须在所有端点中保持相同的值。- 在“Attribute Mapping”(属性映射)栏位中,从“LDAP Attribute Name”(LDAP Attribute Name)下拉菜单中选择该属性,并将其映射到 Homebase 中的相应属性。
- 如果您想为此创建新的自定义格式,请单击“添加新格式”。
- 点按“保存”。
出站webhook配置
出站webhook允许您将AD中所做的更改发送到Homebase,并在Homebase中执行任务,所有这些都来自ADManager Plus。本节中配置的webhook可以包含在编排模板中,可以在事件驱动和计划自动化期间使用。它们也可以直接应用于所需的用户,以执行一系列操作(管理>高级管理>编排)。
要为 Homebase 配置出站 webhook:
- 在“出站 Webhook”下,单击“Homebase Webhook 配置”。
- 点击+添加Webhook。
- 输入此webhook的名称和描述。
- 决定必须执行的操作,并参考Homebase API参考,了解API详细信息,如URL、标题、参数和其他要求。
- 从下拉菜单中选择HTTP方法,使您能够在端点上执行所需的操作。
- 输入端点网址。
- 根据您想要执行的API调用,以适当的格式配置标题、参数和消息类型。
- 点按“测试并保存”。
- 弹出窗口将显示AD用户和组的列表,用于测试配置的API调用。选择必须测试此API请求的所需用户或组,然后单击“确定”。这将对端点URL进行实时调用,所选对象将根据配置进行修改。
- 然后将显示webhook响应和请求详细信息。验证它们是否符合预期的 API 行为,然后单击“保存”。