4.17.09 - Edge for Private Cloud 版本说明

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

自上一个 Edge Private Cloud 功能版本以来，已发布以下版本，并且这些版本包含在此功能版本中：

请参阅关于版本编号，了解如何确定您的 Edge for Private Cloud 版本是否包含特定的云版本。

版本概览

此版本中最重要的一个新功能是新增了对安全断言标记语言 (SAML) 2.0 的支持，将其作为 Edge、API BaaS 和 Developer Services 门户的身份验证机制。通过将 SAML 与 Edge 结合使用，可支持将单点登录用于 Edge 界面和 API，以及您提供的任何其他也支持 SAML 的服务。

SAML 身份验证可提供很多优势。您可以使用 SAML 执行以下操作：

• 完全掌控用户管理。如果用户离开您的组织并已在中央位置取消配置，系统会自动拒绝他们访问 Edge。
• 控制用户如何通过身份验证来访问 Edge。您可以为不同的 Edge 组织选择不同的身份验证类型。
• 控制身份验证政策。您的 SAML 提供商可能支持比您的企业标准更严格的身份验证政策。
• 您可以监控 Edge 部署中的登录、退出、失败登录尝试和高风险活动。
• 请注意，SAML 仅用于身份验证。授权仍通过 Edge 用户角色控制。

如需了解详情，请参阅在 Edge Private Cloud 上支持 SAML。

此版本还包含许多其他值得注意的功能，包括：

• 能够将开发者服务门户从 Apache/MySQL 迁移到 Postgres/Nginx
• 用于在 Edge 界面中停用 TLS 的命令
• 用于配置 Edge 安装的新属性
• 自定义使用方密钥和密文命名规则
• 支持 Red Hat/CentOS 版本 7.4

本主题的其余部分详细介绍了相应版本中包含的所有新功能、更新和 bug 修复。

弃用和停用

此版本中弃用或停用了以下功能。如需了解详情，请参阅 Edge 弃用政策。

弃用

Apigee 安全存储区（保险箱）已弃用

Apigee 安全存储区（也称为“保险库”）即将弃用，并将在 2018 年 4 月停用。 保险库使用 Management API 创建，可在运行时通过 apigee-access Node.js 模块中的函数进行访问，用于以加密方式存储键值对。

请勿使用安全存储区，而应使用加密的键值对映射 (KVM)，如使用键值对映射中所述。 加密的 KVM 与保险库一样安全，并且在创建和检索方面提供了更多选项。(MGMT-3848)

弃用在“API 代理性能”标签页上添加路径的功能

在此版本发布之前，您可以在管理界面中前往某个 API 代理，然后前往“性能”标签页，并在该代理的“性能”标签页和“业务交易”信息中心内创建不同的路径，以便进行基于图表的比较。此功能现已停用，不再在界面中提供。如需了解此功能的替代方案，请参阅以下 Apigee 社区文章：Business Transactions API 的替代方案。 (EDGEUI-902)

新功能和更新

以下是此版本中的新功能和增强功能。除了以下增强功能之外，此版本还包含多项可用性、性能、安全性和稳定性增强功能。

私有云

为 Edge、API BaaS 和开发者服务门户添加了 SAML 支持

Edge 现在支持使用安全断言标记语言 (SAML) 2.0 作为 Edge、API BaaS 和开发者服务门户的身份验证机制。SAML 支持单点登录 (SSO) 环境。通过使用 SAML，除了您提供的任何其他支持 SAML 的服务之外，您还可以支持 Edge 的单点登录。

请参阅在 Edge for Private Cloud 上支持 SAML。

添加了 apigee-ssoadminapi.sh 实用程序

启用 SAML 后，您现在可以使用新的 apigee-ssoadminapi.sh 执行许多管理任务，例如创建用户和组织。

请参阅使用 apigee-ssoadminapi.sh。

(DOS-5118)

现在可以将 Developer Services 门户从 Apache/MySQL/MariaDB 迁移到 Nginx/postgres

基于 .tar 的开发者服务门户安装使用 Apache 和 MySQL 或 MariaDB。 您现在可以迁移现有门户安装，以使用 Nginx 和 Postgres。如果您想更新到门户网站版本 4.17.09，则必须进行此迁移。

请参阅将基于 TAR 的门户转换为基于 RPM 的门户。

添加了对 Red Hat/CentOS 版本 7.4 的支持

您现在可以在 Red Hat/CentOS 版本 7.4 上部署 Edge for Private Cloud、API BaaS 和开发者服务门户。

请参阅支持的软件和支持的版本。

添加了在安装期间导致安装程序检查 CPU 和内存要求的属性

Edge 安装配置文件现在支持以下属性：

ENABLE_SYSTEM_CHECK=y 

如果为“y”，安装程序会检查系统是否满足所安装组件的 CPU 和内存要求。如需了解每个组件的要求，请参阅安装要求。默认值为“n”，表示停用检查。

请参阅 Edge 配置文件参考。

(DOS-4772)

添加了属性，以便您选择安装程序在具有多个接口卡的服务器上使用的 IP 地址

如果服务器有多个接口卡，“hostname -i”命令会返回以空格分隔的 IP 地址列表。默认情况下，Edge 安装程序会使用返回的第一个 IP 地址，但在某些情况下，该地址可能不正确。或者，您也可以在安装配置文件中设置以下属性：

ENABLE_DYNAMIC_HOSTIP=y

如果该属性设置为“y”，安装程序会提示您选择要用作安装一部分的 IP 地址。默认值为“n”。

请参阅 Edge 配置文件参考。

(DOS-5117)

用于配置 TLS 的新界面选项和 API

面向云的全新自助式 TLS/SSL 功能的 Beta 版现已在私有云中作为 Beta 版功能提供。使用此 Beta 版，您可以：

• 在界面和 API 中创建、修改和删除密钥库和信任库
• 以 PKCS12/PFX 格式上传 TLS 证书
• 通过界面或 API 生成自签名证书
• 在界面中测试密钥库或信任库的有效性

如需查看这些功能的 Beta 版文档 (PDF)，请访问以下网址：

• 使用 Edge Cloud 界面创建密钥库和信任库
• 使用 Edge API 创建密钥库和信任库

如需了解完整详情，请参阅其他文档 (PDF)：

• 用于配置 TLS 的选项
• 为 Cloud 配置对 API 的 TLS 访问权限
• 配置从 Edge 到后端的 TLS
• 更新 Cloud 的 TLS 证书

(EDGEUI-1058)

添加了模糊处理的密码命令

添加了用于生成混淆密码的命令，以便任何组件都可以生成加密密码。您可以在 Edge 管理服务器上使用以下命令生成混淆密码：

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

输入新密码，然后按照提示确认新密码。出于安全原因，密码文本不会显示。此命令会以如下形式返回密码：

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

请参阅为 Edge On Premises 配置 TLS/SSL。

（待定 - 250）

添加了新命令，用于在更改组织用户的密码时混淆新密码

如需重置组织用户的密码，您现在可以使用 apigee-service 实用程序来调用 apigee-openldap：

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

系统会提示您输入系统管理员的密码，然后提示您输入新用户的密码。出于安全考虑，系统不会在您输入密码时显示密码文本。

请参阅重置 Edge 密码。

(DBS-1733)

添加了在 Edge 界面中停用 TLS 的命令

您现在可以使用以下命令在 Edge 界面中停用 TLS：

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

请参阅为管理界面配置 TLS。

(EDGEUI-1114)

添加了用于控制日志消息中时间戳格式的属性

默认情况下，由消息日志记录政策创建的日志消息中的时间戳采用以下格式：

yyyy-MM-dd'T'HH:mm:ss.sssZ

例如：

2017-05-08T13:33:00.000+0000

您可以使用 Edge 消息处理器的 conf_system_apigee.syslogger.dateFormat 属性来控制该格式。

请参阅消息日志记录政策。

(APIRT-4196)

为 API BaaS 安装添加了新的必需 SMTP 配置参数

您现在必须在 API BaaS 安装配置文件中使用 SMTPMAILFROM 参数。此参数用于指定 API BaaS 发送自动电子邮件时使用的电子邮件地址，例如在用户请求重置密码时。

请参阅 BaaS 配置文件参考。

(APIBAAS-2103)

添加了支持，允许门户的边缘路由器和 Nginx Web 服务器访问 1000 以下的端口

您现在可以使用路由器和 Nginx Web 服务器来访问 1000 以下的端口，而无需以其他用户身份运行它们。在之前的版本中，路由器和 Nginx Web 服务器无法访问 1000 以下的端口，除非以特殊用户身份运行它们。

更改了 Edge 界面日志记录级别的配置方式

用于配置 Edge 界面日志记录级别的属性已发生变化。如需了解新属性和新程序，请参阅为 Edge 组件设置日志级别。

(EDGEUI-886)

API 服务

自定义使用方密钥和密文命名规则

更新了 为开发者应用创建自定义使用方密钥和密文的命名规则和验证。使用方密钥和密文可以包含字母、数字、下划线和连字符。不允许使用其他特殊字符。

如需详细了解自定义密钥/密文创建流程，请参阅导入现有的使用方密钥和密文。(MGMT-3916)

密钥库和目标服务器名称验证

密钥库和目标服务器的名称最多可以包含 255 个字符，并且可以包含字母、数字、空格、连字符、下划线和英文句点。Edge 现在会在创建时验证此内容。 (MGMT-4098)

已修复 Bug

此版本中修复了以下 Bug。此列表主要供用户检查其支持服务工单中的问题是否已修复，并非旨在为所有用户提供详细信息。

Private Cloud 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16（界面）

Cloud 17.08.14（API 管理和运行时）

Cloud 17.07.31（API 管理）

Cloud 17.07.17（API 管理和运行时）

Cloud 17.06.20（界面）

Cloud 17.06.14（界面）

Cloud 17.05.22.01（创收）

Cloud 17.05.22（界面）

Cloud 17.05.22（API 管理）

Cloud 17.05.08（界面）

Cloud 17.04.22（API 管理）

已知问题

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