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

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

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

• 消息处理器：2020 年 5 月 1 日，星期五
• API 管理：2020 年 4 月 20 日，星期一
• 创收管理：2020 年 4 月 20 日（星期一）
• API 管理补丁版本：2020 年 6 月 22 日（星期一）
• 创收管理补丁版本：2020 年 7 月 6 日（星期一）
• 管理服务器安全更新：2020 年 8 月 24 日（星期一）
• 包含 bug 修复的消息处理器补丁版本：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)

消息模板函数

以下用户是新的<ph type="x-smartling-placeholder"></ph> 消息模板函数：

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

AssignMessage 政策：AssignVariable 可让您引用消息模板

在 AssignMessage 政策中， <AssignVariable> / <Template> 元素允许 ref 属性，让您可以在运行时注入 而无需修改政策(118396082)

多个证书别名

当 配置 TLS 并在密钥库中使用多个证书，每个证书都有一个 不同别名，Edge 可让您引用特定证书别名， <SSLInfo><KeyAlias> 配置。为了实现这一更新后的行为 设置新的 HTTPClient.choose.alias.by.keyalias 属性 设置为 true。面向公有云用户的 Edge 必须联系 支持添加此属性。(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 从默认 Apigee 返回 HTTP 200 响应和空白 HTML 文档 与该 IP 地址关联的虚拟主机为了避免错误展示 此类响应可能表明存在可被利用的潜在漏洞， 连接会被丢弃，并且不会返回任何响应。(140005396)

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

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

MessageLogging 政策：Syslog 消息

在 MessageLogging 政策中，新增了 <Syslog> / <PayloadOnly> 个元素 （布尔值）指定是否自动将任何内容 您定义的 <Message>。如果您将 <PayloadOnly> 设为 true，系统不会向 消息定义（不考虑 <FormatMessage> 设置）。如果设置为 false（默认值）， <FormatMessage>设置决定了前置内容 。(68722102)

缓存政策到期时间

在<TimeoutInSeconds> ResponseCache 政策和 PopulateCache 政策 行为方式与现有的 <TimeoutInSecs> 元素相同 的预期用途。请使用新元素。 已废弃的 <TimeoutInSecs> 元素仍存在，以实现向后兼容性。如果 <TimeoutInSecs>和<TimeoutInSeconds> 元素，则 Edge 使用 <TimeoutInSeconds>。(119172893)

virtualhost.aliases.values 流变量

新的只读 virtualhost.aliases.values 消息流 变量返回 JSON 格式的数组，其中包含分配给 调用的虚拟主机。(128453178)

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

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

例如：

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

为 virtualhost 别名值添加了新流变量

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

已修复 Bug

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