本文介绍如何在腾讯乐享知识库中配置钉钉连接器，包括连接器配置入口、钉钉自建应用（OAuth 2.0 模式）的创建、接口权限申请、安全设置及发布上线等步骤。
使用入口
1. 登录 企业管理后台，在左侧菜单栏中选择腾讯乐享知识库。
2. 进入知识管理 > 连接器菜单。
3. 单击钉钉连接器，在弹出的表单中按以下说明填写：
字段 | 说明 | 是否必填 |
Client ID（原 AppKey 和 SuiteKey） | “创建钉钉企业内部应用”章节中获取的 ding_xxx 格式标识 | 必填 |
Client Secret（原 AppSecret 和 SuiteSecret） | “创建钉钉企业内部应用”章节中获取的 64 位密钥 | 必填 |
安全说明：
App Secret 在乐享侧加密存储（如 KMS），后台界面仅显示掩码（如****abc8）。
凭证仅在“用 code 换取 token”与“刷新企业 token”两个环节由后端解密使用，不会出现在日志、前端或 API 响应中。
如需更换 Client Secret，请先在钉钉后台“凭证与基础信息”页面重置，再回到乐享编辑该连接器并更新 Secret。
钉钉自建应用配置指南（OAuth 2.0 模式）
开始之前
完成钉钉自建应用的配置后，乐享即可通过 OAuth 2.0 在用户授权后访问其钉钉云文档。
前置要求：
您需为钉钉主管理员或子管理员，或可协调具备应用审批权限的管理员配合审批。
整体流程：
创建应用 > 记录 Client ID/Client Secret > 申请接口权限（通讯录、文档、知识库、企业存储下载）> 配置安全设置（OAuth 重定向）> 发布上线并由管理员审批通过 > 在乐享后台“连接器”中填入 Client ID/Client Secret > 完成配置
创建钉钉企业内部应用
进入开放平台
创建应用
1. 左侧菜单选择应用开发 > 企业内部开发 > 企业内部应用 > 创建应用。
2. 填写以下信息：
应用名称：乐享导入助手（建议包含“乐享”前缀，便于审批识别）。
应用描述：将钉钉知识库/在线文档内容批量导入到腾讯乐享知识库。
应用图标：上传乐享 logo（可选，默认 256x256）。
开发类型：企业内部应用（不要选“企业上架”、也不要选“ISV 应用”）。
3. 单击确认创建，创建后的“凭证与基础信息”页面可看到：
Client ID（形如 dingxxxxxxxxxxxxx）Client Secret（64 位随机字符串）
先记下这两个值，填入到乐享钉钉连接器配置中
申请接口权限
进入权限管理
在应用详情页左侧菜单中选择“权限管理”。
需要申请的权限点
请按照以下名单逐个勾选钉钉权限点：
分组 | 权限名 | 权限点 |
通讯录 | 个人信息读取 | Contact.User.Read |
企业存储 | 企业存储文件下载信息读权限 | Storage.DownloadInfo.Read |
企业存储 | 企业存储文件访问权限 | Storage.File.Read |
文档 | 文档读权限 | Document.Workbook.ReadDocument.WorkspaceDocument.Read |
知识库 | 知识库读权限（wiki 2.0） | Wiki.Workspace.ReadWiki.Node.ReadWiki.Workspace.Search |
提交审核
勾选后单击保存，需主管理员在“钉钉管理后台 > 应用中心 > 待审批”中审批通过。审批通过后，权限状态变为“已启用”。
配置安全设置
OAuth 重定向 URL
在“开发配置” > “安全设置” > “重定向 URL”中，填入乐享导入服务的回调地址：
https://lexiangla.com/c/app-auth-callback注意：
回调地址必须与上述地址完全一致，包括协议（http/https）、端口、路径和大小写，不能包含多余的斜杠，否则将被钉钉拒绝。
网页应用
在应用详情页左侧菜单中选择“应用能力” > “网页应用”。
填写以下信息：
PC 端首页地址：
https://lexiang.tencent.com/移动端首页地址：
https://lexiang.tencent.com/说明：
完成本步骤后，钉钉才会将该应用识别为“网页应用”，从而允许 OAuth 跳转。
发布上线
此步骤最易遗漏：未发布应用将导致以下任一问题。
接口调用返回 403 Forbidden。
OAuth 授权页提示“应用未上线”。
在应用详情页左侧菜单中选择“版本管理与发布” > 创建版本，并填写以下信息：
版本号：如 1.0.0，按序递增即可。
更新说明：首次发布，支持以 OAuth 授权方式访问云文档与知识库。
可用范围：选择允许使用此应用的钉钉用户或部门（一般选择“全员可用”）。
单击保存并申请发布。
该操作同样需要管理员审批，审批通过后版本状态变为“已发布”。
发布后返回“权限管理”页面，确认所有权限状态均为“已启用”（而非“审批中”）。
