您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
2015 年 5 月 19 日（星期二），我们发布了 Apigee Edge for Private Cloud 的季度版本。
之前的产品名称“Apigee Edge On-premises”或“OPDK”现在为“Apigee Edge for Private Cloud”。
如果您有任何疑问，请与 Apigee Edge 支持团队联系。
如需查看所有 Apigee Edge 版本说明的列表，请参阅 Apigee 版本说明。
新功能和增强功能
以下是此版本中的新功能和增强功能。
OpenLDAP - 安装和升级
现在，OpenLDAP 是 Edge 支持的唯一 LDAP 服务器，适用于新安装和升级安装。
API 服务
以下是 Edge API 服务中的新功能和增强功能。
WebSocket
为了在网络客户端与服务器之间实现实时网络通信，Edge 支持 WebSocket 协议。在 WebSocket 通信中，Edge 可以充当客户端或服务器的角色。如需了解如何在 Edge 中设置和使用 WebSocket，请参阅 Apigee Edge for Private Cloud Using WebSockets 指南。
支持将外部身份验证提供程序用于 API 管理
Edge 可与 Active Directory 和其他包含 API 管理用户的外部身份验证提供方/LDAP 系统集成。如需了解详情，请参阅 Edge for Private Cloud 外部身份验证配置指南。
管理界面中的品牌联合
您可以使用自己的自定义徽标与 Edge 管理界面进行品牌联名，该徽标会显示在 Apigee 徽标旁边。如需了解详情，请参阅 Apigee Edge for Private Cloud Operations Guide 中的“向 Apigee 界面菜单添加自定义徽标”。
Trace 中的 Node.js 日志
调试 Node.js API 代理时，您可以在 API 代理编辑器的 Trace 视图中启用 Node.js 日志功能。如需启用此功能，请在安装中的 apigee-base.conf 或 apigee-onpremise.conf 文件中设置 apigee.feature.disableNodeJSLogs="false"。如需详细了解 Node.js 日志，请参阅调试 Node.js 代理并排查其问题。
密码失效
在 Edge 4.15.01.x 中，Edge 密码会在 30 天后自动过期。这意味着，除非用户在密码过期之前更改密码，否则会被锁定。不过，这也导致系统管理员的密码过期，以致系统管理员无法登录 Edge。
升级到 4.15.04.00 后，默认设置会发生变化，密码不会过期。如有必要，您可以使用 /opt/apigee4/bin/apigee-enable-pwlockout.sh 脚本将 Edge 密码配置为过期。如需了解详情，请参阅 Apigee Edge for Private Cloud 运营指南。
限制系统管理员对特定电子邮件网域的访问权限
您可以将 sysadmin 或 sysadmin read-only 角色的成员资格限制为特定电子邮件网域中的用户。如需启用此功能，请按照 Apigee Edge for Private Cloud Operations Guide 中的说明，将允许的网域添加到 apigee4/conf/apigee/management-server/security.properties 文件中。
管理界面错误消息
管理界面中的错误消息显示方式经过重新设计，可更高效地利用屏幕空间。
新的 OAuthV2 故障变量
OAuthV2 政策会设置以下与故障相关的新变量：
- oauthV2.<policy-name>.failed - 如果政策失败，则设置为 true。
- oauthv2.<policy_name>.<fault_name> - 故障的名称。例如，invalid_request
- oauthv2.<policy_name>.<fault_cause> - 故障原因。 例如：令牌已过期
请参阅 http://apigee.com/docs/api-services/content/oauthv2-policy。
商品创建
现在，您可以在创建新商品时指定商品名称，而不仅仅是显示名称。
请参阅 http://apigee.com/docs/developer-services/content/creating-api-products。
用于从组织中移除用户的界面
在界面中的“组织用户”页面上，“删除”按钮已替换为“移除”按钮。 这是为了明确说明，当您从组织中移除用户时，该用户的 Apigee 账号仍处于有效状态。
请参阅 http://apigee.com/docs/api-services/content/managing-organization-users。
管理界面中的过滤选项
在管理界面中的“API 代理”“产品”“开发者”和“应用”页面上，您可以使用新的过滤选项进行搜索。
离线跟踪工具
利用离线跟踪工具，您可以查看并分析之前保存的跟踪会话。已保存的跟踪会话实质上是跟踪会话的“记录”，在需要进行问题排查和进一步分析的情况下非常有用。离线跟踪工具的界面类似于“实时”跟踪工具。
如需了解详情，请参阅使用离线 Trace 工具。
“用户设置”中显示的用户角色
在管理界面的“用户设置”页面（用户名 > 用户设置）上，现在会显示用户的角色。
边缘管理界面增强功能
此版本对 Edge 管理界面进行了一些细微的可用性和一致性改进。
分析服务
以下是 Edge Analytics Services 中的新功能和增强功能。
可查看 6 个月的数据
使用管理界面或 API 生成分析报告时，默认情况下无法访问从当前日期起 6 个月之前的数据。如果您需要访问 6 个月之前的数据，请与 Apigee Edge 支持团队联系。
已添加到分析中的变量
以下新变量会传递给 Edge Analytics，并在 API 代理跟踪窗口的 AX 阶段中显示。
- apigee.edge.execution.is_target_error - 用于标识 API 错误是不成功的 HTTP 响应的目标端错误（值为“1”）还是非目标端错误（值为“0”）。对于成功的 HTTP 响应，该值为 null。
-
apigee.edge.execution.is_policy_error - 用于标识政策是否失败（值为“1”），或者在不成功的 HTTP 响应中是否有政策失败（值为“0”）。对于成功的 HTTP 响应，该值为 null。
以下相关变量提供了首次失败的政策的详细信息。如果没有政策失败，则值为 null。- apigee.edge.execution.fault_policy_name - 失败的政策的名称。
- apigee.edge.execution.fault_flow_name - 发生故障的政策所在的流程的名称（例如 PreFlow、PostFlow 或用户定义的流程）。
- apigee.edge.execution.fault_flow_state - 政策在流程中的附加位置。可能的值：PROXY_REQ_FLOW、TARGET_REQ_FLOW、TARGET_RESP_FLOW、PROXY_RESP_FLOW。
信息中心
- API、开发者、产品和开发者应用的性能图表已移至其他位置。以前，这些链接会显示在相应实体的主要页面底部。现在，您只需选择每个页面顶部的数据分析标签页，即可访问图表。
- 此版本对以下现有信息中心或新信息中心进行了重大改进：
- Apigee 信息中心（修订版）：包含三个指标图表：代理流量、开发者互动和开发者应用。每个图表都提供“更多详情”视图，可让您深入了解每个指标。请参阅 Apigee 信息中心。
- 代理性能（新）：显示 API 代理流量模式和处理时间。取代了“API 代理性能”信息中心。请参阅 API 代理性能。
- 流量构成（已修订）：信息中心的外观、风格和内容已完全修订。衡量主要 API、应用、开发者和产品对整体 API 项目的相对贡献。请参阅流量构成。
- 错误分析（修订版）：外观和内容完全修订。显示 API 代理和目标的错误率。请参阅错误代码分析信息中心。
-
以下现有信息中心已重命名：
开发者服务
以下是 Edge 开发者服务中的新功能和增强功能。
SmartDocs 的 Swagger 2.0 支持
SmartDocs 支持导入 Swagger 2.0 规范文档，并保持与 Swagger 1.2 的向后兼容性。我们将在后续版本中支持安全方案对象和集中式架构。
创收
以下是 Edge 创收功能中的新功能和增强功能。另请参阅“已知问题”部分，详细了解创收。
公司和开发者的处理方式有所不同
现在，公司和开发者是分开处理的，这样一来，您就可以更灵活地向开发者添加多个公司，以及向公司添加多个开发者。管理界面现在为“公司”和“开发者”（可通过“发布”菜单访问）提供单独的窗口。
请参阅管理公司和开发者。
在创收报告中，公司仍然是主要过滤条件，不过过滤条件标签已从“开发者”更改为“公司”。
已修复 Bug
此版本中修复了以下 bug。
| 问题 ID | 说明 |
|---|---|
| OPDK-954 | 4.15.01 Cassandra 架构未升级 |
| MGMT-1986 | 添加开发者时出现界面错误 |
| MGMT-1983 | 获取 OAuth 2.0 授权代码 API 返回错误状态 |
| MGMT-1962 | 使用强密码登录管理界面时出错 使用某些特殊字符（例如百分号）登录界面时，不再会失败。 |
| MGMT-1894 | “开发者应用”页面始终未能完成加载（针对“开发者”列） |
| MGMT-1872 | 无法下载自定义报告 |
| MGMT-1777 | 无法添加电子邮件地址的顶级网域为 .acn 的用户 |
| MGMT-1362 | 如果电子邮件地址包含“_”，则“忘记密码”电子邮件无法正常运作 修复了专用云中包含下划线的电子邮件地址的密码重置问题。 |
| CORERT-613 | 因“unrecognized_name”导致的 SSL 握手失败 |
| APIRT-1346 | OAuth2.0 - 如果 hash.oauth.tokens.enabled 为 true，则在访问令牌响应中返回哈希值 |
此版本还包含以下版本中的 bug 修复：
| Edge Cloud | Edge for Private Cloud |
|---|---|
已知问题
此版本存在以下已知问题。
| 问题 ID | 说明 |
|---|---|
| 不适用 |
安装程序在创收安装或升级过程中使用的两个 Cassandra 脚本未包含在版本中。 为解决此问题，请在 Cassandra 安装或升级后运行以下命令，以完成创收安装/升级：
|
| CORERT-318 | 具有大型载荷（数百 KB）的 API 调用有时可能会挂起。如需解决此问题，请在 router.properties 文件中设置以下属性值：HTTPServer.streaming.buffer.limit=0（默认设置为 10） |