您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 info
我们已在 2017 年 1 月 25 日(星期三)发布了新版 Apigee Edge for Private Cloud。
自上一个 Edge for Private Cloud 功能版本发布以来,以下版本已发布并包含在此功能版本中:
请参阅版本编号简介,了解如何确定您的 Edge for Private Cloud 版本中是否包含特定的云版本。
版本概览
此版本包含许多重要功能,可帮助您更好地控制和保护 API。
借助共享流和流钩子,您可以创建一组可在多个 API 代理中重复使用的政策和行为。
键值对映射 (KVM) 已经是 Edge 的一项功能,用于长期保留键值对,现在可以加密以提高数据安全性。
为了更灵活地控制开发者对 API 的访问权限,Edge 管理界面提供了更多选项,用于创建和管理 API 密钥和密钥(凭据)、撤消开发者应用以及停用开发者。借助这些增强功能,您可以更轻松地实施 API 密钥轮替等策略,还可以通过撤消开发者应用(其所有密钥均被停用)或停用开发者(该开发者的所有应用和密钥均被停用)来停用多个 API 密钥。
在弃用方面,创收限制功能已停用。
本主题的其余部分详细介绍了此版本中包含的所有新功能、更新和问题修复。
弃用和停用
此版本中弃用或停用了以下功能。如需了解详情,请参阅 Edge 弃用政策。
已停用:创收限制(Cloud 16.10.26 界面)
创收限制功能已从管理界面(管理 > 限制)中移除。如需了解详情(包括替代方案),请参阅弃用通知:http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice。 (DEVRT-3259)
移除了对 RedHat/CentOS 6.5 版的支持
如果您目前使用的是 RedHat/CentOS 6.5 版,则必须先将操作系统更新到 6.6 版或更高版本,然后才能更新到 Edge 4.17.01。
新功能和更新
以下是此版本中的新功能和增强功能。除了以下增强功能之外,此版本还包含多项易用性、性能、安全性和稳定性增强功能。
如需了解更多详情和说明,请参阅 Edge for Private Cloud 文档。
私有云
现在可以在 Edge 界面上显示意见征求横幅
您可以在用户首次访问 Edge 界面时显示意见征求横幅。意见征求横幅会显示 HTML 格式的文本和一个按钮,用户选择该按钮即可进入登录界面。 如需了解详情,请参阅启用意见征求横幅。
API BaaS 支持多个数据中心
现在,您可以在多个数据中心安装 API BaaS。 如需了解详情,请参阅适用于 API BaaS 的多数据中心安装。
新的 API BaaS 安装配置参数
API BaaS 配置文件中添加了两个新的配置参数:
- BAAS_CASS_DC_LIST - 指定 BaaS 数据中心的区域名称。对于单个数据中心,请指定与 BAAS_CASS_LOCALDC 相同的值。
- BAAS_CLUSTER_SEEDS - 指定用于定义 BaaS 集群种子的 BaaS Stack 节点。
如需了解详情,请参阅将 Apigee Edge 4.16.09 更新到 4.17.01。
不再使用 apigee-service 命令运行 API BaaS 的“deploy”选项
API BaaS Stack 和 Portal 不再支持 apigee-service 命令的 deploy 选项。而是使用 configure 和 restart 选项。 如需了解详情,请参阅 API BaaS 安装。
API BaaS 的新端口要求
现在,所有 BaaS Stack 节点都必须打开端口 2551,以便所有其他 Stack 节点访问。如果您有多个 BaaS 数据中心,则必须能够从所有数据中心的所有 Stack 节点访问该端口。
如需了解详情,请参阅 API BaaS 安装和安装要求。
开发者服务门户现在使用 Postgres 作为其数据库,并使用 Nginx 作为其 Web 服务器
对于所有新安装,门户使用 Postgres 作为其数据库,而不是 MySQL 和 MariaDB。从先前版本升级到 4.17.01 的客户将继续使用 MySQL 或 MariaDB。
4.17.01 的新安装也会将 Nginx 安装为 Web 服务器。从先前版本升级到 4.17.01 的客户将继续使用 Apache。
开发者服务门户不再默认启用 SmartDocs
您必须在门户上启用 SmartDocs。如需详细了解 SmartDocs,请参阅使用 SmartDocs 记录 API。
现在通过 RPM 安装开发者服务门户
4.17.01 版开发者服务门户是使用与 Edge 和 API BaaS 相同的代码库和工具从 RPM 安装的。如需了解详情,请参阅开发者服务门户安装。
基于 RPM 的安装和基于 .tar 的更新程序使用不同的组件:
|
基于 RPM 的安装 |
基于 .tar 的安装 |
|
|---|---|---|
|
Web 服务器 |
Nginx |
Apache |
|
Web 根目录 |
/opt/apigee/apigee-drupal |
/var/www/html |
|
端口 |
8079 |
80 |
|
数据库 |
PostgreSQL |
MySQL |
|
PHP |
php-fpm (FastCGI) |
mod_php(与 Apache 进程内运行) |
Qpid 已升级到 1.35 版
此版本包含 Qpid 1.35 版。
Cassandra 已升级到版本 2.1.16
此版本包含 Cassandra 2.1.16 版。
Play 已升级到 2.4 版
此版本包含 Play 2.4 界面框架。
添加了对 RedHat/CentOS 7.3 版的支持
Edge 现在支持 RedHat/CentOS 7.3 版。
Beta 版监控信息中心更新
Edge 监控信息中心的 Beta 版已更新为:
- 添加了适用于 Cassandra、Zookeeper、OpenLDAP、Postgres 和 Qpid 的新信息中心。
- 将 4.16.09 中的 Influx 版本从 0.11 升级到 1.0.2。
- 添加了多项稳定性修复。
如需了解详情,请参阅 Apigee Monitoring 信息中心 Beta 版概览。
现在可以在安装配置文件中设置 Postgres 密码
使用 PG_PWD 属性在安装配置文件中设置 Postgres 密码。如需了解详情,请参阅 Edge 配置文件参考文档。
启用 EPEL 代码库
您必须启用 Extra Packages for Enterprise Linux(或 EPEL)才能安装或更新 Edge。如需了解详情,请参阅安装要求。
您使用的命令取决于您的 RedHat/CentOS 版本:
- 对于 RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm - 对于 RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm
使用 NSCD(名称服务缓存守护程序)时,停用 IPv6 上的 DNS 查找
如果您已安装并启用 NSCD(名称服务缓存守护程序),则消息处理器会执行两次 DNS 查找:一次针对 IPv4,一次针对 IPv6。使用 NSCD 时,您必须停用 IPv6 上的 DNS 查找。如需了解详情,请参阅安装要求。
如需停用 IPv6 上的 DNS 查找,请执行以下操作:
- 在每个消息处理器节点上,修改 /etc/nscd.conf。
- 设置以下属性:
enable-cache hosts no
API 服务
用于使 API 代理可操作的共享流和流钩子(Cloud 16.09.21)
借助新的“共享流”功能,您可以在 API 代理中实现功能。通过将条件化政策和资源组合到共享流中,您可以从任何 API 代理引用该共享流,以执行单一来源的可重用逻辑。例如,共享流可能会验证 API 密钥、防范峰值骤增并记录数据。
您可以在管理界面(API > 共享流)中定义共享流,然后通过以下两种不同的方式引用它们:
- 在 API 代理中使用新的流调用政策
或 -
在名为“流钩”的新工件上,这些工件位于以下位置:
通过这些连接点,您可以在各个代理的主要流点之前或之后执行操作逻辑。您可以在管理界面(API > 环境配置 > 流钩子)中将共享流分配给这些流钩子位置。
- 请求:在 ProxyEndpoint PreFlow 之前,在 TargetEndpoint PostFlow 之后
- 响应:在 TargetEndpoint PreFlow 之前,在 ProxyEndpoint PostFlow 之后
如需了解详情,请参阅可重复使用的共享流和使用流钩子附加共享流。
加密的键值对映射(Cloud 16.09.21)
您可以创建加密的键值对映射 (KVM),用于存储敏感信息,例如凭据或 PII/HIPAA 数据。此功能与现有的 Edge 安全存储区(保险柜)不同,旨在取代它,因为保险柜值只能通过 Node.js(以及 Management API)访问。您可以使用 Node.js 或键值对映射操作政策访问加密的 KVM 值。
创建加密 KVM
- 使用现有的 KVM 管理 API。如果您在创建 KVM 时在载荷定义中添加
“encrypted”: “true”,Edge 会生成一个与 KVM 具有相同范围的加密密钥,并使用该密钥对 KVM 进行加密。 - 您无法使用键值对映射操作政策创建加密 KVM。您必须先使用 KVM Management API 创建已加密 KVM,然后才能在政策中使用它。
- 您无法加密现有的未加密 KVM。
使用加密的 KVM
- 使用键值对映射操作政策获取和更新加密的 KVM 值。
- 获取加密的键值时,请在用于保存该值的变量前面加上关键字“private”。例如
<Get assignTo="private.secretVar">。该private.secretVar变量会保存解密后的值。 - 使用政策更新值时,您无需执行任何特殊操作。该值将在加密 KVM 中自动加密。
- 您还可以在 Node.js 代码中使用 apigee-access 模块访问解密后的值。使用函数
getKeyValueMap()根据名称和范围检索 KVM。返回的对象上有两个函数:getKeys(callback)用于获取键名称数组,get(key, callback)用于获取特定键的值。例如,以下代码会获取名为VerySecureKVM的apiproxy范围 KVM,并检索key1的加密值:var apigee = require('apigee-access'); var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy'); encryptedKVM.get('key1', function(err, secretValue) { // use the secret value here });
如需了解详情,请参阅使用键值对映射和在 Node.js 中访问键值对映射。
(APIRT-1197)
在界面中创建加密的键值对映射(16.10.26 界面)
在管理界面(API > 环境配置 > 键值对映射)中创建环境范围的键值对映射 (KVM) 时,您可以通过新的已加密复选框创建加密的 KVM。将密钥添加到 KVM 后,加密值会在管理界面中显示为星号 (*****)。您向加密 KVM 添加键值对的方式与向非加密 KVM 添加键值对的方式完全相同。云版本 160921 中提供了对加密 KVM 的完整后端支持。(EDGEUI-764)
API 代理元数据中包含的 OpenAPI 规范网址(Cloud 16.09.21)
当您根据 OpenAPI 规范创建 API 代理时,OpenAPI 规范的位置会存储在 API 代理元数据中。例如,如果您使用 Management API 获取代理修订版本的详细信息,则元数据会包含 OpenAPI 规范的路径,格式如下:
"spec" :
"https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"
此增强功能支持新一代 Edge,它将 OpenAPI 规范与新开发者门户中的 API 代理、API 产品和 API 参考文档相关联。(MGMT-2913)
为 SOAP 代理生成 OpenAPI 规范(Cloud 16.10.05 界面)
当您基于 WSDL 创建“REST 到 SOAP 到 REST”代理时,Edge 会根据代理资源自动生成托管式 OpenAPI 规范。您可以通过 http(s)://[edge_domain]/[proxy_base_path]/openapi.json 访问该规范。但是,转换并不总是准确的,因为并非 XML 架构的所有规则都可以在 OpenAPI 规范中表示。(EDGEUI-718)
用于直通 SOAP 代理的 Edge 托管 WSDL(Cloud 16.10.05 界面)
当您基于 WSDL 创建“直通 SOAP”代理时,Edge 会托管 WSDL 并在代理中创建一个流,以便您访问它。您可以通过 http(s)://[edge_domain]/[proxy_base_path]?wsdl 访问托管的 WSDL,这是客户端通过代理调用 SOAP 服务的新服务端点网址。(EDGEUI-718)
API 代理向导中的新示例股票报价 WSDL (Cloud 16.08.24.01)
使用 API 代理向导创建 SOAP 服务 API 时,示例中提供了替换股票报价 WSDL:https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL。 (EDGEUI-655)
开发者服务
界面中的开发者应用管理功能(Cloud 16.10.05 界面)
Edge 界面中的开发者应用管理功能得到了多项增强,功能更加强大:
- 您可以在新的“应用状态”字段中撤消和批准应用(在修改模式下)。在查看模式下,该字段还会显示当前的应用状态。如果应用被撤消,则其所有 API 密钥都无法用于 API 调用。密钥本身不会被撤消,如果开发者重新获得批准,则可以再次使用。当应用处于已撤消状态时,API 密钥的“已批准”标签会以删除线文本显示。
- API 密钥到期日期现在显示在“开发者应用详情”页面上,密钥按到期日期整理在“凭据”部分中。例如,没有到期时间的密钥会显示在一个组中,并显示其关联的 API 产品;而 90 天后到期的密钥会显示在另一个组中,并显示其关联的产品。您无法更改现有凭据的到期时间。
- 借助开发者应用修改模式中新增的“添加凭证”按钮,您可以生成具有特定到期时间或日期(或无到期时间)的 API 密钥。在创建凭证时(或之后),您可以向其添加 API 产品。
此功能取代了“开发者应用详情”页面上的“重新生成密钥”按钮。该按钮已被移除。
这些增强功能在界面中添加了 Management API 中已有的功能。 (EDGEUI-104)
在界面中激活/停用应用开发者(Cloud 16.10.05 界面)
您可以在 Edge 界面(“开发者详情”页面、修改模式、“激活”/“停用”按钮)中将应用开发者的状态更改为有效或无效。当开发者处于非活跃状态时,其开发者应用 API 密钥或使用这些密钥生成的 OAuth 令牌在对 API 代理的调用中均无效。(EDGEUI-304)
界面中的非活跃开发者指示器(16.10.26 界面)
当应用开发者设置为“无效”时,开发者的应用和凭据将不再有效,即使它们仍处于“已批准”状态也是如此。现在,在管理界面中查看非活跃开发者的应用和凭据时,应用和凭据上的“已批准”状态标签会以删除线文本显示,并且标签上的鼠标悬停提示会指示开发者处于非活跃状态。如果开发者恢复为“有效”,则其已获批准的应用和凭据将再次有效,并且“已批准”标签上的删除线文本将被移除。(EDGEUI-728)
分析服务
重命名了“错误代码分析”信息中心(16.10.26 界面)
“错误分析”信息中心已重命名为“错误代码分析”。该信息中心包含 HTTP 状态代码为 4xx 和 5xx 的 API 调用。(EDGEUI-738)
代理信息中心上的 TPS 数据(16.10.26 界面)
每秒平均事务数(“平均 TPS”)的数据已添加到主代理流量信息中心。此外,当您将鼠标悬停在“代理流量”和“代理性能”图表上的各个数据点上时,系统会在提示中显示该时间间隔的 TPS。 (EDGEUI-668)
Analytics 错误显示(16.10.26 界面)
当分析信息中心收到 500 错误时,管理界面会显示“报告超时”,而不管错误是什么。为了提供更好的问题排查功能,界面现在会显示实际错误。(EDGEUI-753)
修复了 bug
此版本中修复了以下 Bug。此列表主要供用户检查其支持服务工单中的问题是否已修复,并非旨在为所有用户提供详细信息。
Edge for Private Cloud 4.17.01
| 问题 ID | 说明 |
|---|---|
| APIBAAS-1990 | 当 smtp.auth 为 false 时,API BaaS Stack 不再尝试向 SMTP 进行身份验证 |
| APIRT-3032 |
现在,运行“apigee-service baas-usergrid restart”命令也会运行“configure” 您不再需要为 BaaS Stack 运行“apigee-service baas-usergrid configure”,然后运行“apigee-service baas-usergrid restart”。 |
| APIRT-3032 |
如果主机名是 IP 地址,请勿执行 DNS 查找。 |
| DOS-4070 |
“apigee-all -version”现在会显示 edge-mint-* RPM 的版本 |
| DOS-4359 |
添加了“pdb”选项,以便仅安装 Postgres 数据库。 仅在安装开发者服务门户时使用。 请参阅开发者服务门户安装。 |
Cloud 16.10.26(界面)
| 问题 ID | 说明 |
|---|---|
| EDGEUI-768 | 使用 StockQuote WSDL 创建代理失败 |
Cloud 16.09.21_9
| 问题 ID | 说明 |
|---|---|
| MGMT-3674 | 无法为启用了 HIPAA 的组织创建加密的 KVM 或保险柜 |
| MGMT-3647 | 电子邮件地址中包含大写字母的用户在访问用户角色时会收到 403 错误 |
Cloud 16.09.21
| 问题 ID | 说明 |
|---|---|
| APIRT-3507 | JavaScript 服务标注出现间歇性错误(例如 SNI 错误) |
| APIRT-3408 | MP 版本 160817 apigee-access 分析模块以不同方式处理消息 |
| APIRT-3390 |
刷新访问令牌政策返回的故障响应发生变化 |
| APIRT-3389 | |
| APIRT-3381 | 客户生产代理延迟时间较长 |
| APIRT-3366 | JavaScript 政策在所有新的试用组织中均失败 |
| APIRT-3363 | 无效的网址解析会返回 500 状态和 ApplicationNotFound |
| APIRT-3356 | OAuth 令牌无效消息 |
| APIRT-3355 | OAuth 代理上出现间歇性 403 错误 |
| APIRT-3285 | |
| APIRT-3261 | 凭据会根据正式版中的其他开发者应用进行验证 |
| APIRT-3234 | Node.js 应用返回 NPE |
| APIRT-3223 | Apigee 缓存过时问题 |
| APIRT-3193 | Node.js 目标服务器在移至 ASG 后挂起 |
| APIRT-3152 | cachedlogs 管理调用导致日志消息被拆分 |
| APIRT-3117 | MP 的 CPU 利用率达到 100%,并停止处理流量 |
| APIRT-3064 | 路由器 - 来自路由器的自定义 503 出错提示 |
| APIRT-2620 | 为一些阻塞步骤提供单独的线程池,以改进负载处理 |
| CORESERV-774 | 使用具有无效 apiproduct 引用的有效密钥进行访问会导致内部服务器错误 |
Cloud 16.10.05(界面)
| 问题 ID | 说明 |
|---|---|
| EDGEUI-697 | “报告”页面导出按钮 “导出”按钮已从“自定义报告”首页中移除。每个自定义报告页面上都提供报告导出功能。 |
Cloud 16.08.24.01
| 问题 ID | 说明 |
|---|---|
| EDGEUI-663 | 为 Weather.wsdl 的 WeatherHttpGet 端口生成的代理在运行时失败,并显示 500 错误 为 SOAP 服务生成 API 代理时,没有 SOAP 协议绑定的 WSDL 端口不再显示在 API 代理向导中。这是特意设计的,因为该向导仅生成 SOAP 请求。 |
| EDGEUI-658 | SOAP WSDL 透传操作名称问题 |
| EDGEUI-653 | 选择“启用 CORS”选项时,创建 Node.js API 代理时出错 |
| EDGEUI-648 | 界面中耗时 2 到 3 分钟的调用会超时 |
| EDGEUI-623 | 在 Firefox 上,“组织历史记录”中的“更改日期”按钮无法正常运行 |