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

API消费方应用

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

API消费者

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

API消费凭证

API消费方应用需要使用API消费凭证(简称凭证)来调用CSB开放平台上开放的服务API。API消费者使用凭证来订购服务API。凭证具体表现为一对 AccessKey ID和AccessKey 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时,必须指定其所属的服务组。