19.03.01 - Apigee Edge 公有雲版本資訊

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

2019 年 12 月 3 日星期二,我們開始對這個版本的 Apigee Edge 公開雲端發布更新。(原始發布日期為 2019 年 4 月 18 日星期四)。

新功能與最新資訊

這個版本提供的新功能和更新內容。

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

負載平衡:進一步控管移除失敗的伺服器

為 API Proxy 設定 負載平衡器時,您可以決定伺服器從負載平衡輪替中移除之前發生的回應失敗次數。回應失敗代表 Apigee 不會接收來自目標伺服器的任何回應。在這種情況下,失敗計數器會按 1 遞增。當 Apigee 收到來自目標的回應時,即使回應為 HTTP 錯誤 (例如 500),也會計為來自目標伺服器的回應,並重設失敗計數器。為了協助確保錯誤的 HTTP 回應 (例如 500) 也會遞增失敗計數器,盡快將健康狀態不良的伺服器從負載平衡輪替中排除,您可以在負載平衡器設定中新增包含 <ResponseCode> 子元素的 <ServerUnhealthyResponse> 元素。此外,邊緣也會將這些代碼視為失敗的回應。


<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 政策

AccessControl 政策可決定哪些 IP 位址能呼叫 API Proxy。 該政策的新元素可讓 API 開發人員進一步控管要評估的 IP 位址。

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


<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 執行階段 允許 riseFault 一併設定錯誤原因和任意變數 (如 AssignMessage)

GrowFault 政策提供兩個新元素,讓 FaultRules 更加簡潔、更強大。

  • ShortFaultReason 是一個布林值,如果設為 true,系統就會將政策名稱加入錯符號變數中。
  • FaultResponse 中的 AssignVariable 可讓您為變數指派錯誤回應,供 API Proxy 流程中的其他政策使用。
121149811 代管目標 代管目標的強制執行限制

系統目前已對代管目標強制執行限制。詳情請參閱「限制」一節。

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

您現在可以使用訊息範本變數,針對 AccessControl 政策設定 IP 位址和 CIDR 遮罩。例如,若您想將 IP 位址和遮罩儲存在鍵/值對應 (KVM) 中,可以從您在 API Proxy 流程中設定的變數擷取這些值。如此一來,您不必變更政策設定,就能在執行階段更輕鬆地變更 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 監控管理員和 API 監控使用者,如存取 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 Core Services

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 執行階段 Setting api.timeout overrides 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 執行階段 將 httpClient 與非同步 JavaScript 回呼 httpComplete() 搭配使用時,系統會忽略 debugsession (trace) 輸出內容
120794339 API 執行階段 機構組織的簡化的 MP
120277011 管理伺服器 需要輸入驗證:如果目標伺服器主機名稱含有 **,就無法部署 Proxy
119976417 API 監控 API Monitoring 顯示的 Proxy 回應時間偏高,數據分析顯示的目標回應時間偏高
119947481 API 執行階段 在例外狀況下,系統會將要遮蓋的酬載以純文字記錄
119877164 私有雲 / OPDK 路由器產生錯誤,訊息處理器在啟用 TLS 的情況下無法離線

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

119816218 API 執行階段 如果回應快取可解析為 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 Calls 會失敗
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 執行階段 VerifySAMLAssertion 不會針對嵌入已簽署回應中的宣告驗證簽名
66214414 API 執行階段 從共用流程參照時,Currentstep.flowstate 變數一律會傳回「SHARED_FLOW」
65731656 API 執行階段 同一要求中的威脅防護 API 間歇性失敗
133197060 API 執行階段 從 MP 到目標的 57 閘道逾時
110535186 API 執行階段 沒有 Response 元素的 Service 呼叫,以及指向 Proxy 的 HTTPTargetConnection:SOMETIMES 沒有呼叫
132443137 API 執行階段 變更訊息處理器行為,以忽略開頭為 X-Apigee-* 的標頭。因此,您必須重構所有使用 X-Apigee-* 標頭的程式碼,並以支援的標頭取代這些標頭。
125709964 API 執行階段 使用 purgeChildEntries 以正常方式停用快取