20.04.06 - 适用于公有云的 Apigee Edge 版本说明

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

我们于以下日期开始向 Apigee Edge 公有云发布组件更新：

• 消息处理器：2020 年 5 月 1 日，星期五
• API 管理：2020 年 4 月 20 日（星期一）
• 创收管理：2020 年 4 月 20 日，星期一
• API 管理补丁版本发布：2020 年 6 月 22 日（周一）
• Monetization Management 补丁版本发布：2020 年 7 月 6 日（星期一）
• 管理服务器安全更新：2020 年 8 月 24 日（星期一）
• 发布了包含问题修复的消息处理器补丁：2020 年 9 月 24 日（星期四）
• 发布了包含 bug 修复的消息处理器补丁：2020 年 10 月 26 日（星期一）
• 发布了包含 bug 修复的消息处理器补丁：2021 年 2 月 1 日（星期一）

新功能和更新

以下是此版本中的新功能和更新：

JWT 政策

• JWT 加密

  借助 JWT 政策，您可以生成、验证和解码加密令牌。政策中的新元素包括：

  • <Type> - 用于设置令牌是否已签名或加密。
  • <EncryptionAlgorithms> - 可用于设置 <Key> 和 <Content> 加密算法。

  (67165581)

• 支持签名令牌中的 PSS 算法

  用于生成和验证 JWT 和 JWS 的政策现在支持 PS256、PS384 和 PS512 算法，如 IETF RFC 7518 中所述。 (119856499)

• 令牌的 GenerateJWT 相对开始时间

  使用 GenerateJWT 政策生成 JWT 时，您可以使用 <NotBefore> 元素指定令牌生成时间和生效时间之间的相对时间。例如，<NotBefore> 值为 2h 表示令牌在生成 2 小时后才有效。您可以将 <NotBefore> 时间设置为毫秒 (ms)、秒 (s)、分钟 (m)、小时 (h)、天 (d) 或周 (w)。 (126261970)

• 在 VerifyJWT 中引用 PublicKey/Certificate

  在 VerifyJWT 政策中，<PublicKey> / <Certificate> 元素可让您引用 PEM 格式的证书，以验证传入的 JWT 签名。例如：

  <PublicKey>
    <Certificate ref='public.certificate_pem'/>
  </PublicKey>

  (132918033)

消息模板函数

以下是此版本中新增的 消息模板函数：

• firstnonull - 返回第一个（最左侧）非 null 实参的值。 (139698514)
• xpath - 可让您应用 XML 路径 (XPath) 表达式来解析 XML 变量。 (123246424)

AssignMessage 政策：AssignVariable 允许您引用消息模板

在 AssignMessage 政策中，<AssignVariable> / <Template> 元素允许使用 ref 属性，让您可以在运行时注入预定义的模板，该模板可以更改，而无需修改政策。(118396082)

多个证书别名

在 配置 TLS 并在密钥库中使用多个证书（每个证书都有不同的别名）时，Edge 可让您在 <SSLInfo><KeyAlias> 配置中引用特定的证书别名。如需启用此更新后的行为，请在消息处理器的 http.properties 文件中将新的 HTTPClient.choose.alias.by.keyalias 属性设置为 true。Edge for Public Cloud 用户必须与 支持团队联系才能添加此属性。(142141620)

JSONtoXML 政策：省略 XML 声明，缩进输出

JSONtoXML 政策中的两个新的布尔值选项可让您更好地控制 XML 输出。

• <Options> <OmitXmlDeclaration> - 如果设置为 true（默认值为 false），则 <OmitXmlDeclaration> 元素会省略政策生成的默认 <?xml version="1.0" encoding="UTF-8"?> XML 声明。

• <Options> <Indent> - 如果设置为 true（默认值为 false），<Indent> 元素会缩进 XML 输出。 例如，不应输出以下内容：

  <Array><n>1</n><n>2</n><n>3</n></Array>

  Indent 元素会生成以下内容：

  <Array>
   <n>1</n>
   <n>2</n>
   <n>3</n>
  </Array>

(65142394)

虚拟主机扫描的响应

如果向 Apigee 端点的 IP 地址（未指定虚拟主机）发出请求，Edge 会返回 HTTP 200 响应以及与该 IP 地址关联的默认 Apigee 虚拟主机中的空白 HTML 文档。为避免此类响应可能代表潜在的可利用漏洞而造成错误印象，系统会断开连接，并且不返回任何响应。(140005396)

Trace 中的目标服务器属性，有助于问题排查

以下新的跟踪属性可显示目标服务器的 HTTPClient 是否已缓存，从而帮助排查目标连接问题：isHttpClientCached 和 isFromClientPool。(140574604)

MessageLogging 政策：Syslog 消息

在 MessageLogging 政策中，新增了 <Syslog> / <PayloadOnly> 元素（布尔值），可用于确定是否自动将任何内容预添加到您定义的 <Message> 中。如果您将 <PayloadOnly> 设置为 true，则不会在消息定义中添加任何前缀（无论 <FormatMessage> 设置如何）。如果设置为 false（默认），则 <FormatMessage> 设置会决定在日志消息前附加什么内容。(68722102)

缓存政策到期

ResponseCache 政策和 PopulateCache 政策中新增的 <TimeoutInSeconds> 过期元素的行为方式与现有 <TimeoutInSecs> 元素最初的预期行为方式相同。请使用新元素。 已废弃的 <TimeoutInSecs> 元素仍然存在，以实现向后兼容性。如果同时配置了 <TimeoutInSecs> 和 <TimeoutInSeconds> 元素，Edge 会使用 <TimeoutInSeconds>。(119172893)

virtualhost.aliases.values 流变量

新的只读 virtualhost.aliases.values 消息流变量会返回一个 JSON 格式的数组，其中包含分配给入站请求所调用的虚拟主机的所有别名。(128453178)

用于确保代理修订版本删除的新参数

为 delete API 代理修订版本 新增了 force 查询参数。如果修订版本列在 List API Proxies API 中，但实际上无法查询，此参数可确保删除代理修订版本。(111691721)

例如：

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

虚拟主机别名值的新流变量

新的只读 virtualhost.aliases.values 消息流变量会返回一个 JSON 格式的数组，其中包含分配给入站请求所调用的虚拟主机的所有别名。(128453178)

已修复 Bug

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