# 平台管理、权限架构与认证配置

本指南梳理 MatrixOne Intelligence（MOI）的账号、工作区、数据库实例与平台级管理员权限边界，并说明统一认证（SSO）、注册邀请准入以及当前已开放的平台管理员治理能力。

## 四层权限与身份体系

MOI 将日常业务授权与平台级运维治理分属四个独立层级，配置和排查时需按所属层级进入对应入口：

| 管理层级 | 作用域 | 管理对象与权限能力 | 操作入口与文档 |
| --- | --- | --- | --- |
| **1. 统一账号与安全（账号级）** | 全平台（跨产品通用） | 个人资料、密码/邮箱/手机号/第三方登录绑定、实名认证、个人访问令牌（PAT）与服务账号凭据 | 顶栏右上角头像菜单 → [账号管理](billing/account.md)、[完成实名认证](billing/real-name.md)、[访问凭据](billing/credentials.md) |
| **2. AI Studio 工作区权限（工作区级）** | 单个工作区内部 | 邀请已有 MOI 账号加入工作区、创建/复制自定义角色、配置全局与对象级权限、成员标签与成员操作日志 | AI Studio 左侧栏 → [用户权限](ai-studio/permissions/index.md)、[成员管理](ai-studio/resource-center/members.md) |
| **3. MatrixOne 实例权限（数据库租户级）** | 单个数据库实例租户 | 实例内用户、`ACCOUNTADMIN` / `MOADMIN` 等角色继承、SQL `GRANT` / `REVOKE`、IP 白名单、TLS 与私网访问 | MatrixOne 管理台 → [MatrixOne 权限](matrixone/permissions.md)、[权限分类](../reference/sql/privileges.md) |
| **4. 平台管理员治理（跨工作区 / 平台级）** | 全平台与跨工作区资源 | 跨工作区计算资源运维、托管沙箱与工作区配额覆写、全局模型/服务槽位绑定、反馈工单与激励审批 | [平台管理 API 参考](../reference/api/administration/index.md) |

> **关键边界**：工作区内的管理员/角色**不等于**平台超级管理员，也不自动具备 MatrixOne 数据库实例内的 `ACCOUNTADMIN` 权限；账号级“注册邀请上限（默认 10 人）”也独立于“向工作区添加已有账号成员”。

## 平台管理员治理能力与接口边界

在当前产品形态中，MOI Web 前端提供工作区控制台与统一账号中心，**暂未提供独立的平台管理员 Web 管理后台界面**。跨工作区的平台管理员操作通过**平台管理 API** 执行，调用时需使用具备平台配置管理员身份的账号或对应管理凭据，切勿将工作区普通角色当成平台管理身份。

已开放的四大平台治理域如下：

| 治理域 | 管理员可执行的关键操作 | API 参考入口 |
| --- | --- | --- |
| **计算资源治理** | 跨工作区检索计算实例（按工作区/状态/关键词筛选）、查看底层 Worker 类型与副本状态、更新配置与自定义 Python `requirements.txt` 依赖校验、暂停/恢复/重试异常实例、删除前依赖预检与强制异步清理 | [平台管理 · 计算资源](../reference/api/administration/ai-studio/compute-resources/index.md) |
| **托管沙箱与配额治理** | 跨工作区列出/查询/同步删除指定托管沙箱、整组替换允许联网工具与 `域名:端口` 外网允许列表、按工作区调整托管/临时沙箱数量上限与自动临时沙箱策略 | [平台管理 · 沙箱](../reference/api/administration/ai-studio/sandboxes/index.md) |
| **服务槽位与模型绑定** | 读取可用候选模型列表、配置或清除平台级模型服务槽位及恢复环境绑定、查阅槽位变更审计日志 | [平台管理 · 服务槽位](../reference/api/administration/ai-studio/service-slots/index.md) |
| **反馈工单与激励审批** | 跨账号列表检索与阅读用户反馈工单、更新处理状态与管理员回复、记录非货币奖励审批事实、按工单事实生成草稿并队列创建 GitHub Issue | [平台管理 · 反馈工单](../reference/api/administration/genesis/feedback-tickets/index.md) |

## 统一认证、SSO 与账号准入

### 1. 登录模式与统一认证协议

- **统一账号 SSO 登录（默认）**：标准部署模式下，用户在 MOI 控制台触发登录后跳转至统一账号中心完成身份认证与会话签发；后台依托 OAuth2 / OIDC 协议与统一身份目录同步会话。
- **内置登录模式**：部分内嵌或定制私有化部署可通过部署环境变量切换为产品内置登录入口，账号管理仍由统一账号体系承接。
- **第三方身份源关联**：取决于当前部署所启用的提供方配置，用户可在[账号管理](billing/account.md)查看并关联/取消关联 GitHub、Google 或企业微信身份（仅展示当前环境已配置的提供方）。

### 2. 注册邀请配额与候补准入（Waitlist）

- **邀请限额与候补开关**：统一账号服务控制新用户注册邀请配额（普通注册用户默认每人邀请上限为 `10` 位）及全局公测开放开关；当部署开启超限候补策略时，超出配额的注册请求将先进入候补名单等待准入批准。
- **账号级邀请 vs 工作区邀请**：账号邀请上限仅约束“邀请未注册的新账号”，**不限制**团队管理员在[用户管理](ai-studio/permissions/users.md)中将已有 MOI 账号加入同一工作区。

### 3. 企业 SSO（SAML / Okta / LDAP）配置边界

在**计费中心 → 设置**界面中展示的“企业身份认证（SSO / SAML）”或订阅开关，当前在自助计费界面中处于未接通/禁用状态，**不能通过计费设置开关自行开通或配置 SAML/Okta/LDAP**。

若私有化部署或企业客户需要对接自有 OIDC、SAML 或目录服务，请由部署运维人员在统一身份认证层（IdP 联邦配置）统一接入，或联系[技术支持](../get-started/support.md)协助配置。

### 4. 安全与凭据分离要求

- **密码与高敏操作确认**：修改登录密码要求账号已完成邮箱验证；平台管理员敏感变更受操作鉴权与二次确认保护。
- **编程与自动化凭据隔离**：调用 AI Studio 工作区接口须在请求头使用 `X-API-Key`（配合 `X-Workspace-ID`）；调用 Genesis 模型接口须在 `Authorization: Bearer` 中传入个人访问令牌（`sk-uca-v1`）、服务账号 API Key（`sk-sa-v1`）或已启用的本地密钥（`sk-mo`）。严禁在同一请求中同时携带 API Key 与浏览器会话 Cookie（触发 `ErrMultipleAuthCredentials`）。详见[访问凭据](billing/credentials.md)与[调用前准备](../developer/api/api-call-basics.md)。

## 相关排查与参考

- 权限拒绝（`403 ErrForbidden`）、凭据冲突或登录态失效排查：[错误码参考](../reference/error-codes.md)与[常见问题与故障排查](../get-started/troubleshooting.md)。
- 日常工作区成员维护步骤：[用户管理](ai-studio/permissions/users.md)与[角色权限](ai-studio/permissions/roles.md)。
