您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
我们已于 2015 年 5 月 19 日（星期二）发布了适用于私有云的 Apigee Edge 季度版本。
以前的产品名称“Apigee Edge On-premises”或“OPDK”现已更名为“Apigee Edge for Private Cloud”。
如有疑问，请与 Apigee 客户支持团队联系。
如需查看所有 Apigee Edge 版本说明的列表，请参阅 Apigee 版本说明。
新功能和增强功能
以下是此版本中的新功能和增强功能：
OpenLDAP - 安装和升级
现在，OpenLDAP 是 Edge 支持的新安装和升级安装的唯一 LDAP 服务器。
API 服务
以下是 Edge API 服务中的新功能和增强功能。
WebSocket
为了实现网络客户端与服务器之间的实时 Web 通信，Edge 支持 WebSocket 协议。Edge 可以在 WebSocket 通信中充当客户端或服务器。如需了解如何在 Edge 中设置和使用 WebSocket，请参阅 Apigee Edge for Private Cloud Using WebSockets 指南。
针对 API 管理的外部身份验证提供方支持
Edge 可与 Active Directory 以及包含 API 管理员用户的其他外部身份验证提供程序/LDAP 系统集成。如需了解详情，请参阅 Edge for Private Cloud 外部身份验证配置指南。
在管理界面中进行品牌联合
您可以将自己的自定义徽标与 Apigee 徽标一起显示在 Edge 管理界面中。如需了解详情，请参阅 Apigee Edge 私有云运维指南中的“向 Apigee 界面菜单添加自定义徽标”。
轨迹中的 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 私有云运维指南。
限制系统管理员对特定电子邮件网域的访问权限
您可以将系统管理员或系统管理员只读角色的成员资格限制为特定电子邮件网域中的用户。如需启用此功能，请将允许的网域添加到 apigee4/conf/apigee/management-server/security.properties 文件中，如 Apigee Edge for Private Cloud Operations Guide 中所述。
管理界面错误消息
我们重新设计了管理界面中的错误消息显示方式，以更高效地利用屏幕空间。
新的 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 中的新功能和增强功能。
可查看六个月内的数据
使用管理界面或 API 生成分析报告时，默认情况下无法获得从当前日期起 6 个月之前的数据。如果您需要访问 6 个月之前的数据，请与 Apigee 支持团队联系。
添加到分析中的变量
以下新变量会传递给 Edge Analytics，并显示在 API 代理轨迹窗口的 AX 阶段。
- apigee.edge.execution.is_target_error - 用于确定 API 错误是目标端错误（值为“1”）还是非目标端错误（值为“0”）（针对不成功的 HTTP 响应）。对于成功的 HTTP 响应，此值为 null。
-
apigee.edge.execution.is_policy_error - 用于确定 HTTP 响应失败时是否有政策失败（值为“1”）或没有政策失败（值为“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 |
|---|---|
已知问题
此版本存在以下已知问题。
| 问题 ID | 说明 |
|---|---|
| 不适用 |
此版本未包含安装程序在创收安装或升级过程中使用的两个 Cassandra 脚本。 如需解决此问题，请在 Cassandra 安装或升级后运行以下命令，以完成创收功能安装/升级：
|
| CORERT-318 | 载荷较大（100 多 KB）的 API 调用有时可能会挂起。如需解决此问题，请在 router.properties 文件中设置以下属性值：HTTPServer.streaming.buffer.limit=0（默认设置为 10） |