4.17.09 - Edge for Private Cloud 版本说明

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

自上一个 Edge for Private Cloud 功能版本以来，此功能版本中已经推出以下版本：

请参阅关于版本编号，了解如何确定您的适用于私有云的 Edge 版本是否包含特定云版本。

版本概览

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

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

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

如需了解详情，请参阅在 Edge 上为私有云支持 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 社区文章：https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html。 (EDGEUI-902)

新功能和更新

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

私有云

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

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

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

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

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

请参阅使用 apigee-ssoadminapi.sh。

(DOS-5118)

现在可以将开发者服务门户从 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

适用于 Cloud 的新自助 TLS/SSL 功能的 Beta 版现已在专用云中作为 Beta 版功能提供。借助此 Beta 版，您可以：

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

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

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

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

• 用于配置 TLS 的选项
• 配置对 Cloud API 的 TLS 访问权限
• 配置从边缘到后端的 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。

(TBD-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 服务

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

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

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

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

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

已修复 Bug

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

私有云 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 管理）

已知问题

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