在 Apifox 中,组织是可选的企业级管理空间,用于集中管理多个团队、成员和组织级权限。规模较大、需要跨团队统一管理时,推荐使用组织。创建组织#
你可以创建一个或多个组织。要创建新组织,可以按照以下步骤操作:1
在主窗口面板,点击左侧导航栏中的 “组织” 选项。
4
点击 “新建” 按钮。现在,你已经成功创建了一个新组织。
管理组织成员与角色#
组织角色#
组织所有者:拥有组织的最高管理权限,可以移交或解散组织。
组织管理员:除组织所有者专属操作外,可以管理组织成员、组织内的团队和组织设置。
组织成员:可以按需被分配到相应团队并参与项目协作,但不能修改组织设置,无法访问组织配置页。
邀请成员加入组织#
组织所有者和组织管理员可以从组织成员页面发起邀请,适合新员工入职或需要集中维护企业成员的场景。组织中至少需要已创建一个团队,才能邀请组织成员并为其配置团队角色。
2
点击
“邀请成员”,可以通过“邮箱”或“链接”进行邀请。
角色与默认权限映射#
组织角色与团队角色、项目角色分别控制不同层级的权限。组织管理员可以管理组织结构、成员、团队和付费事项,但不会因此自动获得各项目的 API 数据访问权限。需要访问某个项目时,仍须加入对应团队或项目。
成员加入团队后,系统会根据团队角色设置初始项目权限:| 成员在团队中的状态 | 初始项目权限 |
|---|
| 团队管理员 | 默认拥有该团队内所有项目的 “编辑者” 权限 |
| 团队成员 | 默认拥有该团队内项目的 “只读” 权限 |
| 未加入团队 | 无法访问该团队内的任何项目 |
| 某个项目的项目角色为 “禁止访问” | 无法访问该项目 |
以上是成员加入团队时的初始权限。团队管理员之后仍可按项目调整权限,或根据业务需要分配自定义项目角色。自定义项目角色#
自定义角色仅支持 项目层级,组织角色暂不支持自定义。
组织与团队的关系#
组织: 是最高级别的管理单元,代表一个公司或大团队,负责集中管理多个团队。组织拥有对多个团队的管理权限。
团队: 是组织中的子单元,通常对应一个部门或小团队,负责集中管理多个项目。团队拥有对多个项目的管理权限。
组织 vs. 团队 —— 该怎么选?#
在用 Apifox 的时候,很多人会纠结:到底是直接用组织来管,还是主要依靠团队?其实核心就看两个点——人数多少、业务范围有多大。比如你们就十来个人,做的也是同一个产品线,这种情况只用 团队 就够了。团队里可以管理项目、API 和成员,简单高效,不需要再加组织层。
如果你们公司人多,业务线也五花八门,那最好先建一个 组织,再在组织里按业务划分多个 团队。每个团队只管自己的项目和成员,互不干扰,边界更清楚。
管理组织内的团队#
组织所有者和组织管理员可以创建组织团队、将现有团队移入或移出组织,以及管理组织内团队的所有权。有关允许组织成员创建团队、查找团队、查看团队所有者状态和 移交所有权的说明,请参见管理组织内的团队。安全管理#
组织所有者和组织管理员可以前往 组织设置 > 安全 > 密钥扫描,查看各团队中尚未处理的敏感信息泄露风险。更改组织信息#
组织管理员可通过 “设置” 修改组织名称或其他信息。修改后,所有成员将看到更新后的组织信息。移交组织#
组织所有者可通过 “组织设置 -> 危险区域” 将组织所有权移交给其他成员。解散组织#
组织所有者可通过 “组织设置 -> 危险区域 -> 解 散组织” 完全解散组织。