Apigee 的已知问题

如果在 LookupCache 政策之后使用 cachehit 流变量，由于为异步行为分派调试点的方式，LookupPolicy 会在执行回调之前填充 DebugInfo 对象，从而导致错误。

权宜解决方法：在第一次调用后立即再次重复该过程（进行第二次调用）。

在 InvalidateCache 政策中设置 PurgeChildEntries 应仅完全清除 KeyFragment 元素值，但会清除整个缓存。

权宜解决方法：使用 KeyValueMapOperations 政策迭代缓存版本控制，并避免缓存失效。

• 当您使用规范编辑器创建规范并在门户上使用 SmartDocs 发布 API 时，Apigee Edge 支持 OpenAPI 规范 3.0，但部分功能尚不受支持。

  例如，OpenAPI 规范 3.0 的以下功能不受支持：

  • 用于组合和扩展架构的 allOf 属性
  • 远程引用

  如果 OpenAPI 规范中引用了不受支持的功能，则在某些情况下，工具会忽略该功能，但仍呈现 API 参考文档。在其他情况下，不受支持的功能将导致错误，进而导致 API 参考文档无法成功呈现。无论哪种情况，您都需要修改 OpenAPI 规范，以避免使用不受支持的功能，直到将来的版本支持它为止。

  注意：在呈现 API 参考文档时，规范编辑器比 SmartDocs 的限制更宽松，因此您在不同工具之间可能会获得不同的结果。

• 在门户中使用“试用此 API”时，无论如何设置 OpenAPI 规范中 consumes 的值，Accept 标头都设置为 application/json。

• 目前不支持多用户同时进行门户更新（例如页面、主题背景、CSS 或脚本修改）。
• 如果您从门户中删除 API 参考文档页面，则无法重新创建该页面；您需要删除然后重新添加 API 产品，再重新生成 API 参考文档。
• 配置内容安全政策时，所做更改最长可能需要 15 分钟才能完全应用。
• 自定义门户主题背景时，更改最多可能需要 5 分钟才能完全生效。

• 在未来版本中，将把搜索集成到集成式门户中。

我们最近在 HTTP/2 协议 (CVE-2023-44487) 的多个实现中发现了一个拒绝服务攻击 (DoS) 漏洞，其中包括适用于私有云的 Apigee Edge。此漏洞可能会导致 Apigee API 管理功能的 DoS。 如需了解详情，请参阅 Apigee 安全公告 GCP-2023-032。

用于私有云的边缘路由器和管理服务器组件向互联网公开，可能存在漏洞。虽然在 Edge for Private Cloud 的其他 Edge 专用组件的管理端口上启用了 HTTP/2，但这些组件都不会向互联网公开。在 Cassandra、Zookeeper 等非 Edge 组件上，HTTP/2 处于停用状态。我们建议您采取以下措施来解决私有云边缘漏洞：

• 适用于 Private Cloud 4.51.00.11 或更高版本的 Edge 的步骤
• 适用于 4.51.00.11 之前的 Private Cloud 版本的 Edge 的步骤

如果您使用的是 Edge Private Cloud 4.51.00.11 或更高版本，请按以下步骤操作：

1. 更新管理服务器：

   1. 在每个管理服务器节点上，打开 /opt/apigee/customer/application/management-server.properties
   2. 将下面这行代码添加到属性文件中：

      conf_webserver_http2.enabled=false

   3. 重启管理服务器组件：

      apigee-service edge-management-server restart

2. 更新消息处理器：

   1. 在每个消息处理器节点上，打开 /opt/apigee/customer/application/message-processor.properties
   2. 将下面这行代码添加到属性文件中：

      conf_webserver_http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-message-processor restart

3. 更新路由器：

   1. 在每个路由器节点上，打开 /opt/apigee/customer/application/router.properties
   2. 将下面这行代码添加到属性文件中：

      conf_webserver_http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-router restart

4. 更新 QPID：

   1. 在每个 QPID 节点上，打开 /opt/apigee/customer/application/qpid-server.properties。
   2. 将下面这行代码添加到属性文件中：

      conf_webserver_http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-qpid-server restart

5. 更新 Postgres：

   1. 在每个 Postgres 节点上，打开 /opt/apigee/customer/application/postgres-server.properties
   2. 将下面这行代码添加到属性文件中：

      conf_webserver_http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-postgres-server restart

如果您使用的是适用于 4.51.00.11 之前的 Private Cloud 的 Edge，请按以下步骤操作：

1. 更新管理服务器：

   1. 在每个管理服务器节点上，打开 /opt/apigee/customer/application/management-server.properties
   2. 将以下两行代码添加到属性文件中：

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. 重启管理服务器组件：

      apigee-service edge-management-server restart

2. 更新消息处理器：

   1. 在每个消息处理器节点上，打开 /opt/apigee/customer/application/message-processor.properties
   2. 将以下两行代码添加到属性文件中：

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-message-processor restart

3. 更新路由器：

   1. 在每个路由器节点上，打开 /opt/apigee/customer/application/router.properties
   2. 将以下两行代码添加到属性文件中：

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-router restart

4. 更新 QPID：

   1. 在每个 QPID 节点上，打开 /opt/apigee/customer/application/qpid-server.properties。
   2. 将以下两行代码添加到属性文件中：

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-qpid-server restart

5. 更新 Postgres：

   1. 在每个 Postgres 节点上，打开 /opt/apigee/customer/application/postgres-server.properties
   2. 将以下两行代码添加到属性文件中：

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. 重启消息处理器组件：

      apigee-service edge-postgres-server restart

Apigee-postgresql 从适用于 Private Cloud 的 Edge 4.50 或 4.51 版升级到 4.52 版时遇到问题。此问题主要出现在表的数量超过 500 个时。

您可以通过运行以下 SQL 查询来检查 Postgres 中的表总数：

select count(*) from information_schema.tables

权宜解决方法：在 将 Apigee Edge 4.50.00 或 4.51.00 更新为 4.52.00 时，请务必先执行 初步步骤，然后再升级 Apigee-postgresql。

apigee-mirror 不适用于 Red Hat Enterprise Linux (RHEL) 8.0。

解决方法：如需解决此问题，请在运行较低版本的 RHEL 或其他受支持的操作系统的 Apigee 服务器上安装 apigee-mirror。然后，即使您在 RHEL 8.0 服务器上安装了 Apigee，也可以使用镜像添加软件包。

149245401：不反映通过 LDAP 资源配置的 JNDI 的 LDAP 连接池设置，JNDI 默认设置每次都会导致一次性连接。 因此，对于单次使用，每次都会打开和关闭连接，从而每小时产生大量与 LDAP 服务器的连接。

临时解决方法：

如需更改 LDAP 连接池属性，请按照以下步骤设置针对所有 LDAP 政策的全局更改。

1. 如果还没有配置属性文件，请创建一个：

   /opt/apigee/customer/application/message-processor.properties

2. 将以下内容添加到该文件中（根据您的 LDAP 资源配置要求替换 Java 命名和目录接口 (JNDI) 属性的值）。

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. 确保文件 /opt/apigee/customer/application/message-processor.properties 属于 apigee:apigee。
4. 重启各个消息处理器。

如需验证您的连接池 JNDI 属性是否生效，您可以执行 tcpdump 以观察 LDAP 连接池在一段时间内的行为。

139051927：消息处理器中的代理处理延迟时间过长，正在影响所有 API 代理。症状包括处理时间比正常 API 响应时间晚 200-300 毫秒，即使 TPS 较低也是如此。当消息处理器连接的目标服务器超过 50 个时，可能会发生这种情况。

根本原因：消息处理器会保留一个缓存，用于将目标服务器网址映射到 HTTPClient 对象，以便与目标服务器的传出连接。默认情况下，此设置设置为 50，这对大多数部署来说可能太低了。如果部署在设置中有多个组织/环境组合，并且大量目标服务器的总数量超过 50 个，则目标服务器网址不断从缓存中逐出，从而导致延迟。

验证：如需确定目标服务器网址逐出是否会导致延迟问题，请在 Message Processor system.logs 中搜索关键字“onEvict”或“Eviction”。如果它们出现在日志中，则表明由于缓存大小太小，目标服务器网址已从 HTTPClient 缓存中逐出。

权宜解决方法：对于适用于私有云的 Edge 19.01 和 19.06 版本，您可以修改和配置 HTTPClient 缓存 /opt/apigee/customer/application/message-processor.properties：

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

然后重启消息处理器。对所有消息处理器进行相同的更改。

值 500 就是一个示例。您的设置的最佳值应大于消息处理器将连接的目标服务器的数量。将此属性设置得更高不会产生任何副作用，唯一的影响就是缩短消息处理器代理请求处理时间。

注意：适用于 Private Cloud 版本 50.00 的 Edge 的默认设置是 500。

157933959：如果对范围限定为组织或环境级别的同一键值对映射 (KVM) 进行并发插入和更新，会导致数据不一致和更新丢失。

注意：此限制仅适用于适用于私有云的 Edge。适用于公有云和混合云的边缘没有此限制。

如需在适用于私有云的 Edge 中寻求解决方法，请在 apiproxy 范围创建 KVM。