联通WO+开放平台提供者指南—API策略介绍.docVIP

联通WO+开放平台提供者指南（1）—API策略介绍 目录： 流量控制策略 1.1、速率控制 安全控制策略 2.1、IP接入控制 2.2、Token认证 2.3、开发者身份认证 数据映射 3.1、XMLtoXML 3.2、XMLtoSOAP 3.3、SOAPtoXML 3.4、SOAPtoSOAP 脚本增强 4.1、MVEL 4.2、XSLT 1、流量控制策略 1.1、速率控制 使用场景 此策略控制API的全局并发调用速率。指调用部署在商用环境的API所有请求速率之和不能超过此处配置的值。并发请求数超限时，超过的请求将被拒绝并返回错误响应。此策略可用于保护后端API服务器免受大数据量冲击，能力提供者可以根据后端API服务器性能调整来修改策略中的配置值。 配置说明 在流程编排图中单击此策略图标，并参考表1配置速率控制策略。 表1?参数说明 参数 说明 TPS 您可以配置10至500的TPS值。 说明： 此策略默认值为100TPS。即如果您不配置此策略，WO+能力共享平台按100TPS控制商用环境API请求速率。 2、安全控制策略 2.1、IP接入控制 使用场景 此策略通过配置IP地址白名单或IP地址黑名单的方式对所有的API调用请求进行鉴权，允许来自IP白名单中的访问请求接入系统，或拒绝来自IP黑名单中的访问。 您可以通过配置此策略提升安全性。例如在发现网络攻击后，可以通过配置此策略拒绝来自攻击地址的API调用请求。或者开发API时配置IP白名单，仅允许来自IP白名单的请求消息接入。 配置说明 将IP接入控制策略图标拖拽至流程编排图中，并根据表1配置IP接入控制策略。 表1?IP策略配置示例 场景 填写说明 仅允许单个IP如0的IP访问API。 “允许访问的IP地址”填写为允许访问的IP地址，子网掩码设为“55”。 仅拒绝某段地址如10.10.10.*的所有地址访问API。 “拒绝访问的IP地址”填写为拒绝访问的IP地址，子网掩码设为“”。 2.2、Token认证 使用场景 此策略表示开发者调用API时，首先需要调用WO+能力共享平台提供的获取Token接口来获取“Token”。 开发者应用调用业务接口时携带已获取的“Token”信息，WO+能力共享平台对“Token”进行鉴权认证。认证通过后WO+能力共享平台处理开发者应用的接口请求，认证失败则拒绝处理开发者应用的接口请求。 配置说明 您只需将Token认证策略图标拖拽到流程编排图中，无需为此策略配置任何参数。 2.3、开发者身份认证 使用场景 此策略表示开发者调用API时，需提供“UserID+API调用密码”用于身份认证，认证通过后才处理开发者应用的接口请求，认证失败则拒绝处理开发者应用的接口请求。 配置说明 您只需将开发者身份认证策略图标拖拽到流程编排图中，无需为此策略配置任何参数。 3、数据映射 3.1、XMLtoXML XMLtoXML策略是WO+能力共享平台提供的一种将App发送的HTTP+XML格式的请求消息转换为另外一种HTTP+XML格式消息的控制策略。能力提供者无需编码，只需要应用该策略即可快速实现XML格式消息之间的字段转换、映射、屏蔽。 实现原理 XMLtoXML策略的实现原理如图1所示。 图1?实现原理? 使用场景 能力提供者无需编码，通过拖拽额策略即可实现XML格式消息之间的字段转换、映射、屏蔽等。此策略可以应用于如图2所示的几种场景。 图2?使用场景? 配置说明 在配置此策略前，能力提供者需要准备好XML消息定义文件。WO+能力共享平台支持的XML消息定义文件后缀名为“.xsd”。完成消息文件的定义后，能力提供者可以将图标拖拽至策略编排流程图中并按照界面提示进行操作即可。 3.2、XMLtoSOAP XMLtoSOAP数据映射是WO+能力共享平台提供的一种将App发送的HTTP+XML格式消息转换为SOAP格式消息的控制策略。能力提供者无需编码，只需应用该策略即可快速实现对API的接口字段映射、屏蔽和消息格式转换。此策略通常和SOAPtoXML策略配合使用，例如发送请求消息时配置XMLtoSOAP策略将请求消息从XML转换为SOAP，则同时需要配置SOAPtoXML策略将响应消息从SOAP转换为XML格式。 实现原理 XMLtoSOAP策略的实现原理如图1所示。 图1?实现原理? 使用场景 能力提供者无需编码，通过拖拽额策略即可实现XML格式消息到SOAP格式消息之间的字段转换、映射、屏蔽等。此策略可以应用于如图2所示的几种场景。 图2?使用场景? 配置说明 在配置此策略前，能力提供者需要准备好XML消息定义文件和SOAP消息定义文件。WO+能力共享平台支持的XML消息定