4.19.06.02 - 用于私有云的 Edge 版本说明

您正在查看 Apigee Edge 文档。
请查看 Apigee X 文档。

2020 年 3 月 10 日，我们推出了适用于私有云的新版 Apigee Edge。

更新过程

如需更新安装，请在 Edge 节点上执行以下操作：

1. 在所有边缘节点上：

   1. 清理 Yum 代码库：

      sudo yum clean all

   2. 将最新的 Edge 4.19.06 bootstrap_4.19.06.sh 文件下载到 /tmp/bootstrap_4.19.06.sh：

      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

   3. 安装 Edge 4.19.06 apigee-service 实用程序和依赖项：

      sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您从 Apigee 收到的用户名和密码。 如果省略 pWord，系统会提示您输入。

   4. 更新 apigee-setup 实用程序：

      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   5. 使用 source 命令执行 apigee-service.sh 脚本：

      source /etc/profile.d/apigee-service.sh

2. 更新 apigee validate 实用程序：

   sudo /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

3. 从 /opt/apigee/apigee-validate/bundles 目录中的 smartdocs.zip 导入新的 SmartDocs 代理，并部署为新修订版本。应将新代理导入目前配置 SmartDocs 的组织。如果需要，将代理部署为新修订版本会使回滚更容易。

   注意：在部署之前，请检查以确保新代理中的 <VirtualHost> 与您的环境中当前设置的 <VirtualHost> 配置一致。如果没有，请在部署之前修改代理。

4. 在 Edge 界面中，创建和更新名为“smartdocs_whitelist”的 KVM，如下图所示。KVM 应在当前部署 SmartDocs 代理的组织和环境中创建。

   注意：请务必不要选中已加密对应的复选框。

   • 添加一个名为“is_whitelist_configure”的键，其中值为“YES”。
   • 添加第二个名为“allowed_hosts”的键，其中的值是以空格分隔的主机名或 IP 地址（从 SmartDocs 调用）。“allowed_hosts”的值应包含添加到 SmartDocs 的 OpenAPI 规范中的所有主机。例如，如果您有调用 mocktarget.apigee.net 的 OpenAPI 规范，则需要将 mocktarget.apigee.net 添加到“allowed_hosts”值。如果主机未包含在 KVM 中，则 SmartDocs 响应将为 400 Bad Request，内容载荷为 Bad Request-Hostname not permitted。
   注意：如果您不添加和配置此 KVM，则代理不会强制执行白名单操作。这可能会导致有人在未经授权的情况下访问您的主机和 IP 地址。只有 SmartDocs 记录的 API 端点的主机名和 IP 地址应包含在“allowed_hosts”值中。

支持的软件

无。

弃用和退休

无。

已修复 Bug

下表列出了此版本中修复的 bug：

问题 ID	说明
145340106	Apigee SmartDocs API 漏洞 更新了 Apigee SmartDocs 代理，解决了安全漏洞。如需了解详情和所需的步骤，请参阅 更新过程。