钉钉插件
钉钉插件用于把钉钉账号、组织协作和知识库文档能力接入到 superun 产品中。它适合需要统一企业登录、成员校验和团队文档协作的业务。可以接入哪些能力
| 能力 | 适合场景 | 说明 |
|---|---|---|
| 钉钉登录 | 企业内部系统、员工门户 | 用户使用钉钉账号进入产品 |
| 企业成员校验 | 企业白名单、内部访问控制 | 控制哪些钉钉组织成员可以使用产品 |
| 钉钉文档写入 | 周报、会议纪要、知识库归档 | 在钉钉知识库中创建、写入或更新文档 |
接入前需要准备
- 钉钉开放平台的管理员权限。
- 一个钉钉企业内部应用，并取得 Client ID 和 Client Secret。
- 已发布的 superun 项目域名，用于配置登录回调地址。
- 根据要接入的能力，在钉钉开放平台开通对应权限并发布应用。
建议开通的能力范围
在 钉钉开放平台 创建企业内部应用后，建议按实际接入目标分层开通，不需要一次性打开所有权限。| 接入目标 | 建议开通范围 | 需要关注的权限 / 配置 | 说明 |
|---|---|---|---|
| 钉钉登录 | 企业内部应用、登录与分享、登录回调域名 | Contact.User.Read；按需 Contact.User.mobile | 用于读取登录用户基础信息。需要手机号时再额外申请手机号权限 |
| 企业成员校验 | 登录能力 + 企业成员信息读取 | Contact.User.Read；企业信息读权限按需开通 | 用于判断用户是否属于目标钉钉组织、部门或可访问范围 |
| 钉钉文档写入 | 知识库和文档相关能力 | Wiki.Workspace.Read、Document.WorkspaceDocument.Write，按需 Wiki.Workspace.Write | 用于选择知识库、创建知识库文档和写入内容，详见 钉钉文档写入 |
应用可见范围建议
- 调试阶段：建议先把应用可见范围设置为开发团队或测试部门，避免影响全员。
- 上线阶段：设置为实际会使用该产品的部门、成员或全部员工。
- 如果接入文档写入：应用可见范围需要覆盖执行授权的钉钉用户，目标知识库也要给该用户相应的查看或编辑权限。
钉钉权限申请后通常还需要管理员审批，并在开放平台发布应用后才会生效。仅保存权限配置但未发布，可能导致 superun 侧仍然提示权限不足。
如何在 superun 中启用
创建钉钉企业内部应用
打开 钉钉开放平台，进入「企业内部开发」，创建应用并完成基础信息配置。
子能力说明
钉钉文档写入
接入知识库文档创建、内容写入、文档更新和协作归档。