谁在 "API Connect中做什么?

查看用户可以在 API Connect中执行的不同功能,每种类型的用户执行的典型任务集以及最常用于每个任务的文档。

V10 保留的管理员

如果在云中使用 API Connect ,那么系统由 IBM Operations 管理,并且您无需分配任何人来执行系统管理任务。

V10 Reserved 管理员使用已部署的 Reserved 实例来管理用户,以及部署和管理自我管理的网关。

用户

在最高级别, API Connect 用户属于组织,这些组织是人员组。 提供者组织(通常简称为 p-org)是一组创建、发布和维护 API 的人员,这些 API 随后由使用者组织中的人员使用。 使用者开发其自己的应用程序来调用提供者创建的 API。 单个客户可以创建多个提供者组织和使用者组织。 例如,大型公司内的不同部门可能会使用不同技术并创建完全不同的 API 集合,因此将其分组到不同的 p-org 中很有意义。 每个提供者组织将其 API 发布到 Developer Portal,该门户网站使用使用者组织来管理使用这些 API 的客户。

如果要使用 API Connect发布和管理 API ,那么至少需要一个提供者组织,并且每个客户需要一个使用者组织。

提供者组织
提供者组织在 API 的生命周期内执行许多任务,从开发、发布和维护 API 到管理组织本身的成员资格。 每个 p-org 的规模可以根据需要而定。 大型公司可能会为每个产品团队或为每个部门创建 p-org,但是小型公司可能使用单个 p-org。

个人可以是多个提供者组织的成员,并针对每个组织接收一组不同的许可权。 当用户登录到 API Connect时,他们会选择要使用其资源的组织,并在会话期间接收该组织的相应许可权。

以下角色通常与提供者组织相关联,但未必由不同的人员表示。 在小型公司中,一个人员可能会执行所有 API 维护任务,而在更大型的公司中,多个人员可能会担任不同角色。

  • 组织所有者:每个提供者组织都需要一个所有者,以确保用户帐户与组织相关联。 组织所有者对 p-org 的所有资源(API、产品、目录等)具有完全访问权,并且无法删除角色。 组织所有者可以向组织管理员角色添加人员。
  • 组织管理员:维护组织帐户是组织管理员的工作。 在大型公司中,多个人员可能会共享此角色。 组织管理员向提供者组织添加成员,并为其分配执行其作业所需的许可权。 组织所有者和管理者通常使用 管理提供者组织管理成员和角色上的文档。
  • API 开发者: 在 API Connect中, API 开发者创建新的 API 并根据需要更新现有 API。 API 开发人员可配置用于定义安全限制、日志记录规则和配额以控制对公司资源的访问权的策略。 可能会分配 API 开发人员来处理用于管理 API 子集的特定目录,或者他们可能接收对 p-org 的所有目录以及各目录中的空间的访问权。 API 开发者通常最关心与 开发 API管理 API 设置API 编写策略相关的文档。
  • API 管理员:在 API 开发人员创建一组 API 后,API 管理员将管理分发。 API 管理员定义用于确定对 API 的访问权的计划,将相关 API 收集到产品中,然后将其发布到使用者 Developer Portal。 要完成这些任务, API 管理员使用侧重于 管理 API 联合使用产品的文档。
  • 产品经理:产品经理控制对 Developer Portal 的访问,客户可在其中预订 API,然后跟踪 API 使用情况和性能。 针对每个客户,产品经理会创建使用者组织,分配客户代表作为所有者,并管理提供者组织和每个使用者组织之间的关系。 产品经理可以为其 p-org 定制 Developer Portal 的外观,以及为其使用者提供论坛和博客。 产品经理使用 API Connect Analytics 服务来跟踪 API 使用情况和性能,以便 p-org 知道何时应该更新或撤销 API。 产品经理通常使用有关 管理使用者组织使用 Developer Portal复审 API 分析的文档。
使用者组织 (Consumer organization)
使用者组织创建使用由提供者组织开发的 API 的应用程序。 每个提供者的 API 都可供 API Connect Developer Portal 中的每个使用者组织使用。 使用者组织的成员通常执行以下两个功能:
  • 使用者组织所有者:使用者组织所有者还通过邀请其他成员并向每个成员分配许可权来管理组织。 此角色还具有定制 Developer Portal 的许可权,其中成员访问组织预订的 API。
  • 应用程序开发人员:创建用于调用通过 Developer Portal 共享的 API 的应用程序。

API 使用者使用的唯一 API Connect 功能是由 API 提供者管理的 Developer Portal。 使用者无需阅读 API Connect 文档。