4.15.07.00 - 适用于私有云的 Apigee Edge 版本说明

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

2015 年 9 月 8 日（星期二），我们发布了 Apigee Edge for Private 的主要功能版本 Cloud 的最新动态和提示。

自上一个适用于私有云的 Edge 季度版本 (4.15.04.00) 以来，以下规则 已发布并包含在本季度版本中：

• Cloud：15.04.15， 15.04.29、15.05.27、15.06.10 和 15.06.24
• Private Cloud：4.15.04.01

您可以升级到哪些 Edge 版本 4.15.07.00

根据您当前的 Edge 版本，您可以执行以下任一操作：

• 直接升级到 4.15.07.00
• 逐步升级，即您必须从当前版本升级到另一个版本 然后再升级到 4.15.07.00 版本

如需了解详情，请参阅您可以升级到哪个适用于私有云的 Edge 版本 4.15.07.00.

从版本 4.15.01.x 或先前版本升级之前

1. 检查 Cassandra SSTable 版本： <ph type="x-smartling-placeholder">
   </ph>
   1. 将目录更改为 /&lt;install-root&gt;/apigee4/data/cassandra/data。
   2. 运行 find 命令，
      &gt;查找 。-name *-ic-*
      如果您运行的是 Cassandra 1.2 SSTable，则结果应返回一组 .db 文件。
   3. 运行以下查找命令：
      &gt;查找 。-name *-hf-*
      结果应为空，这意味着没有任何 .db 文件采用 hf 格式。如果您在 hf 格式，则 可以升级到 4.15.07.00
      
      hf 格式适用于 Cassandra 1.0 SSTables。如果您有任何 hf 格式的 *.db 文件，则必须 升级 SSTable。
2. 如果您发现任何 hf 格式的 *.db 文件，请升级 SSTable 在每个 Cassandra 节点上运行以下命令，直到您完成所有 Cassandra 升级 节点：
   &gt; /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost 升级 -a
3. 重复第 1 步，检查所有 *.db 文件是否均采用 Cassandra 1.2 的 ic 格式 版本。
4. 在 Edge 安装中的每个 Cassandra 节点上重复执行第 1 步到第 3 步。
5. 升级到 Edge 4.15.07.00。
6. 4.15.07.00 升级后，请检查 *.db 文件，以确保它们都已升级 升级到 C* 2.0 样式稳定版：
   &gt;cd /&lt;install-root&gt;/apigee4/data/cassandra/data
   &gt;查找 。-name *-jb-*
   如果您运行的是 Cassandra 2.0，此命令应返回一组 .db 文件。

新功能和增强功能

以下是此版本中的新功能和增强功能。

安装和升级

选择性组件升级和卸载

现在，您可以使用 apigee-upgrade.sh 和 apigee-uninstall.sh 脚本选择 Edge 组件 进行升级或卸载以前，它升级或卸载了节点上的所有组件。 （OPDK-1377、OPDK-1175）

升级回滚

如果 apigee-upgrade.sh 在升级过程中失败，您现在可以使用 apigee-rollback.sh 脚本来回滚升级。解决所有升级问题后，您可以重新尝试升级。 (OPDK-1275)

缩短了安装程序脚本选项

安装脚本不再采用较长的选项，如 --help。现在， 接受单字母选项，例如 -h。(OPDK-1356)

SmartDocs 安装

使用 setup-smartdocs.sh 脚本安装 SmartDocs 时，系统会提示您输入 组织、环境和虚拟主机，从而确保 SmartDocs 安装在 预期位置。以前，这些值在脚本中是硬编码的。(OPDK-1310)

在没有提示的情况下运行 update-cass-pwd-in-config.sh

如果您设置了 ENABLE_CASS_AUTH、CASS_USERNAME 和 CASS_PASSWORD 环境变量。(OPDK-1309)

边缘平台

以下是此版本中包含的全新 Edge 平台功能。

Edge 私有云支持 OpenJDK 1.7

此版本的 Edge 支持 Oracle JDK 1.7 和 OpenJDK 7，并取消了对 JDK 1.6 的支持。 (OPDK-1187)

操作系统支持

适用于私有云的 Apigee Edge 扩展了其操作系统支持，以纳入 Red Hat 企业版 Linux 6.6 和7.0（64 位）、CentOS 6.5、6.6 和7.0（64 位）和 Oracle Linux 6.5.

OPDK 15.07 中包含的 Cassandra 2.0.15

此版本安装了 Cassandra 2.0.15。如果您要升级之前的版本， 将更新(OPDK-1197)

对 OAuth 令牌哈希的 SHA2 支持

为了在发生数据库安全漏洞时更好地保护 OAuth 令牌，Edge 支持 SHA2 用于对 OAuth 令牌进行哈希处理的算法（除 SHA1 外）。使用新组织级别 属性，您可以为新令牌启用和配置哈希技术，并保留旧版哈希技术 。之前在适用于私有云的 Edge 中， （位于 管理服务器和消息处理器）启用 OAuth 令牌的自动 SHA1 哈希处理。这个 属性现已弃用。

如果您之前使用 hash.oauth.tokens.enabled 属性启用 SHA1 哈希，则 此版本的升级脚本会自动为您生成新的组织级属性。接收者 在升级后进行验证，请以系统管理员身份使用以下 API 执行 GET： https://{host}:{port}/v1/o/{your_org}.

• 如需了解如何使用新属性在组织中启用令牌哈希处理，请参阅 "对数据库中的令牌进行哈希处理"请参阅请求访问令牌 主题。
• 如需了解如何批量对现有令牌进行哈希处理，请参阅适用于私有云的 Edge 操作指南。(APIRT-1389)

日志文件的扁平目录结构

您可以将 Edge 配置为以扁平目录结构存储日志文件，方法是设置一个新的 message-logging.properties 中的 enable.flat.directory.structure 属性设置为 true 文件。如需了解详情，请参阅消息日志记录政策。 (APIRT-1394)

环境缓存性能

为了更好地管理和利用内存中缓存，此处的“内存中的元素数上限” 针对环境缓存资源的设置已被弃用。所有元素中 所有缓存资源（包括默认缓存）取决于分配给 缓存。默认情况下，为指定消息处理器上的内存缓存分配的总内存 是可用总内存的 40%，由邮件中的缓存属性设置决定 处理器 cache.properties 文件。仅当存在 缓存内存不足或元素过期。

要还原为使用“内存中的元素数上限”的旧行为，请执行以下操作：属性 请设置 overrideMaxElementsInCacheResource=false 属性， cache.properties 文件。(APIRT-1140)

API 服务

以下是此版本中包含的新 API 服务功能。

默认使用新代理编辑器

在管理界面中，新的 API 代理编辑器默认处于启用状态。新编辑器包括 许多易用性改进，包括更全面的条件流视图和 “Overview”页面上的端点、“开发”页面上的所有配置、以更直观的方式添加 条件流、端点和政策，提供更完整的 XML 视图，而不是小片段。 搜索文件名和文本等内容。(MGMT-2279)

新的“删除 OAuth v2.0 信息”政策

新增了“删除 OAuth v2.0 信息”政策用于删除 OAuth v2 访问令牌和授权 代码。此政策取代了之前由 Management API 提供的功能。有关 请参阅删除 OAuthV2 信息政策。(MGMT-2257)

新的“删除 OAuth v1.0 信息”政策

新增了“删除 OAuth v1.0 信息”政策允许您删除 OAuth v1.0 请求令牌、访问权限 令牌和验证程序代码此政策取代了 Management API。有关详情，请参阅删除 OAuth V1 信息政策。 (APIRT-1351)

AccessControl 政策

访问控制政策已得到增强，允许对 IP 地址进行更精细的评估 当 IP 地址包含在 X-FORWARDED-FOR HTTP 标头。

在标头上启用了多个 IP 地址检查的情况下（请联系支持人员以设置 feature.enableMultipleXForwardCheckForACL），一个 政策中新增了<ValidateBasedOn>元素 标头中的第一个 IP、最后一个 IP 或所有 IP。如需了解详情，请参阅访问权限控制政策。

“访问权限实体”政策中的新实体

访问实体政策提供对以下新实体的访问权限：consumerkey-scopes、 授权代码、请求令牌和验证程序如需了解详情，请参阅访问权限实体政策。

统计信息收集器政策：统计信息名称自动转换为小写

在 API 代理编辑器（“开发”页面 >“工具”）中创建自定义分析集合时 &gt;自定义 Analytics 数据收集），收集器变量（统计数据）“名称”必须小写。 如果您使用大写字母输入名称，该工具会自动转换统计信息名称 设置为小写。(MGMT-740)

移除了 API 代理编辑器中的传统版 Trace

API 代理编辑器中的最新版本 Trace 功能已从 Beta 版移至 正式版。对“经典版跟踪记录”的访问权限“Access the Classic version of trace” 链接已失效。

可通过管理界面“帮助”菜单访问 Apigee 社区

您可以通过管理界面的“帮助”菜单访问 Apigee 社区。

管理界面中的错误消息

以下是管理界面中的错误消息增强功能：

• 该管理界面用于对整个界面的所有错误消息进行分组并显示 登录会话，除非您关闭它们。通过此次更新，错误消息将被清除 自动触发。(MGMT-2254)
• 管理界面不再抑制重复的错误消息。(MGMT-2242)

界面性能和错误增强功能

对管理界面的不同区域进行了常规增强，包括页面显示 性能和错误消息清理。

管理界面中“组织用户”页面上的“角色”超链接

在管理界面（管理员 > 组织用户）的“组织用户”页面上，设置角色 名称现在带有超链接，便于您快速导航到角色页面。(MGMT-1055)

消息流中的新目标变量

消息流中的新变量可为目标端点和 目标服务器：

• TargetEndpoint：request.url 取代了 target.basepath.with.query。
• TargetServer：loadbalancing.targetserver 取代了 targetserver.name。 此外，只有在满足以下条件时，系统才会填充 target.basepath： <Path> 元素用于 TargetEndpoint 的 HTTPTargetConnection <LoadBalancer> 元素。

服务器名称指示 (SNI) 支持

Edge 支持使用南向服务器名称指示（从消息处理器到目标） 端点）。如果您想使用 SNI，请与 Apigee 支持团队联系。

需要 Java 1.7。

使用 SNI（TLS/SSL 的扩展）时，可以在同一网站上提供多个 HTTPS 目标 IP 地址和端口，而无需要求所有这些目标使用同一证书。

无需特定于 Edge 的配置。如果您的环境配置为向南向 SNI（默认为 Edge 云），Edge 支持该功能。

Edge 会自动从请求网址中提取 hostname，并 添加到 SSL 握手请求中。例如，如果目标主机是 https://example.com/request/path，那么 Edge 会添加 server_name 扩展程序，如下所示 如下：

如需详细了解 SNI，请参阅 http://en.wikipedia.org/wiki/Server_Name_Indication。

“签名算法”请参阅“SSL 证书详情”

全新的“签名算法”字段已添加到 SSL 证书详情中 管理界面（管理 > SSL 证书）和 Management API（获取 来自密钥库或信任库的证书详细信息）。该字段显示“sha1WithRSAEncryption” 或“sha256WithRSAEncryption”，具体取决于用来生成 证书。

显示即将过期的 SSL 证书

管理界面（“管理”>“SSL 证书”）中的“SSL 证书”页面会指明 SSL 证书会在 10、15、30 或 90 天内过期，具体取决于您在 新的过期日期下拉字段。

威胁防范错误配置

默认情况下，Edge 会抛出 HTTP 500 Internal Server Error 状态代码，以及 ExecutionFailed 错误。您可以使用新的组织级属性更改错误行为。设置组织时 属性 features.isPolicyHttpStatusEnabled 设置为 true，则 行为发生以下情况：

• 请求：如果任何请求流附加了威胁防护政策，则无效消息 返回 400 状态代码以及相应的政策错误消息。
• 响应：如果响应流程附加了威胁防护政策，则无效消息 仍会返回 500 状态代码，并且系统会抛出相应的政策错误消息 （而不仅仅是 ExecutionFailed）。

Cloud 客户必须联系 Apigee 支持团队来设置 组织属性。此功能将在下一时间提供给 Edge Private Cloud 客户 Private Cloud 季度版本。

更新了端点、代理和其他实体的架构

针对非政策实体（例如 TargetEndpoint、 ProxyEndpoint、APIProxy 等。请参阅 https://github.com/apigee/api-platform-samples/tree/master/schemas。 (APIRT-1249)

开发者服务

以下是此版本中包含的开发者服务新功能。

SmartDocs 正式发布

SmartDocs 即将从 Beta 版逐步推出正式版。更新和新功能 包括：

• 支持 Swagger 2.0，包括通过文件或网址导入，包括支持 自定义名称的安全对象。
• 改进了生成 SmartDoc 的模板的视觉设计。
• 开发者门户中的易用性和工作流程增强功能（通过“内容”页面提供） &gt;Drupal 中的 SmartDocs 菜单。
• 所谓的“自定义令牌”身份验证现在称为“API 密钥”。
• 身份验证“安全性”在修订版本级定义的对象
• 在模板级别配置客户端身份验证。不再重置新修订版本 任何预配置的 SmartDocs 客户端凭据。

有关更多功能说明，请参阅此博客 帖子。

有关 SmartDocs 文档，请参阅使用 SmartDocs 进行记录 API。

管理界面中显示的开发者应用名称

Edge 中的开发者应用既有不会更改的内部名称，也有 可以更改在管理界面（发布 > 开发者应用 >）的“开发者应用”页面上 应用名称）、应用内部“名称”与“显示名称”一同显示 以便按内部名称直观地识别应用，以便进行问题排查和进行 API 管理。

Google Analytics 服务

以下是此版本中包含的 Google Analytics 服务的新功能。

数据保留时间限制

通过管理界面或 API 生成分析报告时，系统会保留超过 6 个月的数据 默认情况下不可访问。如果您想访问 6 年之前的数据 个月，请联系 Apigee 支持团队。

旧版自定义报告将从管理界面中移除

旧版自定义分析报告（可选）在 管理界面

开发者互动微件效果

分析主信息中心（“开发者互动”部分）中的漏斗微件得到增强 以提供更好的性能。

创收

以下是此版本中包含的新创收功能。

价格方案电子邮件通知

借助新增的“价格方案”电子邮件通知类型，您可以在开发者达到特定数量 他们购买的批量包价方案或套装费率方案中的交易或美元限制。对于 请参阅设置 通知。

同步周期性费用和汇总依据期

在价格方案中，可能会存在两个不同的时间段：

• 经常性费用周期，在费率方案的“费用”标签页上配置，确定 开发者需要定期付费。
• 汇总基础期，在价目表中为按数量级或套装方案定义的， 。

这两个时间段现已同步。既有非零周期性费用，又有带卷 或套装价目表，那么这两者都会使用周期性费用期。例如： 如果存在每月周期性费用，则价目表集合也会每月重置（默认为 月初）。

如果不存在周期性费用，则系统会根据 价目表例如，如果开发者在当月 19 号开始使用价目表， 汇总基础为每月一次，然后会于 19 日之后重置套装使用时间。

汇总基础功能即将被弃用，未来将停止用于创收 发布。有关详情，请参阅指定价目表方案 详情。

摘要收入报告中的自定义属性

借助交易记录政策，您可以选择从 而且您现在可以将这些自定义交易属性添加到摘要收入中 报告。向您的组织添加 MINT.SUMMARY_CUSTOM_ATTRIBUTES 属性后，您可以 表示将哪些自定义属性添加到数据库表以供报告使用。

适用于私有云客户的 Apigee Edge 可通过以下 API 调用设置标志，以及 系统管理员凭据。

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

请注意，API 调用中的自定义属性数组已进行网址编码。

SmartDocs 升级流程

如果您在测试版使用期间已经在使用 SmartDocs 则要求您在开发者帮助中心中升级 SmartDocs 。

已在开发者门户中发布的所有 SmartDocs 页面都将继续 可以正常使用，但是您必须先按照更新流程操作，然后才能修改现有的 或新网页。

请注意，虽然您可以在开发者门户中呈现和发布 SmartDocs， SmartDoc 由 Apigee 的 Edge API Management 中的 API 模型生成 服务。您在 Edge 中对 API 模型所做的任何更改，都会在您的所有 Pantheon 中相同 （类似于开发者在 Pantheon 环境中存在的方式）。

从 SmartDocs Beta 版升级到正式版

1. 在以下位置更新和测试 15.05.27 版本： dev 或 test 环境 Pantheon。
2. 创建新模型以替换您正在使用的任何现有 API 模型。
   • 如果您一直在导入 Swagger 或 WADL 文档，请再次将其导入新的 修订版本
   • 如果您一直在通过 SmartDocs 模块维护 API 模型，请导出为 SmartDocs JSON，并使用文件附件导入到新模型中。
3. 设置模型修订版本的安全属性。在内容 > 智能文档 >模型页面中，选择安全设置。
   
4. 在模型设置页面（内容 > SmartDoc) 列。
   
5. 更新所有自定义模板以使用 v6 的 CSS 和 JS 资源，并进行更改以反映 任何新的对象名称，例如 authSchemes 和 apiSchema。有关更新 SmartDocs 的信息 请参阅使用 使用 SmartDocs 对 API 进行文档编写。
6. 重新渲染并发布模型修订版本。
7. 验证新文档后，请更新 生产门户升级到 15.05.27 版本。

如果您是 Edge 企业客户，并对升级有疑问或疑虑 流程，请发送电子邮件至 marsh@apigee.com 和 cnovak@apigee.com。否则，请使用 Apigee 社区，获得最佳体验 响应。

未来的功能变更和增强功能

本部分用于预览未来预计的功能变更和增强功能：

更改为 响应缓存政策行为

在未来的版本（待定）中， &lt;ExcludeErrorResponse&gt;响应缓存政策的元素。

当前行为：<ExcludeErrorResponse> 元素在 响应缓存政策默认为 false。这意味着，在默认情况下，包含 可能的 HTTP 状态代码（包括 3xx）由响应缓存策略缓存。

未来行为：<ExcludeErrorResponse> 元素在 响应缓存政策默认为 true。这意味着，在默认情况下， 系统将缓存状态代码 200 到 205。要覆盖此行为并缓存所有 您需要设置 <ExcludeErrorResponse> 元素，更改为 true。

当前的解决方法 ：对于 Private Cloud 4.15.07.00 及更低版本，如果 希望仅使用状态代码 200 到 205 缓存响应，则必须将 <ExcludeErrorResponse> 元素true。

已修复 Bug

此版本中修复了以下 bug。

已知问题

此版本存在以下已知问题。

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart