19.03.01 - Apigee Edge 公有雲版本資訊

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件
資訊

2019 年 12 月 3 日星期二,我們開始為 公有雲(原版日期為 2019 年 4 月 18 日星期四)。

新功能與最新資訊

以下是這個版本的新功能和更新內容。

問題 ID 元件名稱 說明
Apigee 已於 2019 年 10 月 1 日開始發布下列更新
110995050 API 執行階段

負載平衡 - 更能掌控移除失敗的伺服器

設定 負載平衡器,就能決定 失敗情形發生。回應失敗 表示 Apigee 不會收到目標伺服器的任何回應。發生這種情況時 的值會遞增 1。當 Apigee 收到目標的回應時,即使 回應為 HTTP 錯誤 (例如 500),可視為目標伺服器的回應 並重設失敗計數器為了確保 HTTP 回應 (例如 500) 無效 遞增計算失敗,以便將健康狀態不良的伺服器從負載平衡輪替作業中排除 您可盡快新增 <ServerUnhealthyResponse> 元素 並將 <ResponseCode> 子元素新增至負載平衡器設定 Edge 也會將這些代碼的回應計為失敗。

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  
130416715 安全性

強化存取權控管政策

AccessControl 政策決定哪些 IP 位址可以呼叫 API Proxy。 這項政策的新元素可讓 API 開發人員進一步掌控 每個待評估位址。

<IgnoreTrueClientIPHeader>:選填 (預設為 false)。 如果設為 True,這項政策會忽略 True-Client-IP 標頭和 會評估 X-Forwarded-For 標頭中的 IP 位址, 您已設定的「X-Forwarded-評估行為」

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
Apigee 已於 2019 年 4 月 18 日發布下列更新
117558815、
119856499、
110548137、
79526748、
72989449、
70712859、
69049041
API 執行階段 JWS 和 JWT
我們針對 JWS 支援功能新增政策,並強化現有的 JWT 政策。

詳情請參閱 這篇社群貼文

122610025 API 執行階段 允許 PromoteFault 一併設定錯誤原因和 AssignMessage 中的任意變數

LiftFault 政策有兩項新元素,可將 FaultRules 設為 更簡潔、更強大

  • ShortFaultReason 是一個布林值,設為 true 時,政策名稱就會放入 fault.reason 變數中。
  • FaultResponse 中的 AssignVariable 可讓您指派錯誤回應給某個變數,在 API Proxy 流程中,其他政策會使用該變數。
西元 121149811 年 代管目標 代管目標強制執行的限制

系統目前已針對代管目標強制執行限制。如要進一步瞭解限制,請參閱限制一節。

117659213 API 執行階段 在 AccessControl 政策中將 IP 範圍參數化

您現在可以使用訊息範本變數,設定 IP 位址和 CIDR 遮罩 AccessControl 政策。舉例來說,如果您想要儲存 鍵/值對應 (KVM) 中的 IP 位址和遮罩,可從您設定的變數擷取這些值 執行這些指令這樣一來,您就能在執行階段輕鬆變更 IP 值,不必特地完成變更。 變更您的政策設定。

例如,您不應使用下列指令:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

假設值儲存在 KVM 中,您可以像這樣設定政策: 而且您使用 KeyValueMapOperations 政策來擷取值並將其指派給 如下所示:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     
113599885 人 API 監控 API Monitoring 角色

API Monitoring 提供兩個角色:API Monitoring 管理員和 API Monitoring 使用者,詳情請參閱存取 API 監控功能。這些功能已於 2018 年 12 月推出。

132256772 API 執行階段 在要求中加入 X-Apigee.Message-Timeout 標頭

Edge 現在會為每個要求新增 X-Apigee.Message-Timeout 標頭。這個標題 僅供 Edge 內部使用請勿仰賴 API Proxy 中 X-Apigee.* 標頭的值 這些標頭並非供客戶使用,且能隨時由 Apigee 移除或變更。

78575018 私有雲 / OPDK 有多個閘道 Pod 時,略過管理伺服器,略過閘道資料儲存庫登錄作業

修正錯誤

這個版本修正了下列錯誤。這份清單的主要適用對象,是想確認支援單是否已修正的使用者。而不是提供所有使用者的詳細資訊。

問題 ID 元件名稱 說明
Apigee 已於 2019 年 12 月 3 日發布下列修正程式
安全性修正。
Apigee 已於 2019 年 10 月 29 日發布下列修正項目
139381794 管理伺服器

處理 KeyStore 刪除錯誤,以免 API 呼叫失敗

Apigee 已於 2019 年 10 月 1 日發布下列修正項目
140761319 API 執行階段

x-apigee.edge.execution.sense.action 一律設為空值

139091614 API 執行階段

在 ResponseCache 政策中,NIOTheread 會在未拒絕 執行緒集區

131331305 核心服務

Apigee 路由器中的多個記錄檔匯出工具造成 CPU 用量偏高

136690640 API 執行階段

特定機構的間歇性 404 錯誤

140948100 API 執行階段

已部署的共用流程無法在某些訊息處理器上執行

Apigee 已於 2019 年 9 月 13 日發布下列修正內容
132654321 管理伺服器 稽核記錄未顯示資料
131246911 管理伺服器 針對開發人員入口網站中的電子郵件地址,可以支援 *.games、*.asia 等較新的網域
Apigee 已於 2019 年 4 月 18 日發布下列修正內容
123844598 人 管理伺服器 應用程式金鑰刪除後,必須超過 24 小時才能重新匯入
123588156 API 執行階段 從回應中移除 Content-Length 標頭會失敗,並顯示 304
122732400 API 執行階段 設定 api.timeout 覆寫 io.timeout.millis
122545281 API 執行階段 JSON 適用的 DebugSession 資料遮罩應將 jsonPayload 視為陣列的情況
122355807 管理伺服器 使用者擁有多個角色時的權限行為不正確
121393556 API 執行階段 x_apigee_fault_code 已設為「org/codehaus/jackson/map/ObjectMapper」
120998548 年 Edge UI 錯誤訊息中的錯字:憑證無效或無法受信任
120990929 年 API 執行階段 Nginx/Apigee-Router 的 HTTP-413 回應會顯示伺服器類型
120799489 人 API 執行階段 搭配非同步 JavaScript 回呼 httpComplete() 使用 httpClient 時,偵錯工作階段 (追蹤) 輸出內容會遭到靜音
120794339 人 API 執行階段 為機構省下的管理人員
120277011 年 管理伺服器 需要輸入驗證:如果目標伺服器主機名稱含有 **,就無法部署 Proxy
119976417 年 API 監控 API 監控功能顯示 Proxy 回應時間較長,數據分析則顯示較高的目標回應時間
119947481 年 API 執行階段 在例外狀況下,要遮蓋的酬載會記錄為純文字
西元 119877164 年 私有雲 / OPDK 路由器產生錯誤,訊息處理器在啟用 TLS 的情況下離線

這項修正項目將包含在下一個 Private Cloud 版本的 Edge 中。

119816218 年 API 執行階段 如果 Expiration 標頭解析為 0 或負數,回應快取會忽略 Expiration 標頭
119770242 年 API 執行階段 路由器與 MP 通訊失敗,導致完全停機時間:PostClientFlow 中的錯誤會導致無限迴圈
119443145 年 管理伺服器 重新命名並重新部署 ProxyEndpoint 時,API Proxy 會傳回 404
119260281 年 API 執行階段 「無法剖析為 string3000.0」記錄錯誤
118743407 管理伺服器 Apigee Proxy 部署持續時間
118447966 API 執行階段 MP 版本 180608_07 下的 JavaScript 呼叫錯誤
117549719 人 API 執行階段 要求 URI 與 Proxy 基本路徑不相符
117219520 年 API 執行階段 MessageLogging:Syslog 記錄器預設使用不正確的日期格式,導致顯示不正確的毫秒數
117116435 API 執行階段 JavaScript 檔案間歇性錯誤
117091520 API 執行階段 訊息處理器版本 18.06.08 後,Java 呼叫會失敗
116165318 API 執行階段 同一個套件的同時部署會導致 RepositoryException
116055025 Configstore 服務 訊息處理器在開機後缺少虛擬主機和應用程式
西元 115614498 年 API 執行階段 需要 OPDK 的 ILB 支援

這項修正項目將包含在下一個 Private Cloud 版本的 Edge 中。

西元 113972537 年 API 執行階段 多個 P1 - Trireme Proxy 中的 Node.js 程式碼引發的 NullPointerException - 500 內部伺服器錯誤
113904969 人 Apigee 支援 示範機構中的 API Proxy 刪除問題
113554802 人 API 執行階段 驗證 SAML 宣告失敗,並顯示 NullPointerException
113315737 管理伺服器 Zookeeper 中缺少部署記錄,因此 Proxy 部署失敗
112767195 人 API 執行階段 存取 KVM 政策時間歇性 DataStore 錯誤
西元 112162179 年 API 執行階段 如果在不使用字串的情況下快取 JavaScript 物件,可能會造成死結
111860576 API 執行階段 配額政策中缺少錯誤
111671525 代管目標 如果代管目標未成功回應代碼,會觸發 Proxy 中造成錯誤流程
西元 111523933 年 擴充功能(連接器) 額外資訊摘要政策快取問題
111420263 年 API 執行階段 MessageLogging 中的 ConcurrentModification 例外狀況
110843526 管理伺服器 用於建立/更新流程掛鉤的 Management API 應驗證共用流程
110805739 人 API 執行階段 如果 Reuserefreshtoken 為 true,且更新權杖到期時間並未明確設定,則在 CPS 流程中未將存留時間設為 -1
110429629 人 API 執行階段 BasicAuthentication 政策將 request.headers.Authorization 變數發出至 DebugSession
110425503 API 執行階段 Nginx 重新載入作業導致 MP 可用性問題
110311540 人 API 執行階段 MP 關閉時 NPE
110161455 API 執行階段 AccessEntity 應使用依應用程式名稱的擷取方式,而不是為 CPS 機構擷取所有應用程式
90695522 API 執行階段 context.proxyRequest.asForm 會產生 java.lang.ArrayIndexOutOfBoundsException:1
79734096 管理伺服器 Proxy 的稽核記錄不再篩選 Proxy
78105568 管理伺服器 更新已部署的共用流程後,共用流程部署不會顯示在 /org/{org}/sharedflows/{sharedflow}/deployments Management API 呼叫中
77528868 特里梅 Trireme 迴歸:指令碼 server.js 結束,傳回狀態碼 -1:找不到屬性 0
73766568 API 執行階段 將 170213_02 升級至 171117_01 後,搭配 Trireme/Node 目標的 Proxy 延遲時間大幅增加
72710481 API 執行階段 CacheServiceImpl/CacheMemoryLimiter NullPointerException
68861063 API 執行階段 在路由器關閉時處理 NPE
68833699 API 執行階段 API Proxy 有時不會從 API 分類樹狀結構中移除
67377575 代管目標 數據分析記錄與透過 Node.js Proxy 傳送給客戶的資訊不相符
112481174 人 代管目標 請勿因 Turbo 錯誤而取消部署 Proxy
117171470 人 代管目標 修正無效的 app.yaml 錯誤訊息
67169139 API 執行階段 MessageLogging 政策的系統記錄檔時間戳記格式不正確
67165418 API 執行階段 如果使用的裝置數量未達授權標準,卻顯示更多訊息處理工具的授權錯誤

這項修正項目將包含在下一個 Private Cloud 版本的 Edge 中。

67165195 API 執行階段 AuthSAMLAssertion 不會驗證已簽署回應中內嵌的斷言簽章
66214414 API 執行階段 currentstep.flowstate 變數一律會傳回「SHARED_FLOW」當從共用流程參照時
65731656 API 執行階段 針對同一項要求,Threat Protection API 出現間歇失敗
133197060 API 執行階段 從 MP 到目標的 57 閘道逾時
110535186 人 API 執行階段 不含 Response 元素和 HTTPTargetConnection 的 Service 摘要 Proxy:SOMETIMES 沒有通話
132443137 API 執行階段 變更郵件處理器行為,忽略開頭為以下開頭的標頭 X-Apigee-*。因此,您必須重構任何使用 X-Apigee-* 標頭,並替換為支援的標頭。
125709964 人 API 執行階段 在無法按照預期的情況下使用 purgeChildEntries 撤銷快取