Skip to Content
市场插件权限

插件权限模型

插件权限模型的核心规则是:插件只能声明 requested permissions 和 secret requirements,不能给自己授权。

管理权限

插件管理建议使用这些权限键:

plugin.view plugin.install plugin.manage plugin.configure_secrets plugin.publish

plugin.view 允许查看市场和已安装插件。安装、启用、停用、升级、移除和 secret 配置应分别受更高权限控制。

声明不等于授权

manifest 中的权限声明只表达插件希望访问的能力。例如:

permissions: required: - ai.gateway.view - ai.gateway.invoke domain: - workspace.resource.view secrets: required: - name: provider_api_key description: External provider API key

实际可用能力必须由以下控制共同计算:

  • 当前用户或 service account 的 RBAC 权限。
  • tool grants。
  • access policies。
  • skill bindings。
  • Gateway approval guardrails。
  • resource scopes。
  • secret references。
  • audit 和 redaction 策略。

高风险能力

Web 安装界面提供安装前确认,展示插件声明的权限、密钥需求和风险。当前 soha plugin install CLI 会直接提交安装请求,没有交互式管理员确认步骤;使用 CLI 前应先通过 soha plugin show <id> 和 manifest 人工核对这些声明,不应依赖命令额外提示确认。

安装仍受服务端权限校验并记录安装审计;安装审计不等同于独立的人工审批或 CLI 确认记录。声明 mutate、execute、高权限 connector、外部 provider key 或高成本模型调用能力的插件,需要在安装前完成相应人工审查,实际调用继续受运行时授权与策略约束。

插件不能绕过 Soha Gateway 直接访问受保护资源。所有调用必须终止在 Soha Gateway、受控 connector API、MCP server 或已声明的外部进程边界。

Last updated on