# 飞书登录集成

配置飞书企业自建应用，让预先导入的成员从飞书客户端登录 AskTable。

使用指南 · 模块: integrations · 管理人员 · 部署形态：Cloud / 私有部署 · 已确认产品版本：资料未说明 · 来源：编辑整理 · 变更章节按产品 4.2.48-1026 核对（CLI 命令另按 0.0.10）；不代表所有实例已升级，也不是完整历史支持矩阵。

飞书登录用于识别组织成员。它与[飞书机器人](https://docs.asktable.com/integrations/feishu)、[飞书工作簿](https://docs.asktable.com/data/connect)分别配置，不会互相启用。以下操作已按产品 `4.2.48-1026` 核对；旧实例请先确认版本。

## 准备应用

1. 在飞书开发者后台创建企业自建应用，启用网页应用能力，取得 **App ID** 和 **App Secret**。
2. 由 AskTable 组织 Owner 或 Admin 进入 **个人设置 → 登录集成 → 飞书**，点击 **启用**并填写凭据。
3. 在详情页的 **权限配置** 区点击 **复制权限 JSON**，到飞书权限管理的 **批量处理 → 批量导入/导出权限** 中导入。保存配置后，也可点击 **前往飞书权限管理**打开对应应用。
4. 设置需要导入的部门和成员为通讯录可见范围，发布应用版本，使权限生效。按用户组授权时，还需开通 `contact:group:readonly`。

登录身份使用应用内的 `open_id`，不需要申请手机号、邮箱或员工 `user_id` 权限。成员缺少姓名时，检查成员基本信息权限是否已发布生效。

App ID 保存后不能直接修改；更换应用前先断开集成。保存配置不会自动导入成员，也不表示外部凭据已验证成功。

## 配置登录地址

复制 AskTable 详情页的完整登录地址，填入飞书网页应用的桌面端和移动端主页，并配置 AskTable 域名为可信域名。选择在飞书客户端内打开。

- 私有部署地址形如 `https://你的域名/login/sso/feishu`，不带组织参数。
- Cloud 地址带 `?org_id=...`，必须完整保留。
- 部署有路径前缀时，以页面显示的完整地址为准。

当前只支持从飞书客户端工作台打开应用免登；普通浏览器入口会提示使用飞书客户端。

## 导入并验证成员

在 AskTable 飞书详情页点击 **导入成员**，选择应用可见范围内的人并提交，再用已导入成员从飞书工作台打开应用，确认进入正确组织。

首次登录不会自动创建账号。账号和组织成员关系都必须正常；已停用成员不能靠重新导入恢复。同一员工分别从飞书、企业微信或钉钉导入，会创建各自的 AskTable 账号并分别占用席位，不按相同手机号或邮箱合并。

当前不提供通讯录定时同步或离职自动停用。断开集成保留账号、成员和项目历史。完整规则见[企业集成登录](https://docs.asktable.com/organization/enterprise-login)。导入后仍需分配[项目角色](https://docs.asktable.com/organization/invitations)和[数据权限](https://docs.asktable.com/permissions)。

## 排障

| 现象          | 检查                                      |
| ----------- | --------------------------------------- |
| 读不到导入候选     | 应用凭据、通讯录权限、可见范围、应用发布状态                  |
| 无法免登        | 应用主页、可信域名、是否在飞书客户端中打开                   |
| 已识别身份但登录被拒绝 | 是否已经导入，账号和组织成员是否正常，Cloud 地址是否保留 org\_id |