本文主要对 CSB 开放平台涉及的专有名词及术语进行定义和解析,方便您更好地理解相关概念并使用 CSB 开放平台。

API 消费方应用

直接调用 CSB 开放平台上开放的服务 API 的消费者应用。

API 消费者

API 消费方应用在 CSB 开放平台上订购服务和管理订购的用户。

API 消费凭证

API 消费方应用需要使用 API 消费凭证(简称凭证)来调用 CSB 开放平台上开放的服务 API。API 消费者使用凭证来订购服务 API。凭证具体表现为一对 Access Key ID 和 Access Key Secret。在 API 调用时用来做签名信息计算,CSB 开放平台接收到 API 调用请求时对签名信息做验证。

API 消费者可以创建多个 API 消费凭证,每个凭证可被一个或一组 API 消费方应用使用,通常可以把凭证作为 API 消费方应用的分组。

API 提供方应用

和消费方相对,指接入 CSB 开放平台开放出服务 API 的提供者应用。

API 发布者

API 提供方应用在 CSB 开放平台上发布服务和管理服务的用户。

CSB 实例

每一组 CSB 服务总线节点(Broker)集群被视为一个独立的 CSB 实例,通常负责一个业务域内能力的对外开放,也可以发布来自外部的服务 API 给内部使用。

CSB 群组

CSB 群组对应于相对隔离的管理环境。例如企业的内部数据中心和阿里云公共云的某个地域(Region)即是不同的群组。相应地,也有 CSB 群组管理员的角色,与 CSB 实例管理员不同,只有群组管理员可以应用户请求创建共享实例。例如在阿里云公共云环境中,CSB 技术支持人员即是该群组的管理员。

一个 CSB 群组就是多个 CSB 实例的集合,这些 CSB 实例通过同一个 CSB 管理中心管理,使用同一套用户账号系统。

一个 CSB 群组内的 CSB 实例,对另一个 CSB 群组来说,就是一个“外部”实例。群组间的互通,例如典型的场景,企业自有数据中心内的 CSB 和阿里云上的 CSB 互通,需要各自的 CSB 群组管理员认可对方的账号并进行访问授权。

服务接入

服务接入 CSB 开放平台,指的是在 CSB 开放平台上注册这个服务并且提供足够的信息让 CSB 开放平台可以访问这个已有的服务。例如要接入一个 RESTful 服务,需要提供这个服务的基础 URL,要使用的 HTTP 方法等信息。

服务开放

服务在 CSB 开放平台上开放,就是把一个已接入的服务在某个 CSB 实例上开放对应的服务 API 调用入口,可以用开放时指定的各种协议(包括原协议)来访问这个服务 API。注意 API 的发布操作一定是在所接入的那个 CSB 实例,但是可以指定在其它实例上开放,这就是 CSB 开放平台特有的实现跨 CSB 实例级联开放。

服务授权

服务 API 的发布者赋予 API 消费方应用使用指定的 API 消费凭证来调用某个 API 的权限,就是授权。授权除了定性的允许、禁止之外,还可以包含更广泛的限制如访问频度控制、白名单等等。

服务组

服务组(API 组)是业务上的原子粒度分组,每一个服务 API 都归属且仅归属一个 API 组。也就是说,在发布新的服务 API 时,必须指定其所属的服务组。