组织
组织将凭据统一归集在一位所有者名下,以便多人共享:包括用于 JSON API 的 API key,以及用于 proxy 端口的 proxy 用户。组织凭据产生的所有开销,均计入组织所有者的套餐用量,而非发起请求的用户个人账户。
访问路径
登录 控制台,点击侧边栏中的 Organizations。您加入的每个组织都会以单独一行显示:
| 列 | 说明 |
|---|---|
| Organization | 组织名称。点击名称或 Open 即可进入该组织详情页。 |
| Your role | Owner、Admin 或 Member |
| Members | 成员总数(包含所有者) |
| Keys | 该组织拥有的 API key 数量 |
| Created | 创建时间 |
| Actions | Open |
创建组织
点击 New organization,输入 2 到 60 个字符的名称并确认。您将自动成为该组织的所有者。名称可包含字母、数字、空格以及 . , & + ( ) - _ ',最多 8 个单词,不能是网址;重命名时也必须遵守此规则。名称中必须包含至少一个拉丁字母(a 到 z)或数字,且不能与已有组织重名(比对时仅对比拉丁字母和数字且不区分大小写,其余字符均被忽略)。
创建组织需要支持多人的套餐。Usage & Limits 中的 Organizations you own 行会显示当前套餐是否支持。
角色权限
共有三种角色,每个组织有且仅有一位所有者。
| 角色 | 权限说明 |
|---|---|
| Member | 创建并使用组织的 API key 和 proxy 用户,重命名其 API key,查看组织成员和团队 |
| Admin | 拥有 Member 的全部权限,此外可添加和移除成员、更改成员角色、管理组织的所有凭据以及重命名组织 |
| Owner | 拥有 Admin 的全部权限,此外可将组织移交给其他人。所有组织凭据产生的计费均挂在该所有者的套餐下。 |
所有者不能被移除、不能主动退出,也不能被降级。所有权仅支持单向转让。
加入组织即可获得其凭据的访问权限。即使是没有管理员权限的成员,也可以创建由公司付费的 key 或 proxy 用户,这正是其设计初衷:编写采集程序的开发者无需使用个人凭据,避免费用计入个人账单而非公司账户。
组织页面
点击任意行的 Open 即可进入对应组织页面。顶部有六张卡片:Members(下方细分显示所有者、管理员和成员人数)、Your role、Owner、API keys、Proxy users 以及 Teams。卡片下方有两个标签页:
- Members:组织内的成员列表,以及您当前角色拥有的管理操作。
- Teams:您在该组织内所属的团队,只读显示。
所有者和管理员的页面顶部还会显示一个 Rename 按钮。
添加成员
所有者和管理员会在“成员”表格上方看到添加成员卡片。输入邮箱地址,选择成员或管理员,然后提交。
后续流程取决于该邮箱地址的状态,控制台会明确提示属于哪种情况:
- 该地址已有 FourA 账户:他们会立即加入,并收到一封电子邮件,说明所属组织、添加人以及该角色拥有的权限。
- 该地址尚无账户:FourA 会向其发送邀请邮件,他们只要使用该地址登录即可立即加入。无需额外点击确认,无论对方是新注册还是已有从未登录过的账户,邀请均有效。
邀请在 14 天后失效。重复添加同一地址不会重叠发送第二封邀请。FourA 对同一组织的同一地址每 24 小时仅发送一次邀请(已撤回的邀请也计入):在此时间窗口内的第二次尝试会被拒绝并提示 我们今天已向该地址发送过邀请。请明天再试。,且先前已发送的邀请仍然有效。每人在 24 小时内跨所有组织总共可发送 20 次邀请。
每当有新成员加入时,所有者都会收到邮件通知,因为新成员会消耗所有者的额度。用户自身的操作不会收到确认邮件。
待处理的邀请
只要存在至少一个有效邀请,“成员”上方就会显示邀请表格,所有者和管理员可见。表格中列出了邮箱地址、待分配角色、邀请人以及邀请时间。已过期的邀请仍会保留在列表中并带有标记,以便了解未加入的原因。可使用该行中的操作撤回邀请。
更改角色
所有者和管理员可以通过“角色”列中的下拉菜单在成员与管理员之间切换。包含三条规则:
- 您无法更改自己的角色。请联系其他管理员,或直接退出组织。
- 所有者的角色无法在此处编辑。请改用指定为所有者。
- 每次更改都会弹出确认提示,并说明该成员更改后具备的操作权限。
移除成员与退出组织
除自身和所有者所在行外,所有者和管理员在其他所有行均可使用移除操作。您自己的行则显示为退出,除非您是所有者:所有者所在行会显示为承担计费。
移除成员会同时将其移出该组织下的各个团队,因此他们会立即失去查看该组织凭据的权限。但这不会影响凭据本身:组织的 API Key 或 proxy 用户属于组织所有,而非创建者个人。
所有者既不能被移除,也不能直接退出。必须先转让组织所有权。
转让组织所有权
仅所有者可以执行此操作。在“成员”标签页中,点击接管人所在行的指定为所有者并确认。
组织将切换至其套餐方案:从该时刻起,该组织各 Key 发起的每一次 request 以及各 proxy 用户建立的每一条隧道,都将计入其额度、流量、配额和账单。原所有者将转为管理员,并保留管理员的所有操作权限。
您能看到的 Key
组织拥有的每个密钥对组织内的每个人都可见。区别在于你可以对其执行的操作:
| 操作 | Member | Admin | Owner |
|---|---|---|---|
| 使用密钥、查看密钥、创建新的组织密钥 | 是 | 是 | 是 |
| 重命名、编辑其描述 | 是 | 是 | 是 |
| 重新生成、禁用、删除 | 否 | 是 | 是 |
| 将密钥移出组织 | 否 | 否 | 是 |
重命名密钥没有影响。重新生成或禁用密钥会在发生瞬间阻止每位正在使用它的同事,因此这些权限归属于 Admin。将密钥移出组织会将资产带离公司,并将其用量转至接收者自己的套餐中,因此该权限仅归属于 Owner。
完整操作指南请参见 Managing API Keys。
你能看到的 Proxy 用户
出于同样的原因,proxy 用户也遵循相同的三个级别。
| 操作 | Member | Admin | Owner |
|---|---|---|---|
| 使用、读取其密码、创建新用户 | 是 | 是 | 是 |
| 更换密码、禁用、删除、修改已保存的定位配置 | 否 | 是 | 是 |
| 将其转出组织 | 否 | 否 | 是 |
已保存的定位配置归 Admin 而非 Member 管理,因为重新定向会静默重定向整个组织使用该凭据建立的每个连接。更换密码也归 Admin 管理,因为它会破坏已经粘贴了该凭据的每个配置文件。
公司的下载程序应使用组织的 proxy 用户。个人的 proxy 用户在该员工离职时就会失效,并且会向其个人计费。操作指南请参见 Proxy Users。
所有者筛选器
加入组织后,Owner 下拉菜单会显示在 Overview、Metrics、Activity、API Keys 和 Proxy 上方。它包含三类选项:Everything、Personal 以及每个组织对应的条目。该选择会在多次访问之间保持有效,并应用于这五个页面中的每一个。
Usage & Limits 和 Billing 明确不采用此筛选器。它们回答的是“由谁付费”,这与“我能看到什么”是不同的问题:Member 永远看不到 Owner 的配额。
计费归属
无论由谁发起,使用组织拥有的密钥发出的每个 request,以及使用组织拥有的 proxy 用户建立的每个隧道,均向组织所有者计费。这正是将凭据移入组织的全部意义所在:它改变了积分、流量、套餐限额和账单的计费归属对象。
所有者的 Usage & Limits 页面在 API keys 选项卡和 Proxy users 选项卡中,将组织凭据与其个人凭据一同统计,并将两者分开列出,以便清楚了解支出来源。
团队
每个组织都会获得一个名为 Everyone 的默认团队。新密钥会自动归档到该团队中,加入组织的每个人也都会被添加到该团队中,这使得成员身份可以直接获得密钥的访问权限。
Teams 选项卡列出您所属的团队,以及您在各个团队中的角色、成员数量和可供您使用的 Key(Keys you can use)。目前控制台中尚不支持创建和编辑团队。
相关内容
- 管理 API Key:在组织内创建、转移和管理 Key
- Proxy 用户:在组织内创建和转移 proxy 用户
- 用量与限制:团队成员、组织以及套餐允许的配额
- 账单与订阅:所有者的套餐如何覆盖组织 Key 的用量
- 控制台概览:所有控制台板块