4.18.01 - 私有雲版本資訊

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

自前一項私有雲功能版本以來，下列版本已推出，內容也包含在這個版本中：

Edge UI 版本 邊緣管理版本 入口網站版本

請參閱關於版本編號一文，瞭解如何瞭解特定雲端版本是否包含指定的 Cloud 版本。

版本總覽

這個版本最重要的新功能包括：

  • 升級至 PostgreSQL 9.6
  • 私有雲全新邊緣體驗 Beta 版
  • 三個全新 Beta 版政策，可讓您產生、驗證及解碼 JSON Web Token (JWT)。

這個版本也包含以下列出的 Edge Public Cloud 版本的所有錯誤修正和新功能。

淘汰與退休

這個版本已淘汰或淘汰下列功能。詳情請參閱 Edge 淘汰政策。

淘汰項目

淘汰新的 API BaaS 安裝作業

自 2018 年 1 月 31 日起，新規定不適用於您的規格表重點顯示 API BaaS 授權。

Apigee 安全商店即將淘汰 (保管箱)

Apigee 安全儲存庫 (又稱為「保管箱」) 已淘汰，將於 2018 年 9 月淘汰。保管箱為管理鍵/值組合提供加密功能，並採用管理 API 並在執行階段透過 Apigee-access Node.js 模組中的函式存取。

請改用加密鍵/值對應 (KVM)，詳情請參閱「使用鍵/值對應」一文。加密的 KVM 與保管箱相同，也提供建立和擷取的其他選項。(MGMT-3848)

在 API「API 效能」分頁中新增路徑的淘汰作業

這個版本推出後，您可以使用管理使用者介面中的 API Proxy、前往「效能」分頁，並在 Proxy 的「效能」分頁和「業務交易」資訊主頁中，建立以圖表為基礎的比較路徑。這項功能現已淘汰，使用者介面不再支援這項功能。如需其他這項功能，請參閱以下 Apigee 社群文章：https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html。 (EDGEUI-902)

淘汰 SMTPSSL 屬性，為開發人員入口網站設定 SMTP 通訊協定

您現在可以使用 SMTP_PROTOCOL 屬性 (而非 SMTPSSL 屬性) 來設定連結至入口網站的 SMTP 伺服器使用的通訊協定。有效值為：「standard」、「ssl」或「tls」。

詳情請參閱「開發人員服務入口網站安裝」。

新功能與最新消息

以下是這個版本的新功能和強化項目。除了下列強化項目以外，這個版本還包含多項可用性、效能、安全性和穩定性強化項目。

私有雲

PostgreSQL 升級至 9.6 版

這個版本包含 PostgreSQL 9.6 的升級版本，讓 Edge 能使用 PostgreSQL 的平行查詢功能。詳情請參閱：

私有雲全新邊緣體驗 Beta 版

這個私有雲的 Edge 包含 API 管理使用者介面的主要更新 Beta 版。這項新的 Edge 服務是以 Apigee Edge 平台現有功能為基礎建構，並新增了一些強化功能，尤其是在設計和發布方面。

新版 Edge 服務先前僅供 Cloud 使用者使用。在這個不公開雲端的 Edge 中，您現在可以安裝全新 Edge 服務的 Beta 版。

詳情請參閱「新的私有雲全新邊緣體驗 Beta 版」。

JWT 政策 Beta 版

JSON Web Token (JWT) 是 IETF RFC 7519 中所述的權杖標準。JWT 可讓您簽署一組聲明，也就是一組名稱/值組合，稍後可由 JWT 的接收者以可靠的方式驗證。

這個版本包含三個新政策，可讓您在 Apigee Edge 上產生、驗證及解碼 JSON Web Token (JWT)：

  • 產生 JWT 政策：產生已簽署的 JWT，以及一組可設定的版權聲明。接著，JWT 可以傳回給用戶端、傳輸至後端目標，或以其他方式使用。詳情請參閱「產生 JWT 政策 (Beta 版)」。
  • 驗證 JWT 政策：驗證從用戶端或其他系統收到的 JWT 上的簽名。這項政策也會將版權聲明擷取至流程變數，以便後續政策或條件檢查這些值，以便決定授權或轉送。詳情請參閱「驗證 JWT 政策 (Beta 版)」。
  • 解碼 JWT 政策：解碼 JWT，但不驗證 JWT 中的簽章。與 JWT 驗證政策搭配使用時，此政策非常實用，因為在驗證 JWT 的簽名之前，必須先知道 JWT 中的憑證值。詳情請參閱解碼 JWT 政策 (Beta 版)。

如需總覽，請參閱 JWT 政策總覽。

虛擬主機支援的 OCSP 加密機制 (65587547)

虛擬主機現在支援單向傳輸層安全標準 (TLS) 的單向與雙向傳輸層安全標準 (TLS)。啟用 OCSP (線上憑證狀態通訊協定) 用戶端後，系統會向 Google OCSP 回應者傳送狀態要求，藉此判定憑證是否有效。回應會指出憑證是否有效，且未撤銷。

OCSP 的加密功能預設為關閉。您必須在虛擬主機上啟用傳輸層安全標準 (TLS)，才能啟用 OCSP。

詳情請參閱「虛擬主機屬性參考資料」。

現在可以在虛擬主機層級設定路由器重試選項

您現在可以透過虛擬主機的訊息訊息處理器設定路由器的通訊方式。如此一來，您就能獲得比先前選項更精細的控制項，這只能於路由器層級設定。

詳情請參閱「虛擬主機設定屬性」。

新增了外部角色對應支援 (67145030)

如果您使用外部驗證功能將外部目錄服務整合至 Apigee Edge Private Cloud 安裝作業，您現在可以使用外部角色對應設定。透過外部角色對應，您可以將自己的群組或角色對應至角色型存取權控管 (RBAC) 角色和透過 Apigee Edge 建立的群組。

Edge 1.18.01 之前的版本之前，已針對 Private Cloud 使用 Private External Mapping 服務。外部角色對應 4.18.01 版是更新版本，修正了多項錯誤並新增功能：

  • 修正了在驗證應擁有存取權的使用者時，收到驗證 403 禁止回應的問題。
  • 外部角色對應現在支援 X-Apigee-Current-User 標頭。具有適當存取權 (sysadmin) 的使用者能以其他憑證登入。

詳情請參閱外部角色對應。

無須安裝即可測試系統需求 (67858161)

Private Cloud 4.17.09 的 Edge 現已支援 ENABLE_SYSTEM_CHECK=y 屬性，以便在安裝過程中檢查機器的 CPU 和記憶體需求。但必須執行這項檢查，才能執行實際的安裝作業。您現在可以使用「-t」旗標來檢查，無須安裝：

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

這個指令會顯示畫面中列出的系統需求。

詳情請參閱「在節點上安裝 Edge 元件」。

更新開發人員服務入口網站的 PHP 版本 (68733233)

入口網站現在使用 PHP 7.0.23 版。

不再使用開發人員入口網站 (70164403) 設定 SMTP 伺服器

安裝入口網站時，不再需要設定 SMTP 伺服器。現在設定一次安裝後即可。

API 服務

驗證新實體的名稱 (MGMT-4252 和 MGMT-4098)

建立新實體時，Apigee 會驗證名稱來強制執行命名規則。建立或更新時要驗證的實體：API Proxy、政策 (API Proxy 定義中的政策名稱及政策名稱)、虛擬主機、角色、快取、目標伺服器、用於偵錯的資料遮罩、KeyStore 和 TrustStore，以及 API Proxy 中的資源檔案。如要瞭解這些實體的命名限制，請參閱命名和輸入錯誤建議。

錯誤修正

這個版本修正了下列錯誤。這份清單主要供使用者查看自己的支援單是否已修正。此功能並非為所有使用者提供詳細資訊。

私有雲 4.18.01

問題 ID 說明
68001164

系統現在預設會安裝 PHP LDAP 擴充功能

現在，在 RedHat 和 CentOS 安裝入口網站時，系統現在會安裝 PHP LDAP 擴充功能。這個模組可讓您更輕鬆地啟用 Drupal LDAP 模組。
68049481

Dupal settings.php 檔案現已可寫入

入口網站安裝指令碼現在可確保 Drupal settings.php 檔案可由「Apigee」使用者寫入，以便正確複製及更新。
68139166 安裝程式輸出內容顯示未成功降級的 OpenLDAP。
68329105 當 SAML 啟用並採用自行簽署憑證時，通訊埠設定就無法建立使用者。
68427561 系統現在會在重新啟動後正確設定通訊埠設定屬性。
69024465 無法在 Edge UI 中取消部署 SharedFlow
69711616 將 Jackson Databin 更新至第三方 JAR 中的 2.7.9.1 版。

17.11.06 (UI)

問題 ID 說明
68357182

CSV 檔案未包含正確的時間範圍資料 (包括完整資料)
CSV 檔案中沒有指定時間範圍內的正確資料。因此，檔案中會包含完整的資料組合。這個問題已經解決。
67650494 Edge UI 應追蹤環境變更
在某些情況下，在 UI 切換頁面時，不會保留環境變更。這個問題已經修正。

17.10.25.00 (入口網站)

問題 ID 元件名稱 說明
67646686 開發人員入口網站 - Drupal &位於論壇頁面
已修正預設 Apigee 主題，選單選單中所有連接的「&」錯誤。
65456469 開發人員入口網站 - Drupal 更新 CAPTCHA 模組，由模組貢獻者提供的安全性強化功能
人機驗證 (Captcha) 已更新至 CAPTCHA 7.x-1.5，以便修正安全漏洞。詳情請參閱 https://www.drupal.org/node/2907137。
65101827 開發人員入口網站 - Drupal 公司應用程式數據分析無法運作
修正營利公司應用程式無法顯示任何數據分析資料的錯誤。
65003870 開發人員入口網站 - Drupal 無法取消日後的房價方案
修正公司無法購買日後的房價方案的錯誤。
65003539 開發人員入口網站 - Drupal 使用 Drupal 語言代碼的預設國家/地區
「營利聯絡人」和「帳單詳細資料」地址現在使用「語言代碼預設國家/地區」設定中的預設國家/地區。如要變更這項設定，請在 Drupal Administration 選單中依序選取「Configuration」>「Regional and language」。變更預設語言代碼後，「營利聯絡人和帳單詳細資料」部分中的預設國家/地區也會隨之變更。

17.10.11 (UI)

問題 ID 說明
67005192 在檢查權限時，UI 必須處理已解碼的路徑
使用者介面現在會檢查使用者權限，藉此處理已解碼的路徑。

17.09.20 (API 管理和執行階段)

問題 ID 元件名稱 說明
GMT-4219 API 管理 MGMT 將機構和環境標頭傳送至 zip
GMT-4065 API 管理 支援 PKS 格式憑證
GMT-3782 API 管理 最適合身分區間的預設一致性等級值
GMT-3913 API 管理 解決 appId 透過 OAuth2 權杖擷取逾時的問題
GMT-4177 API 管理 停用 SecurityProfile 基本驗證架構
GMT-3978 API 管理 需要 CWC 權杖，才能在所有 Java 元件上設定 JVM_OPTIONS
MGMT-3918
MGMT-4294		 API 管理 自動為自訂角色的權限路徑中的特殊字元編碼
APIRT-4767 API 執行階段 JavaScript 步驟應一律使用 UTF-8 內容
APIRT-4725 API 執行階段 修正 OAuth 服務 NPE 問題
APIRT-4691 API 執行階段 請先預留連線時間，再終止健康狀態不良的服務
APIRT-4644 API 執行階段 BYTESService 的基本授權
APIRT-4636 API 執行階段 如果 Zookeeper 停止運作，Sense 應繼續運作
APIRT-4635 API 執行階段 重複使用 OAuth 政策的重新整理權杖屬性支援
APIRT-4632 API 執行階段 滾動式視窗配額計數器無法正確計算
APIRT-4584 API 執行階段 流程掛鉤不穩定部署，WorkManagerKeeper 檢查功能無法正常運作
APIRT-4542 API 執行階段 MP Sense 工作結束，且不另行通知
APIRT-4522 API 執行階段 如果機構區域與 axgroup 區域不同，Analytics (分析) 就無法啟用已啟用營利功能的訊息處理工具
APIRT-4444 API 執行階段 每個錯誤代碼的運算錯誤率
APIRT-4435 API 執行階段 RepositoryServiceImpl.loadAsString() 不使用字元集
APIRT-4370 API 執行階段 機構 MP 的記憶體用量偏高
APIRT-4354 API 執行階段 在每個要求以 Nginx access_log 擷取傳輸層安全標準 (TLS) 版本
APIRT-4169 API 執行階段 目前的 Nginx 版本不支援 X-Forwarded-For 標頭所需的變數組合
APIRT-3671 API 執行階段 開啟雜湊處理功能後，系統不會將權杖記錄為經雜湊處理
APIRT-3593 API 執行階段 OAuth 權杖在後續呼叫中並未保留設定屬性
APIRT-3081 API 執行階段 messaging.adaptors.http.flow.ServiceUnavailable 錯誤，並行率限制政策
APIRT-4660 API 執行階段 在標頭中新增 MP Pod 名稱至路由器 X-Apigee-Pod
APIRT-4506 API 執行階段 系統不會將快取變更複製到特定訊息處理工具
APIRT-4196 API 執行階段 訊息記錄政策 syslog 時間戳記格式不正確
66933664 API 執行階段 非 CPS 流程的 QuotaService 應以非同步方式清除值區，而非在 Apigee-Main 執行緒中
66495205 API 執行階段 以非同步 HTTP 呼叫方式處理 JavaScript 政策，避免發生 NPE
65847462 API 執行階段 NPE 的列印陳述式失敗
65648578 API 執行階段 只有 MP 僅會於 KV 路徑中註冊
65603360 API 執行階段 JavaScript 呼叫失敗，並顯示空值
65416531 功能平台 在 JavaScript 物件恢復為 JavaScript 步驟內容時，重複使用訊息內容
67405744 Apigee 對 MP 的處理要求極高
65849186 三輪 未處理的例外狀況不會導致 Node.js/Trireme 程序結束
65713882 三輪 Trereme 中的 mongodb-core 產生不同的加密編譯結果與原生 Node.js
65374484 三輪 節點安全性：http.get 和數值授權選項會建立未初始化的緩衝區
64577449 三輪 Trireme 傳回無效的驗證演算法 sha256 錯誤
EDGESERV-6 邊緣伺服器 遇到 x_apigee_fault_code 的節點應用程式：「scripts.node.runtime.ScriptExecutionError」

17.09.20 (UI)

問題 ID 說明
65584963 Analytics (分析)：自訂報表篩選器的資料類型必須不區分大小寫
自訂報表篩選器現在不區分大小寫，用於比較資料類型。
65446846 無法在 Edge UI 中為公司指派管理員角色
系統會顯示完整的開發人員和公司組合，你可以透過 Edge UI 進行管理。
65125644 無法從公司應用程式的憑證中移除 API 產品
已修正導致公司 API 產品從公司應用程式憑證中移除的問題。

17.09.11 (API 管理)

問題 ID 說明
64541665 變更 MP 上的來源記錄器設定，使其有不同的記錄名稱
APIRTF-3593 OAuth 權杖在後續呼叫中並未保留設定屬性
APIRT-4336 將 OAuthStepExecution 拆分為多個步驟執行作業。每項作業都應該有專屬的步驟執行作業
APIRT-4444 每個錯誤代碼的運算錯誤率
APIRT-4456 重構 EAP-閘道/apid 的 API 金鑰
APIRT-4635 重複使用 OAuth 政策的重新整理權杖屬性支援
APIRT-4683 將 GCP 負載平衡器 IP 新增為 XFF 標頭的信任
APIRT-4723 EdgeX/混合模式的 OAuth 軟體包載入支援
APIRT-4725 修正 OAuth 服務 NPE 問題
APIRT-4726 ScriptableHttpClient 不應假設訊息在傳送時仍含有訊息內容
GMT/3764 KeyStore 不會再透過管理服務管理
GMT-3782 最適合身分區間的預設一致性等級值
GMT-3913 解決 appId 透過 OAuth2 權杖擷取逾時的問題
GMT-3997 如果提供 KeyStore 指向的參照，請勿允許刪除
GMT-4013 更新 KeyStore 參照檢查是否存在 KeyStore 和參照別名
GMT-4065 支援 PKS 格式憑證
GMT-4113 自助式虛擬主機功能強化
GMT-4229 新增 @JsonSerialize(include = JsonSerialize.Inclusion.NON_DEFAULT) API 設定迴歸失敗
GMT-4232 [EDGEX/Hybrid] Import API 上傳項目不會毀損套件
GMT-4242 [EDGEX/Hybrid] 支援將 Proxy 部署至多個環境
GMT-4245 標準 [EDGEX/Hybrid] 適用於虛擬虛擬主機的 VirtualHost 自助式服務驗證
GMT-4250 [EDGEX] API Proxy 部署狀態 API 的平行執行作業

17.09.06 (UI)

問題 ID 說明
65015144 Analytics (分析)：自訂報表頁面篩選器中的 BigQuery 客戶整數值篩選器發生問題
自訂報表頁面篩選器現在可正常處理整數值。
64806976 「應用程式清單」頁面不會填入開發人員欄位
系統將為清單中的所有應用程式填入「開發人員」欄位，
64766918 API Proxy 編輯器的 YAML 支援損毀
修正 API Proxy 編輯器中 YAML 檔案的問題。
64160572 數據分析：從 Analytics (分析) 選單和「Proxy 編輯器」分頁移除商家交易
系統不再支援「商家交易」數據分析資訊主頁，如要瞭解詳情，請參閱社群文章 Alternate 至 Business Deal API 一文。

17.08.21.00 (入口網站)

問題 ID 說明
2025 年 Chrome OS 切換公司後，營利角色會遺失
啟用營利功能後，如果您將角色指派給使用者，且使用者轉移到了其他公司的內容，那麼角色就會從使用者中移除。
開發人員 2021 年 Drupal 模組更新
下列 Drupal 模組已更新為指定的版本：
  • 檔案實體 (可編輯檔案) 7.x-2.4
  • 媒體 7.x-2.10
  • 媒體 CKEditor 7.x-2.5
  • 媒體：YouTube 7.x-3.5
  • 中繼標記 7.x-1.22
  • 服務檢視畫面 7.x-1.2
公司 2012

啟用營利功能時，網站顯示「發生錯誤」
修正啟用營利模組時發生的問題。在記錄中，Website encountered an error 訊息包含下列訊息：

Error: Call to a member function clear() on string in devconnect_monetization_clear_api_cache() (line 1517 of /var/www/html/profiles/apigee/modules/custom/devconnect
/devconnect_monetization/devconnect_monetization.module)

系統不會再記錄這個錯誤。
公司 2609 Drupal 狀態頁面不會顯示 SAML 的適當 Edge 連線狀態 (OAuth)
Drupal Status 頁面現在會顯示 SAML 適用的適當的 Edge 連線狀態。先前，即使您已正確設定 SAML，「報告」>「狀態」報表頁面仍會顯示連線失敗。
公司：2008 年 SAML/OAuth：每次呼叫時都會記錄不記名權杖快取錯誤
修正 Beaer 權杖快取邏輯會導致系統每次呼叫 Edge 時都會取得新的權杖。
公司 2599 devconnect_user_developer_is_active() 的多個問題
修正問題：系統會檢查開發人員狀態，藉此判斷使用者是否有效。如果 Edge UI 中已停用開發人員帳戶，導致應用程式金鑰停止運作，系統現在會顯示訊息，通知開發人員。另外，這項功能也能提升效能。
公司 2595 SAML 設定強化與更新
已針對 SAML 設定進行下列強化項目與更新：
  • 您現在可以編輯 SAML 設定頁面。詳情請參閱「使用 SAML 驗證」。
  • 使用者名稱欄位現在會顯示在 UI 中。
  • 已修正 drush 「dc-test」呼叫，以便使用標準連線測試函式，因此不會再忽略 SAML 設定。
公司 2569 應用程式數據分析：端點回應時間不再有效，已變更為「總回應時間」
「開發人員回應時間」數據分析圖表已從「開發人員」頁面的「數據分析」分頁中移除，因為該兩者並未反映總回應時間，因而造成混淆。 指標僅反映端點回應回應所需的時間，但不會反映 API Proxy 回應所需的時間。「處理量」圖表會顯示開發人員的開發人員總回應時間。

17.07.31.00 (入口網站)

問題 ID 說明
DEVSOL‐2258 版 有些文字欄位無法翻譯成葡萄牙文
新增 Drupal Dev Portal 應用程式模組中缺少的翻譯文字至 Drupal 國際化系統。過去，部分文字無法在「我的應用程式」頁面上翻譯。
公司：2036 年 編輯「應用程式名稱」或「回呼網址」會導致入口網站從開發人員應用程式中移除 API 產品
更新開發人員應用程式之後，系統就不會再從應用程式中移除 API 產品。
公司：2019 年 devdocs_developer_apps 的智慧型文件未宣告依附性
智慧型文件模組不再需要對 DevConnect 開發人員應用程式模組的不必要的依附元件。
公司 2492 公司頁面中的 HTML 逸出有誤
已修正內含 HTML 編碼的營利選單，例如「目錄與方案」
公司 2490 改善營利模組中的費率方案日期設定器
改善不同時區的營利費率方案處理方式。
公司 2440 在開發人員入口網站中，淘汰已淘汰的管理「限制」API，導致 404 秒
已更新系統，用於處理「營利」中的新檢視/購買方案 API。
公司 2436 在 DevPortal DB 中啟用啟用營利功能的 Apigee_company Drupal 模組時，缺少 drupal_cache_mint 資料表
已修正營利設定會導致以下錯誤：「ERROR: 「drupal_cache_mint」不存在」等問題。
公司 2419 將非 OpenAPI JSON 檔案匯入 OpenAPI 並不會擲回錯誤訊息
現已將 OpenAPI 文件匯入 SmartDoc，可驗證文件是 OpenAPI 規格。
公司 2406 SmartDoc 連結「修訂版本詳細資料」或「編輯修訂版本」無法運作
修正問題：SmartDoc 修訂版本動作選單中的「修訂版本詳細資料」或「編輯修訂版本」顯示錯誤頁面。
公司 - 2382 「鎖定 SmartDoc 方法範本」功能
我們新增了「管理 SmartDoc 範本」權限，以便編輯 SmartDoc 範本，或僅授予有限角色。
公司 - 2380 Dupal 記錄中的未定義索引錯誤
已針對啟用營利功能的 Drupal 記錄中移除下列誤導性訊息： Undefined index: role in Apigee\ManagementAPI\Company->listDevelopers()
公司 2375 Dupal 記錄檔中的位址錯誤無效
修正系統未設定 SMTP 時，會導致記錄中新增無效錯誤的錯誤。
公司 2055 cURL 逾時會導致 PHP-php-sdk 產生 PHP 警告和記錄錯誤
修正逾時會造成記錄格式有誤的訊息記錄。
公司 2336 營利服務供應商設定更新
依序點選「設定」>「營利設定」>「透過 Worldpay 定期付款」開發人員入口網站頁面，即可設定 WorldPay 付款資料。
公司 2307 新增警告/說明文件，apigee_company 模組只能用於營利
必須啟用營利功能，apigee_company Drupal 模組才能使用營利功能。如果在未啟用營利功能時啟用 apigee_company 模組，網站的「狀態」報表中就會顯示警告訊息。
公司 - 2270 最新版營利申請 (2016 年 10 月 5 日) 無法儲存公司資訊
修正營利問題，無法正確儲存公司資訊。
公司 2075 「Me Alias」和「Core Stats」核心模組無法順暢執行
核心節點和「Me Aliases」虛擬模組模組經過修補，以便同時啟用「Me Aliases」和「核心統計資料」模組。詳情請參閱 https://www.drupal.org/node/1863260 和 https://www.drupal.org/node/2076691。

已知問題

這個版本有下列已知問題：

問題 ID 說明
72379834

停止 apigee-postgresql 時顯示權限錯誤訊息

使用 apigee-seriver apigee-postgresql stop 指令停止 apigee-postgresql 時，系統可能會顯示訊息，說明 apigee-serive 無法變更使用者住家的樹狀結構。您可以忽略該訊息。
68722102

MessageLogging 政策，在記錄訊息中加入其他資訊

MessageLogging 政策的 FormatMessage 元素可控制記錄訊息的格式。當 FormatMessage=false 時，記錄訊息不應含有任何 Apigee 產生的資訊。即使您已設定 FormatMessage=false，記錄訊息仍會包含以下資訊：

  • 優先順序分數
  • 時間戳記
上一頁
4.18.01.01
下一頁
4.17.09.03