20.04.06 - Apigee Edge 公有雲版本資訊

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

我們已在下列日期開始發布 Apigee Edge Public Cloud 的元件更新：

• 訊息處理器：2020 年 5 月 1 日星期五
• API 管理：2020 年 4 月 20 日星期一
• 營利管理：2020 年 4 月 20 日星期一
• API 管理修補程式發布：2020 年 6 月 22 日 (星期一)
• 營利管理修補程式版本：2020 年 7 月 6 日星期一
• 管理伺服器安全性更新：2020 年 8 月 24 日 (星期一)
• 訊息處理工具修補程式版本 (修正錯誤)：2020 年 9 月 24 日星期四
• 訊息處理工具修補程式版本，修正錯誤：2020 年 10 月 26 日星期一
• 訊息處理工具修補程式版本，修正錯誤：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 - Returns the value of the first (left-most) non-null argument. (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。Public Cloud 版 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 會傳回 HTTP 200 回應，以及與該 IP 位址相關聯的預設 Apigee 虛擬主機空白 HTML 文件。為避免這類回應可能代表潛在可遭利用的安全漏洞，系統會中斷連線，且不會傳回任何回應。(140005396)

在「追蹤」中查看目標伺服器屬性，協助排解問題

下列新的追蹤屬性會顯示目標伺服器的 HTTPClient 是否已快取，有助於排解目標連線問題：isHttpClientCached 和 isFromClientPool。(140574604)

MessageLogging 政策：系統記錄訊息

在 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)

確保刪除 Proxy 修訂版本的新參數

刪除 API Proxy 修訂版本新增了 force 查詢參數。如果修訂版本列在「列出 API Proxy」API List API Proxies API 中，但實際上無法查詢，這個參數可確保刪除 Proxy 修訂版本。(111691721)

例如：

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

虛擬主機別名值的新流程變數

新的唯讀 virtualhost.aliases.values 訊息流程變數會傳回 JSON 格式的陣列，其中包含指派給在連入要求中呼叫的虛擬主機的所有別名。(128453178)

修正錯誤

這個版本修正了下列錯誤。這份清單主要供使用者查看支援單是否已解決問題。這項功能並非為所有使用者提供詳細資訊而設計。