【应用授权管理】模块介绍
应用授权管理模块 · 操作文档
适用产品：安捷智用 AI 应用平台
模块路径：系统管理 → 发布与集成 → 应用授权管理
访问地址：https://aw.tizdata.com/settings/app-auth
文档版本：V1.0
1. 模块介绍
1.1 模块定位
「应用授权管理」是安捷智用 AI 应用平台对接外部业务系统与第三方应用的统一凭证管理中心，承担"把平台与外部应用打通认证"的职责。
平台在落地过程中，往往需要与企业既有的即时通讯（企业微信、钉钉、飞书）、邮件、ERP / 财务系统（金蝶、用友）、低代码表单（钉钉宜搭）等第三方系统进行集成——例如向工作群推送消息、调用 ERP 接口取数、发送邮件通知等。这些调用都需要先完成应用授权（凭证登记），平台拿到对应应用的 AppKey、Secret、AgentID 等身份凭证后，才能代表该应用安全地访问外部接口。
💡 一句话理解：应用授权是平台走向外部系统的"通行证"。凭证配好之后，平台才能往群里推消息、向 ERP 取数据、给客户发邮件。
1.2 模块能做什么
| 能力 | 说明 |
|---|---|
| 多类应用接入 | 支持 9 类主流第三方应用授权，覆盖 IM 推送、邮件、ERP / 财务、低代码表单等场景 |
| 统一凭证登记 | 所有授权集中登记，按"授权列表"统一查看、筛选、编辑 |
| 连接可用性校验 | 每条授权提供独立的「连接测试」能力，一键验证凭证是否有效、外部系统是否可达 |
| 任务关联可视 | 通过「关联任务数量」字段，可直观看到每条授权被多少个下游任务（推送 / 取数）引用 |
| 场景化取值指引 | 每类应用的每个凭证字段均带「取值路径提示」，告诉您该值在第三方后台的哪个菜单获取 |
1.3 进入路径
- 使用账号登录平台；
- 在「请选择你进入的企业」中选择目标组织（如「【企业门户】体验组织」）；
- 在左侧主导航点击 「系统管理」；
- 展开二级菜单 「发布与集成」，点击 「应用授权管理」。
📷 配图建议 1：系统管理菜单展开图，标注「发布与集成 → 应用授权管理」的层级位置。
2. 模块列表功能
进入「应用授权管理」后，页面由 左侧授权列表树 与 右侧列表区 两部分组成。
2.1 页面整体结构
| 区域 | 说明 |
|---|---|
| 左侧 · 应用授权列表树 | 顶部有「应用授权列表」标题与「新建授权」按钮，并提供「搜索」框；下方「所有授权列表」分组按应用名称列出全部已建授权，点击任一应用可快速定位 |
| 右侧 · 筛选区 | 顶部显示当前分组名称（如「所有授权列表」），并提供「应用名称」筛选输入框，可按名称快速过滤 |
| 右侧 · 数据表格 | 以表格形式展示所有授权的核心信息与操作入口 |
📷 配图建议 2：应用授权管理列表页全景截图，用框线分别标注：①左侧授权列表树（含新建授权、搜索）②筛选区 ③数据表格。
2.2 数据表格字段说明
列表表格包含以下列：
| 列名 | 说明 | 示例 |
|---|---|---|
| 应用名称 | 该授权的显示名称，用于在平台其他模块（任务、推送配置等）中识别和引用 | 企微推送整理、amber的钉钉企业 |
| 授权类型 | 该授权对应的应用类型 | 企微自建应用、钉钉自建应用、金蝶云星空 |
| 关联任务数量 | 该授权当前被多少个下游任务（消息推送、数据取数等）引用；为 0 表示尚未被使用 | 2、6、0 |
| 更新时间 | 最近一次修改该授权的时间 | 2026-04-24 16:07:42 |
| 操作 | 行级操作按钮：编辑、连接测试 | — |
📷 配图建议 3：列表表格单行特写，标注各列含义（可参考示例数据：企微推送整理 / 企微自建应用 / 2）。
2.3 筛选与检索
- 左侧搜索：在授权列表树顶部的「搜索」框中输入关键词，可在授权列表中模糊匹配对应应用。
- 按应用名称筛选：在右侧筛选区的「应用名称」输入框中输入名称，表格实时过滤匹配的授权。
- 左侧树快速定位：点击授权列表树中的具体应用节点，右侧表格快速定位到该条授权。
3. 列表的各个按钮功能
3.1 页面级按钮
| 按钮 | 位置 | 功能 |
|---|---|---|
| 新建授权 | 左侧授权列表树顶部 | 点击后弹出应用类型下拉菜单，选择其中一种类型（共 9 种），打开对应的「创建……」对话框（详见第 4 节） |
| 搜索 | 左侧授权列表树顶部 | 按关键词在授权列表中检索应用 |
3.2 行级操作按钮（操作列）
每条授权记录的「操作」列提供以下按钮：
| 按钮 | 功能 |
|---|---|
| 编辑 | 打开该授权的编辑对话框（标题为"编辑 + 应用类型"，如"编辑钉钉自建应用"），表单与新建时一致且已预填原值；可修改凭证参数，保存后更新「更新时间」 |
| 连接测试 | 依据当前已保存的凭证，即时向对应第三方系统发起一次连通性 / 鉴权校验，验证授权是否可用；建议在创建或修改凭证后先测试再投入使用 |
⚠️ 提示：若某授权已被下游任务（推送、取数等）引用，修改凭证时请确保新凭证具备相同权限，以免影响正在运行的业务场景。
3.3 新建 / 编辑对话框内的按钮
在「创建 / 编辑……应用」对话框底部，提供两个操作按钮：
| 按钮 | 功能 |
|---|---|
| 取 消 | 放弃当前填写内容，关闭对话框 |
| 确 定 | 校验必填项通过后，保存授权并关闭对话框 |
📌 说明：本模块的「连接测试」位于列表行级按钮（非对话框内），保存后可在列表中随时对某条授权发起测试。
4. 相关文档：创建各类应用授权
4.1 支持的应用授权类型总览
平台「新建授权」支持以下 9 种 应用授权类型：
| 分类 | 类型 | 典型用途 |
|---|---|---|
| 即时通讯 / 消息推送 | 企微自建应用、钉钉自建应用、飞书自建应用 | 向企业微信 / 钉钉 / 飞书群或个人推送消息、卡片、通知 |
| 邮件 | 邮件账户 | 通过 SMTP 发送邮件通知、报表邮件 |
| ERP / 财务系统 | 金蝶云星空、金蝶云星辰、用友U8C、用友YonSuite | 调用 ERP 接口取数、写入单据、同步主数据 |
| 低代码 / 表单 | 钉钉宜搭 | 读写宜搭表单数据、流程表单 |
4.2 通用操作步骤
无论创建哪种类型的应用授权，整体流程一致：
- 点击 「新建授权」，弹出应用类型下拉菜单；
- 在菜单中选择目标应用类型，打开对应的创建对话框；
- 填写 「应用名称」（必填，自定义，建议含业务含义，如"企微推送整理"）；
- 按该类型要求填写凭证参数（带
*为必填），每项右侧均有「取值路径提示」说明该值在第三方后台的获取位置； - 点击 「确定」 保存；
- （建议）返回列表，点击该行 「连接测试」，验证授权是否生效。
📷 配图建议 4：新建授权下拉菜单截图，标注 9 种应用类型选项；以及某类型（如企微自建应用）创建对话框全景截图。
4.3 各类型字段对照总表
下表汇总各类型在创建对话框中的字段差异（✅ 必填 · ◻ 选填）。所有类型均含「应用名称（必填）」这一基础字段；凭证类参数随类型而异。
| 应用类型 | 核心凭证字段（除应用名称外） | 选填 / 高级项 |
|---|---|---|
| 企微自建应用 | 企业ID✅、AgentID、Secret✅ | 高级设置：企业微信接口地址 |
| 钉钉自建应用 | AgentID、AppKey✅、Secret✅ | — |
| 飞书自建应用 | AppID✅、AppKey✅ | — |
| 邮件账户 | SMTP地址、SMTP端口、发件人地址、密码✅、SSL加密 | — |
| 金蝶云星空 | 账套ID✅、用户名✅、应用ID✅、应用密钥✅ | 私有云地址、组织编号 |
| 金蝶云星辰 | 应用ID✅、应用密钥✅、第三方实例ID✅ | 账套ID |
| 钉钉宜搭 | AppKey✅、AppSecret✅、应用编码✅、应用密钥✅ | — |
| 用友U8C | 服务器登录地址✅、用户名✅、密码✅、系统编码✅ | — |
| 用友YonSuite | appKey✅、appSecret✅、tenantId✅ | — |
4.4 即时通讯 / 消息推送类授权创建
4.4.1 创建 企微自建应用 授权
用于对接企业微信自建应用，支持向企微群、成员推送消息与通知。
填写字段：
| 字段 | 是否必填 | 取值路径提示 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"企微推送整理" |
| 企业ID | ✅ | 企业微信后台 → 我的企业 → 企业ID |
| AgentID | ◻ | 企业微信后台 → 应用管理 → AgentId |
| Secret | ✅ | 企业微信后台 → 应用管理 → Secret |
高级设置（可展开）：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 企业微信接口地址 | ◻ | 私有化部署时填写自定义企微接口地址，公有云可留空 |
📷 配图建议 5：企微自建应用创建对话框截图（含展开的高级设置）。
4.4.2 创建 钉钉自建应用 授权
用于对接钉钉企业内部应用（H5 微应用），支持向钉钉群、成员推送消息与通知。
填写字段：
| 字段 | 是否必填 | 取值路径提示 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"钉钉推送助理" |
| AgentID | ◻ | 钉钉开放平台 → 应用开发 → H5微应用 → 应用凭证 → 原企业内部应用 AgentId |
| AppKey | ✅ | 钉钉开放平台 → 应用开发 → H5微应用 → 应用凭证 → AppKey |
| Secret | ✅ | 钉钉开放平台 → 应用开发 → H5微应用 → 应用凭证 → AppSecret |
4.4.3 创建 飞书自建应用 授权
用于对接飞书（Lark）企业自建应用，支持向飞书群、成员推送消息与通知。
填写字段：
| 字段 | 是否必填 | 取值路径提示 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"飞书推送助理" |
| AppID | ✅ | 飞书开放平台 → 凭证与基础信息 → App ID |
| AppKey | ✅ | 飞书开放平台 → 凭证与基础信息 → App Secret |
4.5 邮件类授权创建
4.5.1 创建 邮件账户 授权
用于通过 SMTP 协议发送邮件（通知、报表邮件等）。
填写字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"财务邮件账户" |
| SMTP地址 | ◻ | 邮件服务器 SMTP 地址，如 smtp.qq.com、smtp.exmail.qq.com |
| SMTP端口 | ◻ | SMTP 端口，常见 25、465、587 |
| SSL加密 | ◻ | 单选「开启 / 关闭」；使用 465 端口时通常需开启 SSL |
| 发件人地址 | ◻ | 发件邮箱地址，如 noreply@company.com |
| 密码 | ✅ | 发件邮箱的登录密码或授权码（部分邮箱需使用授权码） |
📌 提示：QQ 邮箱、网易邮箱等通常需在邮箱后台开启 SMTP 服务并生成「授权码」，此处密码填授权码而非登录密码。
4.6 ERP / 财务系统类授权创建
4.6.1 创建 金蝶云星空 授权
用于对接金蝶云星空（K3Cloud）ERP，调用其开放接口完成取数、写单等操作。支持公有云与私有云两种部署模式。
填写字段：
| 字段 | 是否必填 | 取值路径提示 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"金蝶云星空" |
| 账套ID | ✅ | 金蝶云星空 → 系统管理 → 授权 → 第三方系统登录授权 → 修改 → 生成测试链接；通过弹出的信息获取"数据库中心 ID"（即账套ID） |
| 用户名 | ✅ | 金蝶云星空 → 系统管理 → 授权 → 第三方系统登录授权 → 编辑 → 集成用户 |
| 应用ID | ✅ | 金蝶云星空 → 系统管理 → 授权 → 第三方系统登录授权 → 编辑 → 应用ID |
| 应用密钥 | ✅ | 金蝶云星空 → 系统管理 → 授权 → 第三方系统登录授权 → 编辑 → 应用密钥 |
| 私有云地址 | ◻ | 私有云需填写自己的 K3Cloud 地址；公有云留空 |
| 组织编号 | ◻ | 多组织用户填写；启用多组织时配置对应的组织编码才有效 |
📷 配图建议 6：金蝶云星空创建对话框截图，标注账套ID、应用ID、应用密钥等关键字段及其在金蝶后台的取值位置。
4.6.2 创建 金蝶云星辰 授权
用于对接金蝶云·星辰（面向小微企业的金蝶云产品），调用其开放接口。
填写字段：
| 字段 | 是否必填 | 取值路径提示 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"金蝶云星辰" |
| 应用ID | ✅ | 金蝶小微企业生态用户 → 我的应用 → 点击对应应用 → 应用集成 → 应用ID（Client ID） |
| 应用密钥 | ✅ | 金蝶小微企业生态用户 → 我的应用 → 点击对应应用 → 应用集成 → 应用 Secret（Client Secret） |
| 第三方实例ID | ✅ | 金蝶开放平台 → 开发者后台 → 我的应用 → 应用详情 → 应用集成 → 授权 → 产品接口授权 → 第三方实例ID |
| 账套ID | ◻ | 当前应用绑定的账套ID |
4.6.3 创建 用友U8C 授权
用于对接用友 U8 Cloud（U8C）ERP，通过服务器登录方式接入。
填写字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"用友U8C" |
| 服务器登录地址 | ✅ | U8C 服务器登录地址（含协议与端口，按实际部署填写） |
| 用户名 | ✅ | U8C 登录用户名（具备接口调用权限） |
| 密码 | ✅ | U8C 登录密码 |
| 系统编码 | ✅ | U8C 系统编码（标识具体账套 / 系统） |
4.6.4 创建 用友YonSuite 授权
用于对接用友 YonSuite（云原生 ERP 套件），通过开放平台凭证接入。
填写字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"用友YonSuite" |
| appKey | ✅ | YonSuite 开放平台应用 AppKey |
| appSecret | ✅ | YonSuite 开放平台应用 AppSecret |
| tenantId | ✅ | YonSuite 租户 ID（标识企业租户） |
4.7 低代码 / 表单类授权创建
4.7.1 创建 钉钉宜搭 授权
用于对接钉钉宜搭（低代码表单平台），读写宜搭应用内的表单数据与流程。
填写字段：
| 字段 | 是否必填 | 取值路径提示 |
|---|---|---|
| 应用名称 | ✅ | 自定义，如"钉钉宜搭" |
| AppKey | ✅ | 钉钉开放平台 → 应用开发 → H5微应用 → 应用凭证 → AppKey |
| AppSecret | ✅ | 钉钉开放平台 → 应用开发 → H5微应用 → 应用凭证 → AppSecret |
| 应用编码 | ✅ | 宜搭 → 应用 → 应用设置 → 部署运维 → 应用编码 |
| 应用密钥 | ✅ | 宜搭 → 应用 → 应用设置 → 部署运维 → 应用密钥 |
📌 说明：钉钉宜搭授权同时需要"钉钉开放平台应用凭证"（AppKey / AppSecret）与"宜搭应用凭证"（应用编码 / 应用密钥）两套凭证，请勿混淆。
5. 常见问题
| 问题 | 解决建议 |
|---|---|
| 连接测试失败 | ① 核对凭证（AppKey / Secret / 企业ID 等）是否复制完整、无多余空格；② 确认凭证在第三方后台仍有效（未过期、未重置）；③ 确认平台服务器与第三方系统网络互通；④ IP 是否在第三方后台的白名单内 |
| 企微 / 钉钉 / 飞书推送不生效 | 先在授权列表对该条授权执行「连接测试」验证凭证；再检查下游推送任务是否正确引用了该授权、应用是否已配置可信域名与消息权限 |
| 金蝶云星空连接失败 | ① 账套ID 须通过"生成测试链接"获取的数据库中心 ID；② 公有云「私有云地址」必须留空；③ 多组织场景需填写「组织编号」 |
| 邮件发送失败 | ① 确认 SMTP 地址与端口匹配（465 通常需开启 SSL）；② 部分邮箱密码栏需填「授权码」而非登录密码；③ 确认发件邮箱已开启 SMTP 服务 |
| 修改凭证后下游任务异常 | 授权被多个任务引用时（查看"关联任务数量"），修改凭证后请逐一回归测试相关任务 |
附录：应用授权类型速查
| 应用类型 | 接入对象 | 核心凭证 | 典型场景 |
|---|---|---|---|
| 企微自建应用 | 企业微信 | 企业ID、AgentID、Secret | 群消息推送、应用通知 |
| 钉钉自建应用 | 钉钉 | AgentID、AppKey、Secret | 群消息推送、工作通知 |
| 飞书自建应用 | 飞书 / Lark | AppID、AppKey(App Secret) | 群消息推送、机器人通知 |
| 邮件账户 | 邮件服务器（SMTP） | SMTP地址、端口、发件人、密码 | 邮件通知、报表邮件 |
| 金蝶云星空 | 金蝶 K3Cloud | 账套ID、应用ID、应用密钥、用户名 | ERP 取数、单据写入 |
| 金蝶云星辰 | 金蝶云·星辰 | 应用ID、应用密钥、第三方实例ID | 财务 / 进销存接口取数 |
| 用友U8C | 用友 U8 Cloud | 服务器地址、用户名、密码、系统编码 | ERP 取数、单据写入 |
| 用友YonSuite | 用友 YonSuite | appKey、appSecret、tenantId | 云 ERP 接口取数 |
| 钉钉宜搭 | 钉钉宜搭 | AppKey、AppSecret、应用编码、应用密钥 | 表单数据读写、流程对接 |
本文档基于安捷智用 AI 应用平台【企业门户】体验组织实际界面整理，如平台版本升级导致界面变化，请以实际系统为准。