Authing 组织架构导入与第三方登录配置教程

飞连支持企业将第三方平台的组织架构信息导入飞连，并支持配置第三方登录飞连。本文主要介绍如何在飞连管理后台导入 Authing 组织架构，以及如何配置 Authing 第三方登录飞连。

企业已在 Authing 注册完成，并在 Authing 管理后台拥有完善的企业组织体系。

• 在飞连管理后台导入 Authing 组织架构。具体操作，请参见导入 Authing 组织架构。
• 在飞连管理后台授权 Authing 第三方登录。具体操作，请参见配置 Authing 第三方登录飞连。

步骤一：在 Authing 新建用户池并配置飞连应用

1. 使用企业管理员账号登录 Authing。
2. 新建用户池。
   
3. 获取飞连应用。
   1. 进入用户池的应用市场。
      
   2. 搜索并选择飞连，在飞连应用详情页单击获取应用。
      
   3. 在配置飞连中，填写应用名称，并单击下一步。
      
4. 配置飞连应用。
   填写飞连访问地址，并单击完成。此处可以获取到用户池 ID、用户池 Secret、用户池地址、APP ID、APP SECRET。
   
5. 设置应用访问授权。
   1. 选择允许所有用户访问作为默认权限。
      
   2. 单击添加，设置不可访问飞连应用的人员或组织。
      应用授权范围按照企业实际需求设置。
      

步骤二：在飞连管理后台进行数据同步

1. 登录飞连管理后台。

2. 在左侧导航栏，选择账号配置。

3. 在账号配置页面的数据源同步页签，单击添加数据源。
   

4. 在选择数据源对话框，单击 Authing，并单击创建。

5. 在导入配置页面的数据源区域，将已保存的 Authing 登录配置在用户池 ID、用户池 Secret 和用户池地址字段，并单击下一步。
   填写字段值后，单击第三方权限探测区域的开始检测，以帮助您有效检查是否已配置好第三方平台的权限，避免配置完成在导入时无法正常使用。

6. 在数据对象区域，完成以下配置，并单击下一步。

   1. 在选择部门与成员区域，选择同步对象。
      被选择的同步对象会被导入飞连管理后台。
   2. 在同步字段映射区域，设置第三方与飞连的字段映射关系。
      同步字段映射用于企业将第三方的成员信息中的字段映射到飞连内，其中，手机号和邮箱用于匹配用户唯一账号关系，暂不支持删除有关手机号或邮箱的字段映射关系。
      在同步字段映射区域，单击编辑，可手动调整字段映射关系，左侧第三方字段是指第三方平台内设置的用户字段。右侧飞连字段是指第三方平台映射到飞连的用户字段。字段配置说明如下：
      • 在飞连字段列，第三方 ID（用户 ID）、手机号（手机号码）、邮箱（员工邮箱）字段不允许修改与删除，用于匹配用户唯一账号关系。
      • 如果飞连默认提供的字段不能满足映射需求，可单击添加映射，手动添加字段映射关系。
        
        添加映射时，除了选择飞连提供的默认字段，还支持手动添加扩展字段。
        • 第三方字段中添加扩展字段方式如下图所示。
          
        • 飞连字段中添加扩展字段方式如下图所示，扩展字段填写说明如下：
          
          • 字段 Key：定义字段唯一值。
          • 字段名称：字段的显示名称。
          • 字段描述：字段的说明。
          • 字段类型：可选字符串、数字、布尔值、表达式、枚举值。
          • 高级配置：可选必填、唯一、编辑。
            在第三方字段和飞连字段列名右侧，单击设置图标，可以统一管理扩展字段（包括添加、编辑、删除操作）。
            

7. 在导入模式区域，选择导入模式，并单击完成配置。
   当 Authing 内组织架构数据发生变更时，飞连为您提供了以下同步数据的方式可选，包括手动导入、自动导入。

   说明

   实时同步的方式仅支持飞书、钉钉、企业微信。

   同步方式	说明	策略
   手动导入	在配置好数据源后，由人工主动触发数据同步操作。适用于企业管理员配置完成后，当下不想立即执行同步任务，待调试准备完成后，再进行手动同步的工作。	手动全量同步
   自动导入	指定时间同步第三方数据源。适用于企业需要在固定时间完成数据同步的场景。	定时全量同步

   • 手动导入：选择手动导入，后续在数据接入列表中，手动开始导入组织架构数据。
   • 自动导入：选择自动导入，并选择导入模式，支持设置每隔多少分钟或小时，或者设置每天固定时间点导入组织架构。

8. 在数据源同步页签的列表中，找到已添加的数据源配置，打开生效开关。
   打开生效开关后，该数据同步配置才正式生效，后续按照设置的同步方式进行数据同步。

   说明

   如果同步方式设置的手动导入，则打开生效开关后，可根据实际需要手动单击开始同步。

   此外，单击 Authing 数据同步，支持查看以下信息：

   • 同步配置页签：查看基础信息、同步机制、同步范围信息。

   • 同步任务页签：查看历史同步记录。您可以通过以下三个筛选条件，筛选出目标同步任务。
     在同步数据详细信息的操作列，单击详情，可查看该信息上游同步至飞连数据源的信息对比。对比同步前后的信息内容，可帮助您进行日志审计或排查用户数据问题。

     筛选条件	说明
     变更动作	可选全部、创建、更新以及删除： 全部：包含所有变更动作的同步任务。 创建：代表创建了新的同步任务。 更新：代表更新了已有同步任务。 删除：代表上游数据源删除数据时，并同步飞连。
     同步状态	可选全部、成功、失败以及忽略： 全部：包含所有同步状态的同步任务。 成功：代表同步成功的同步任务。 失败：代表同步失败的同步任务。 忽略：代表由于各种原因不入库的情况，例如全量同步任务发现已有实时任务将新数据入库时，飞连选择忽略这些数据，不将其入库。
     搜索部门/员工	通过同步数据包含的部门或员工名称筛选。

1. 登录飞连管理后台。

2. 在左侧导航栏，选择账号配置。

3. 在认证源管理页签下，单击 +添加认证源。

4. 在选择认证源对话框中，单击Authing卡片。

5. 参考界面提示配置参数，关键参数说明如下，完成配置后，单击确定。

   模块	配置项	必填	说明
   基本信息	登录显示图标	是	登录界面按钮上显示的身份源图标，单击重新上传可上传自定义显示图标。
   	登录简称（中文）	是	显示在登录界面的按钮下方的名称，例如Authing快捷登录，点击输入框下方的示例了解展示效果。
   	登录简称（英文）	是	显示在登录界面的按钮下方的名称。
   	唯一标志	不涉及	登录源唯一标识，用于区分不同登录认证的租户，由小写字母、数字以及 - 组成，长度小于 32 位字符。由飞连默认提供，不可修改。
   	描述	否	认证源描述，非客户端展示字段，仅用于管理后台备注说明，长度小于40位字符。
   	登录认证位置	是	飞连登录位置，可多选手机端软件、桌面端软件或门户网站。
   认证信息	App ID	是	填写已保存的Authing应用凭证 App ID。您可以进入Authing 用户池的应用>单点登录 SSO>基本信息>登录配置页面获取 APP ID。
   	APP SECRET	是	填写已保存的Authing应用凭证 App Secret。您可以进入Authing 用户池的应用>单点登录 SSO>基本信息>登录配置页面获取 APP SECRET。
   	用户池地址	是	填写 Authing 用户池地址。您可以进入Authing 用户池的应用>单点登录 SSO>基本信息>登录配置页面获取 用户池地址。
   高级配置	属性映射策略	是	将第三方登录认证源的用户信息直接映射为飞连的用户信息，即在登录过程中建立第三方与飞连用户之间的对应关系： 调整字段映射关系：左侧Authing字段是指Authing内设置的用户字段。右侧飞连字段是指需要配置映射到飞连的用户字段。 开启登录自动更新：如果在对应映射字段后勾选了开启，表示在进行登录时，如果匹配到系统中存在的用户，会用本次登录时的用户属性对系统中的用户属性进行更新。 删除：删除当前映射策略。 添加：如果飞连默认提供的字段不能满足映射需求，可单击添加，手动添加字段映射关系。 添加扩展字段：如果当前字段不能满足映射策略，可单击添加扩展字段，填写说明如下： 字段 Key：定义字段的唯一值。 字段名称：设置字段的显示名称。 字段描述：填写字段的说明。
   	唯一标识优先级	是	通过拖拽设置匹配标识的优先级，飞连将按照优先级顺序匹配上游唯一标识。如果当前标识不能满足需求，可单击添加，手动添加标识。
   	登录未匹配到员工时，选择处置方式	否	企业成员登录飞连时，未在飞连组织架构匹配到用户时，将提供自动创建账号服务，可选： 自动创建员工账号：开启后，登录未匹配到员工时，将自动创建员工账号，将员工关联至指定部门。 员工登录失败，将不会创建账号：开启后，登录未匹配到员工时，将不创建账号。

配置效果

以在 macOS 中登录飞连客户端为例，打开飞连客户端，用户会在更多登录方式区域看到 Authing 图标。