安装插件
插件为工作空间补充经过审核的第三方能力,例如邮件、聊天、身份与数据工具。插件目录由 Soln 控制面提供;安装记录、配置值和运行中的插件容器都属于你的租户。
本文介绍各类插件通用的安装、配置、启停与卸载操作。具体功能按插件类型在左侧分类,使用时查看对应插件指南;组织映射、消息推送不是所有插件的通用功能。
目前 插件 → 企业身份插件 分类包含钉钉、飞书、企业微信,可先阅读使用指南,再查看列表与操作说明及各平台配置。其他类型的插件可以有不同的菜单、配置项和权限要求。
找到插件目录
- 打开 集成 → 应用
- 点击顶栏的拼图图标,页面标题会变成 插件,下方区域按一行两个展示所有已上架插件,每个显示图标、名称和简介
- 用搜索框按插件名称、简介或插件 ID 过滤列表;点击应用图标可以切回应用列表
安装插件
- 点击插件行右侧的
+。当前角色没有安装管理权限时,该按钮为禁用状态 - 在弹窗中确认信息:版本、发布时间与更新时间、提供方、该版本声明的权限(允许访问的外部域名、Runtime 权限范围)以及配置项
- 填写配置。标记为密钥的字段会加密保存在你的租户数据库中,不会发送给 Soln
- 勾选权限确认后点击 安装,安装与启用会在一步内完成
- 安装完成后,插件会以 插件 标签出现在应用列表里,点开卡片即可进入详情页
管理已安装插件
在 应用 里点开插件卡片即可进入详情页。
| 操作 | 位置 | 说明 |
|---|---|---|
| 编辑配置 | 详情页 → 编辑应用 | 密钥字段留空表示保留原值 |
| 停用 / 启用 | 详情页 | 停用会停止插件运行,但保留配置 |
| 卸载 | 详情页 → 卸载 | 会移除插件容器、插件创建的资源以及当前租户的安装记录 |
权限与版本
- 权限由插件版本自身声明,租户控制台不能扩大
- 安装新版本时,如果声明的权限有变化,需要重新确认权限
- 容器镜像按 digest 固定拉取,运行中的插件与已审核版本始终一致
- 访问插件目录需要 应用 页面的进入权限;安装与卸载还需要 管理应用安装(Manage App Installations) 权限
常见问题
| 现象 | 检查方向 |
|---|---|
| 插件 列表为空 | 运行时需要能访问控制面目录,且目录里至少有一个已上架版本 |
+ 按钮是禁用的 | 当前角色需要「应用」页面上的 管理应用安装 权限 |
| 安装失败 | 检查配置项是否正确,以及运行时的服务器能否访问该版本声明的外部域名 |
| 弹窗加载不到该版本 | 确认这个插件 ID 与版本仍处于已上架状态、未被撤回 |