4.15.07.00 - Apigee Edge for Private Cloud 版本資訊

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

我們在 2015 年 9 月 8 日星期二,發布了 Apigee Edge for Private Cloud 的重大功能版本。

自上一個 Edge for Private Cloud 季度版本 (4.15.04.00) 以來,已推出下列版本,並包含在這個季度版本中:

哪些 Edge 版本可以升級至 4.15.07.00

視目前的 Edge 版本而定,你可以:

  • 直接升級至 4.15.07.00
  • 逐步升級,也就是說,您必須從目前版本升級至另一個 Edge 版本,然後再升級至 4.15.07.00。

詳情請參閱「哪些 Edge for Private Cloud 版本可以升級至 4.15.07.00」。

從 4.15.01.x 或更早版本升級前

升級前,請確認您已在每個 Cassandra 節點上,升級 Cassandra SSTable:
  1. 檢查 Cassandra SSTable 版本:
    1. 將目錄變更為 /<install-root>/apigee4/data/cassandra/data。
    2. 執行尋找指令:
      > find . -name *-ic-*
      如果您執行的是 Cassandra 1.2 SSTable,結果應會傳回一組 .db 檔案。
    3. 執行下列尋找指令:
      > find . -name *-hf-*
      結果應為空白,表示沒有 .db 檔案採用 hf 格式。如果沒有看到 hf 格式的檔案,代表您已完成作業,可以升級至 4.15.07.00。

      hf 格式適用於 Cassandra 1.0 SSTable。如果您有任何 *.db 檔案採用 hf 格式,則必須按照本程序其餘部分所述升級 SSTable。
  2. 如果發現任何 hf 格式的 *.db 檔案,請在每個 Cassandra 節點上執行下列指令,直到所有 Cassandra 節點都升級為止:
    > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
  3. 重複步驟 1,確認所有 *.db 檔案都採用 Cassandra 1.2 版本的 ic 格式。
  4. 在 Edge 安裝作業中的每個 Cassandra 節點上,重複執行步驟 1 到 3。
  5. 升級至 Edge 4.15.07.00。
  6. 升級至 4.15.07.00 後,請檢查 *.db 檔案,確認所有檔案都已升級至 C* 2.0 樣式 sstable:
    > cd /<install-root>/apigee4/data/cassandra/data
    > find . -name *-jb-*

    如果您執行的是 Cassandra 2.0,這個指令應該會傳回一組 .db 檔案。

新功能和強化項目

以下是這個版本的新功能和強化項目。

安裝與升級

選擇性升級及解除安裝元件

apigee-upgrade.sh 和 apigee-uninstall.sh 指令碼現在可讓您選取要升級或解除安裝的 Edge 元件。在舊版中,系統會升級或解除安裝節點上的所有元件。(OPDK-1377、OPDK-1175)

復原升級

如果 apigee-upgrade.sh 在升級期間失敗,您現在可以使用 apigee-rollback.sh 指令碼復原升級。修正所有升級問題後,即可重試升級。(OPDK-1275)

縮短的安裝程式指令碼選項

安裝指令碼不再接受長格式選項,例如 --help。現在只接受單一字母選項,例如 -h。(OPDK-1356)

安裝 SmartDocs

使用 setup-smartdocs.sh 指令碼安裝 SmartDocs 時,系統會提示您輸入組織、環境和虛擬主機,確保 SmartDocs 安裝在預期位置。先前,這些值是以硬式編碼寫入指令碼。(OPDK-1310)

在不顯示提示的情況下執行 update-cass-pwd-in-config.sh

如果您設定 ENABLE_CASS_AUTH、CASS_USERNAME 和 CASS_PASSWORD 環境變數,update-cass-pwd-in-config.sh 指令碼就能在不顯示提示的情況下執行。(OPDK-1309)

Edge Platform

以下是這個版本中包含的新 Edge 平台功能。

Edge for Private Cloud 支援 OpenJDK 1.7

這個版本的 Edge 支援 Oracle JDK 1.7 和 OpenJDK 7,並移除對 JDK 1.6 的支援。(OPDK-1187)

OS 支援

Apigee Edge for Private Cloud 擴大支援的作業系統範圍,包括 Red Hat Enterprise Linux 6.6 和 7.0 (64 位元)、CentOS 6.5、6.6 和 7.0 (64 位元),以及 Oracle Linux 6.5。

OPDK 15.07 包含 Cassandra 2.0.15

這個版本會安裝 Cassandra 2.0.15。如果您是從先前的版本升級,Cassandra 版本將會更新。(OPDK-1197)

支援 SHA2 雜湊 OAuth 權杖

為在資料庫安全性漏洞發生時,更妥善保護 OAuth 權杖,Edge 支援 SHA2 演算法,用於雜湊 OAuth 權杖 (除了 SHA1 之外)。有了新的組織層級屬性,您就能為新權杖啟用及設定雜湊功能,並保留這項新功能推出前就存在的任何權杖的舊版雜湊功能。在舊版 Edge for Private Cloud 中,keymanagement.properties 檔案 (位於管理伺服器和訊息處理器) 的 hash.oauth.tokens.enabled 屬性,可啟用 OAuth 權杖的自動 SHA1 雜湊功能。這項屬性現已淘汰。

如果您先前使用 hash.oauth.tokens.enabled 屬性啟用 SHA1 雜湊,這個版本的升級指令碼會自動為您產生新的組織層級屬性。如要在升級後進行驗證,請以系統管理員身分使用下列 API 執行 GET 要求:https://{host}:{port}/v1/o/{your_org}。

  • 如要瞭解如何使用新屬性在組織中啟用權杖雜湊功能,請參閱「要求存取權杖」主題中的「在資料庫中雜湊權杖」一節。
  • 如要瞭解如何大量雜湊現有權杖,請參閱「Edge for Private Cloud 作業指南」。(APIRT-1389)

記錄檔的平面目錄結構

您可以在 message-logging.properties 檔案中,將新的 enable.flat.directory.structure 屬性設為 true,藉此設定 Edge 將記錄檔儲存在平面目錄結構中。詳情請參閱「訊息記錄政策」。(APIRT-1394)

環境快取效能

為了更妥善管理及運用記憶體快取,環境快取資源的「記憶體中的元素數量上限」設定已淘汰。所有快取資源 (包括預設快取) 中存在的元素總數,取決於分配給快取的記憶體配置總量。根據預設,為特定訊息處理器分配的記憶體內快取記憶體總量,是可用記憶體總量的 40%,由訊息處理器 cache.properties 檔案中的快取屬性設定決定。只有在快取記憶體不足或元素過期時,系統才會從記憶體內快取中移除元素。

如要還原為使用「記憶體中的元素數量上限」屬性進行快取管理的舊行為,請在 cache.properties 檔案中設定 overrideMaxElementsInCacheResource=false 屬性。(APIRT-1140)


API 服務

以下是這個版本包含的新 API 服務功能。

新版 Proxy 編輯器設為預設

管理 UI 預設會啟用新版 API Proxy 編輯器。新版編輯器包含多項可用性改善,包括在「總覽」頁面提供更全面的條件流程和端點檢視畫面、在「開發」頁面提供所有設定、更直覺地新增條件流程、端點和政策、更完整的 XML 檢視畫面 (而非小型程式碼片段)、可檢索檔案名稱和文字的搜尋功能等。(MGMT-2279)

新增「刪除 OAuth v2.0 資訊」政策

新的「刪除 OAuth v2.0 資訊」政策可讓您刪除 OAuth v2 存取權杖和授權碼。這項政策會取代 Management API 先前提供的功能。詳情請參閱「刪除 OAuthV2 資訊政策」。(MGMT-2257)

新增「刪除 OAuth v1.0 資訊」政策

新的「刪除 OAuth v1.0 資訊」政策可讓您刪除 OAuth v1.0 要求權杖、存取權杖和驗證碼。這項政策會取代 Management API 先前提供的功能。詳情請參閱「刪除 OAuth V1 資訊政策」。(APIRT-1351)

存取控管政策

存取控管政策已強化,當 IP 位址包含在 X-FORWARDED-FOR HTTP 標頭中時,可更精細地評估 IP 位址,以便加入許可清單和拒絕清單。

在標頭上啟用多個 IP 位址檢查功能 (請與支援團隊聯絡,設定 feature.enableMultipleXForwardCheckForACL) 後,政策中的新 <ValidateBasedOn> 元素可讓您檢查標頭中的第一個 IP、最後一個 IP 或所有 IP。詳情請參閱「存取控管政策」。

存取實體政策中的新實體

Access Entity 政策可讓您存取下列新實體:consumerkey-scopes、authorizationcode、requesttoken 和 verifier。詳情請參閱「Access Entity 政策」。

統計資料收集器政策:自動將統計資料名稱轉換為小寫

在 API Proxy 編輯器 (「Develop」頁面 >「Tools」>「Custom Analytics Collection」) 中建立自訂數據分析收集時,收集器變數 (統計資料)「Name」必須為小寫。如果您輸入的名稱包含大寫字母,工具會自動將統計資料收集器政策中的統計資料名稱轉換為小寫。(MGMT-740)

移除 API Proxy 編輯器中的傳統版追蹤記錄

API Proxy 編輯器中的最新版追蹤功能已從 Beta 版轉為正式發布版。「存取傳統版追蹤記錄」連結已無法使用,無法再存取「傳統版追蹤記錄」。

從管理 UI 的「說明」選單存取 Apigee 社群

您可以透過管理 UI 的「說明」選單前往 Apigee 社群。

管理使用者介面中的錯誤訊息

以下是管理 UI 中的錯誤訊息強化功能:

  • 管理 UI 過去會將所有錯誤訊息分組,並在 UI 上顯示整個登入工作階段,除非您關閉這些訊息。本次更新後,只要離開發生錯誤的頁面,系統就會自動清除錯誤訊息。(MGMT-2254)
  • 管理 UI 不會再隱藏重複的錯誤訊息。(MGMT-2242)

UI 效能和錯誤強化

我們對管理使用者介面的不同部分進行了全面強化,包括網頁顯示效能和錯誤訊息清除。

在管理 UI 的「機構使用者」頁面 (「管理」>「機構使用者」) 中,角色名稱現在會顯示為超連結,方便您快速前往角色頁面。(MGMT-1055)

訊息流程中的新目標變數

訊息流程中的新變數可為目標端點和目標伺服器提供更完整的網址資訊:

  • TargetEndpoint:request.url 取代 target.basepath.with.query。
  • TargetServer:loadbalancing.targetserver 取代 targetserver.name。 此外,只有在 TargetEndpoint 的 HTTPTargetConnection <LoadBalancer> 元素中使用 <Path> 元素時,系統才會填入 target.basepath。

伺服器名稱指示 (SNI) 支援

Edge 支援使用伺服器名稱指示南向 (從訊息處理器到目標端點)。如要使用 SNI,請與 Apigee Edge 支援團隊聯絡。

必須使用 Java 1.7。

SNI 是 TLS/SSL 的擴充功能,可讓多個 HTTPS 目標透過相同的 IP 位址和通訊埠提供服務,而不必讓所有目標使用相同的憑證。

無須進行 Edge 專屬設定。如果環境已設定為南向 SNI (Edge 雲端預設為此設定),Edge 支援這項功能。

Edge 會自動從要求網址中擷取主機名稱,並將其新增至 SSL 交握要求。舉例來說,如果目標主機是 https://example.com/request/path,Edge 會新增 server_name 擴充功能,如下所示:

如要進一步瞭解 SNI,請參閱 http://en.wikipedia.org/wiki/Server_Name_Indication。

SSL 憑證詳細資料中的「簽章演算法」

SSL 憑證詳細資料中新增了「Signature Algorithm」欄位,可在管理 UI (「管理」>「SSL 憑證」) 和管理 API (從 KeyStore 或 TrustStore 取得憑證詳細資料) 中查看。這個欄位會顯示「sha1WithRSAEncryption」或「sha256WithRSAEncryption」,具體取決於用來產生憑證的雜湊演算法類型。

顯示即將到期的 SSL 憑證

管理 UI 的「SSL 憑證」頁面 (「管理」>「SSL 憑證」) 會顯示 SSL 憑證將在 10、15、30 或 90 天內到期,具體取決於您在新的到期下拉式欄位中的選擇。

威脅防護錯誤設定

根據預設,如果訊息未通過 JSON 或 XML 威脅防護政策,Edge 會擲回 HTTP 500 內部伺服器錯誤狀態碼和 ExecutionFailed 錯誤。您可以使用新的組織層級屬性變更該錯誤行為。將機構屬性 features.isPolicyHttpStatusEnabled 設為 true 時,會發生下列行為:

  • 要求:如果威脅防護政策附加至任何要求流程,無效訊息會傳回 400 狀態碼,以及對應的政策錯誤訊息。
  • 回應:如果威脅防護政策附加至任何回應流程,無效訊息仍會傳回 500 狀態碼,並擲回其中一則對應的政策錯誤訊息 (而非僅擲回 ExecutionFailed)。

Cloud 客戶必須與 Apigee Edge 支援團隊聯絡,才能設定組織屬性。Edge 私有雲客戶可在下一次私有雲季度版本中使用這項功能。

端點、Proxy 和其他實體的更新結構定義

TargetEndpoint、ProxyEndpoint、APIProxy 等非政策實體的參考結構定義已更新。請參閱 https://github.com/apigee/api-platform-samples/tree/master/schemas。(APIRT-1249)


開發人員服務

以下是這個版本包含的開發人員服務新功能。

SmartDocs 正式發布

SmartDocs 將結束 Beta 測試,正式發布。更新和新功能包括:

  • 支援 Swagger 2.0,包括透過檔案或網址匯入,以及支援自訂名稱的安全性物件。
  • 改善生成 SmartDocs 的範本視覺設計。
  • 開發人員入口網站的可用性和工作流程強化功能,可透過 Drupal 的「Content」>「SmartDocs」選單存取。
  • 「自訂權杖」驗證現已改稱為「API 金鑰」。
  • 在修訂版本層級定義的驗證「安全性」物件。
  • 範本層級的用戶端驗證設定。新修訂版本不會再重設任何預先設定的 SmartDocs 用戶端憑證。

如需更多功能說明,請參閱這篇網誌文章。

如需 SmartDocs 說明文件,請參閱「使用 SmartDocs 記錄 API」。

管理 UI 中顯示的開發人員應用程式名稱

Edge 中的開發人員應用程式有不可變更的內部名稱,以及可變更的顯示名稱。在管理 UI 的「開發人員應用程式」頁面 (「發布」>「開發人員應用程式」> 應用程式名稱) 中,應用程式內部「名稱」會與「顯示名稱」一併顯示,方便您透過內部名稱辨識應用程式,以便排解問題及管理 API。


Analytics 服務

以下是這個版本推出的 Analytics Services 新功能。

保留資料的時間限制

使用管理 UI 或 API 產生數據分析報表時,根據預設,系統不會存取目前日期六個月前的資料。如要存取六個月前的資料,請與 Apigee Edge 支援團隊聯絡。

管理使用者介面將移除傳統版自訂報表

管理 UI 不再提供傳統版自訂數據分析報表。

開發人員參與度小工具成效

主要數據分析資訊主頁 (「開發人員參與度」部分) 的漏斗小工具已強化,可提供更優異的效能。


營利

以下是這個版本推出的新營利功能。

費率方案電子郵件通知

新的費率方案電子郵件通知類型可讓您在開發人員購買的依交易量分級或套裝費率方案達到特定交易或金額上限時,通知開發人員。詳情請參閱「使用通知範本設定通知」。

同步處理週期性費用和匯總基準期間

費率方案可能會有兩種不同的生效時間範圍:

  • 週期性費用週期,在費率方案的「費用」分頁中設定,決定向開發人員收取週期性費用的時間。
  • 匯總基準期,在「按用量分級」或「套裝方案」的價目表中定義,決定何時重設開發人員的套裝方案用量。

這兩個時間範圍現在會同步。如果費率方案同時包含非零的週期性費用和「依用量分級」或「套裝組合」價目表,則兩者都會使用週期性費用週期。舉例來說,如果存在每月週期性費用,則價目表套裝組合也會每月重設 (預設為月初)。

如果沒有週期性費用,系統會根據價目表上定義的匯總依據重設套裝方案。舉例來說,如果開發人員在當月 19 日開始使用價目表,且匯總基準為每月,則套裝方案用量會在 19 日後一個月重設。

「匯總依據」已淘汰,並將在日後推出的版本中從營利功能中移除。詳情請參閱「指定價目表方案詳細資料」。

收益摘要報表中的自訂屬性

您可以視需要透過交易記錄政策,擷取交易的自訂屬性資料,並在收益摘要報表中加入這些自訂交易屬性。只要在組織中新增 MINT.SUMMARY_CUSTOM_ATTRIBUTES 屬性,即可指定要將哪些自訂屬性新增至資料庫表格,以便在報表中使用。

Apigee Edge for Private Cloud 客戶可以使用下列 API 呼叫和系統管理員憑證設定標記。

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

請注意,API 呼叫中的自訂屬性陣列經過網址編碼。


SmartDocs 升級程序

如果您在 SmartDocs 推出 Beta 版時就已開始使用,則必須在開發人員入口網站中升級 SmartDocs,才能使用正式發布版的新功能。

開發人員入口網站中已發布的 SmartDocs 頁面會繼續運作,但您必須先完成更新程序,才能編輯或發布現有或新頁面的變更。

請注意,雖然您可以在開發人員入口網站中轉譯及發布 SmartDocs,但 SmartDocs 是由 Apigee Edge API 管理服務中的 API 模型產生。在 Edge 中對 API 模型所做的任何變更,都會套用至所有 Pantheon 環境 (類似於開發人員存在於 Pantheon 環境中的方式)。

將 SmartDocs 從 Beta 版升級至正式發布版

  1. 在 Pantheon 的開發或測試環境中,更新及測試 15.05.27 版本。
  2. 建立新模型,取代目前使用的 API 模型。
    • 如果您已匯入 Swagger 或 WADL 文件,請再次將這些文件匯入新的修訂版本。
    • 如果您一直透過 SmartDocs 模組維護 API 模型,請匯出為 SmartDocs JSON,並使用檔案附件匯入新模型。
  3. 設定模型修訂版本的安全性屬性。在「Content」>「SmartDocs」>「model」頁面中,選取「Security Settings」。
  4. 在模型設定頁面 (「Content」>「SmartDocs」) 中,按一下「Operations」欄中的「Settings」,檢查任何預先設定的驗證。
  5. 請更新所有自訂範本,改用第 6 版的 CSS 和 JS 素材資源,並進行變更以反映任何新的物件名稱,例如 authSchemes 和 apiSchema。如要瞭解如何更新 SmartDocs 範本,請參閱「使用 SmartDocs 記錄 API」。
  6. 重新算繪並發布模型修訂版本。
  7. 驗證新文件後,請將正式版入口網站更新至 15.05.27 版本。

如果您是 Edge 企業客戶,且對升級程序有任何疑問或疑慮,請傳送電子郵件至 marsh@apigee.com 和 cnovak@apigee.com。否則,請使用 Apigee 社群,以獲得最佳回覆。


日後的功能異動和強化

本節將預覽未來預期的功能異動和強化:

回應快取政策行為異動

在日後推出的版本 (待定) 中,回應快取政策的 <ExcludeErrorResponse> 元素預設行為將會變更。

目前行為:回應快取政策中的 <ExcludeErrorResponse> 元素預設為 false。也就是說,根據預設,回應快取政策會快取任何可能 HTTP 狀態碼 (包括 3xx) 的回應。

未來行為:回應快取政策中的 <ExcludeErrorResponse> 元素預設為 true。也就是說,根據預設,只有 HTTP 狀態碼為 200 到 205 的回應會快取。如要覆寫這項行為,並快取所有狀態碼的回應,您必須明確將 <ExcludeErrorResponse> 元素設為 true。

目前的解決方法:如果是 私有雲 4.15.07.00 和更早版本,如要只快取狀態碼為 200 至 205 的回應,必須明確將 <ExcludeErrorResponse> 元素設為 true。


修正錯誤

這個版本修正了下列錯誤。

問題 ID 說明
OPDK-1521 密碼加密問題
OPDK-1201 無法還原 UI 資料
OPDK-1112 自訂 LDAP 密碼政策未套用至 Apigee 管理員使用者
OPDK-1097 OPDK 升級期間發生鍵空間例外狀況
OPDK-1068 如果安裝期間失敗,可以變更管理員密碼
OPDK-1053 Zookeeper 以 root 身分執行
OPDK-967 使用 set-autostart.sh 將 OpenLDAP 設為自動啟動時,all-status.sh 會回報 OpenLDAP 已停止運作
OPDK-905 Smartdocs prod 已在 axgroup001 群組中註冊
OPDK-899 新手上路期間發生錯誤
OPDK-847 在新手上路期間建立的使用者未收到重設密碼的郵件
OPDK-817 init.d 指令碼擲回錯誤
OPDK-815 ax-purge.sh 指令碼需要清除取樣資料表
MGMT-2246 「建立自訂報表」頁面在管理 UI 中顯示不正確
MGMT-2235 對於即將到期的 SSL 憑證,到期相對時間可能會四捨五入,造成混淆
對於即將到期的 SSL 憑證,如果憑證在 90 天內到期,到期日的相對時間一律會以天數顯示,而不會四捨五入至月數。
MGMT-2193 編輯 API 時的載入旋轉圖示
MGMT-2173 Trace UI 不允許合法網址
Trace UI 現在可讓您傳送要求,其中查詢參數值包含巢狀查詢參數。
MGMT-2162 JavaScript 編譯問題
MGMT-2124 在使用者介面中儲存權限時,客戶角色的權限會重設
MGMT-2114 MessageLogging 政策中的 Syslog IP 無效,應在部署期間擲回適當錯誤
MGMT-2067 追蹤:如果 API Proxy 修訂版本部署在 2 個環境中,選取修訂版本和環境無法正常運作
MGMT-2061 「忘記密碼」功能只會傳送電子郵件給已註冊的使用者
管理 UI 登入頁面上的「忘記密碼?」連結只會傳送電子郵件給已註冊的 Apigee 使用者。
MGMT-2048 具備自訂角色的使用者可部署至其他環境,即使該角色將部署權限限制在單一環境
MGMT-2041 從預設附加範本中移除 FaultRules 元素
FaultRules 元素不會用於政策或 API Proxy 步驟,因此在您建立 API Proxy 或新增政策時,系統不會再自動新增該元素。
MGMT-2034 擷取 WSDL 傳回失敗:「擷取 WSDL 錯誤:處理 WSDL 時發生錯誤。」
MGMT-1986 新增開發人員時發生 UI 錯誤
MGMT-1983 Get an OAuth 2.0 authorization code API returns wrong status
MGMT-1962 使用高強度密碼登入管理 UI 時發生錯誤
使用特定特殊字元 (例如百分比符號) 登入 UI 時,不會再發生錯誤。
MGMT-1947 管理 UI 中的角色不符合直覺
如果使用者沒有建立或編輯交易記錄政策的權限,現在系統會停用建立和編輯交易記錄政策的 UI 按鈕。
MGMT-1899 儲存產品設定後,資源路徑遭到刪除
編輯 API 產品時,如果使用者按兩下「儲存」按鈕,產品的資源路徑可能會遭到刪除。這個問題已經修正。
MGMT-1894 開發人員欄的「開發人員應用程式」頁面無法完成載入
MGMT-1882 從 WSDL 建立的新 API Proxy 只會顯示最後一個參數的詳細資料
MGMT-1878 如果環境中部署了多個修訂版本,Trace 只會顯示其中一個
MGMT-1872 無法下載自訂報表
MGMT-1863 無法在管理 UI 中查看 Node.js 記錄
MGMT-1843 API Proxy 無法開啟
MGMT-1833 sysadmin 使用者不應在 OPDK 的 UI 中看到變更密碼的選項
MGMT-1825 跨網站指令碼攻擊 (XSS) 錯誤
MGMT-1824 匯入副檔名為 .xml 的 WSDL 檔案時,發生擷取 WSDL 錯誤
MGMT-1812 在匯入期間新增 TargetEndpoint 驗證
與 ProxyEndpoint 類似,系統會在匯入 API Proxy 期間,驗證 TargetEndpoint 是否使用正確的結構定義和條件運算式。
MGMT-1804 Node.js API 在某些情況下會傳送無效的 JSON
如果 JSON 資料含有無效字元,Node.js 記錄畫面會顯示未格式化的記錄。這個問題已在本版本中修正,UI 現在會顯示格式正確的 node.js 記錄。
MGMT-1802 密碼重設網址 #118
如果管理 UI 位於 SSL 終止伺服器後方,管理 UI 現在會正確產生重設密碼電子郵件,其中包含 https 網址連結,而非 http 網址。
MGMT-1799 在 Trace 中傳送要求時發生 UI 安全漏洞
MGMT-1777 無法新增電子郵件地址頂層網域為 .acn 的使用者
MGMT-1735 品牌宣傳「擷取 W 時發生錯誤」
我們已立即移除 Edge OPDK 中的自訂品牌宣傳支援。雖然我們知道這可能會讓少數使用這項功能的客戶感到失望,但這項功能並不會直接改善 Edge 的 API 管理功能。
MGMT-1569 將 API Proxy 附加至現有 API 產品時發生問題
如果 API Proxy 具有「/」路徑的資源,在管理 UI 中將 API Proxy 附加至 API 產品時,會發生問題。
MGMT-1563 如果 Trace 發生錯誤,「傳送」按鈕會保持停用狀態
MGMT-1362 Forgot Password email does not work if the Email address contains '_'
修正 OPDK 中電子郵件地址含有底線時,無法重設密碼的問題。
MGMT-1345 匯入具有多個命名空間的 WSDL 會導致建構 SOAP 步驟不正確
MGMT-1193 將 Proxy 另存為新的修訂版本時,路由規則意外變更
MGMT-1061 SmartDocs:Swagger 定義中的內文類型參數說明未顯示在文件 UI 中
MGMT-800 建立名稱為「default」的資源會導致 UI 損毀
MGMT-787 UI 警告可用性問題
在管理 UI 中,按一下「+ API Proxy」後,畫面上會顯示「New API Proxy」對話方塊,您可以按下 Esc 鍵關閉對話方塊。
MGMT-619 在 API Proxy UI 頁面啟用分頁功能
MGMT-602 API Proxy 開發檢視畫面:端點沒有 PreFlow/PostFlow 時,新增回應快取政策會導致錯誤
MGMT-460 重新命名政策會導致行為異常,以及無法移除重複的政策
DEVRT-1644 依名稱查詢通知時,系統傳送錯誤的電子郵件
DEVRT-1583 營利 UI 針對目前的費率方案顯示「未來」徽章
DEVRT-1546 方案限制未生效
DEVRT-1511 現有開發人員發生 mint.resourceDoesNotExist 錯誤
CORERT-639 TCPSysLogSocket 必須為非同步
CORERT-613 因「unrecognized_name」導致 SSL 握手失敗
AXAPP-1728 忽略數據分析中的營利變數
AXAPP-1708 Analytics API 似乎會根據我的查詢方式,為同一項統計資料產生不同的數字
AXAPP-1707 提升免費廣告連播數據分析成效
AXAPP-1690 自訂報表顯示「API 錯誤無效」
AXAPP-1533 Analytics 地理區域圖擲回「API 呼叫無效」錯誤
AXAPP-1493 快取效能統計資料不正確
APIRT-1436 建立工具/指令碼,對未經雜湊處理的權杖進行雜湊處理
APIRT-1425 當 continueOnError 屬性設為「true」時,對 JavaCallout 政策沒有影響
APIRT-1346 OAuth2.0 - 當 hash.oauth.tokens.enabled 為 true 時,存取權杖回應會傳回雜湊值
APIRT-1206 target_ip 未記錄在 503 和大部分 504 的事實資料表中
APIRT-1170 缺少資源檔案導致 MP 無法載入環境
APIRT-1148 在 ResponseFlow 中,Node.js 目標的 GET {message.version} 變數會擲回 NPE
APIRT-1054 嘗試記錄到預設目錄以外的其他目錄時,訊息記錄失敗
APIRT-387 在 MP 上以「others」變種版本執行 OrganizationService
APIRT-67 OAuth GenerateAccessToken 政策未正確設定 oauthV2.failed 變數
APIRT-52 自訂報表:許多 API 的回應狀態碼為空值

已知問題

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

問題 ID 說明
OPDK-1586

如果未啟用 IPV6 支援,API BaaS 入口網站就無法啟動
解決方法是在 /<install-dir>/apigee4/conf/nginx/conf.d/loadbalancer.conf 中註解排除下列 IPV6 行,讓 API BaaS 入口網站執行,或啟用 IPV6 支援:

# listen [::]:8080;

OPDK-1785

在升級後的 Edge 安裝環境中安裝營利元件
如果您將 Edge 安裝升級至 4.15.07.00,且在升級前未使用營利功能,則無法在 4.15.07.00 版 Edge 上安裝營利功能。

解決方法是在嘗試安裝營利功能之前,先在 apigee-env.sh 檔案中設定正確的營利版本。如要取得 4.15.07 版的營利功能 (在您升級至 Edge 4.15.07 後),請執行:
> source /{install-dir}/apigee4/bin/apigee-env.sh

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`
根據預設,install-dir 為 /opt。
上述 VER 的值必須在 apigee-env.sh 中設定:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh
如果您嘗試安裝 Monetization,但未執行上述步驟,安裝作業會失敗,且共用目錄中可能會有無效的符號連結。您必須移除該符號連結:
> rm /install-dir/apigee4/share/monetization
移除符號連結後,請按照上述步驟設定 Monetization 版本,然後重新安裝 Monetization。
OPDK-1857 bin/qpid-stat.sh 和 bin/qpid-config.sh 中的硬式編碼 Python 2.6 版本

在 CentOS 和 RedHat 7.0 上,bin/qpid-stat.sh 和 bin/qpid-config.sh 中的多個指令碼會硬式編碼為使用 Python 2.6 版。

如要解決這個問題,請在 apigee4/bin 目錄中的 qpid-stat.sh 和 qpid-config.sh 檔案中,變更匯出 PYTHONPATH 的行。

export PYTHONPATH="${QPID_DIR}/lib/python2.6/site-packages"

如要判斷系統上的 Python 版本,請查看 /opt/apigee4/share/apache-qpid/lib 目錄中的 Python 版本。目錄很可能是 python2.7。

接著,您必須在 qpid-stat.sh 和 qpid-config.sh 中,將 PYTHONPATH 設定更新為正確的路徑。例如:

export PYTHONPATH="${QPID_DIR}/lib/python2.7/site-packages"

DEVRT-1574 開發人員有多個有效費率方案時,餘額和用量不一致
在營利功能中,如果開發人員有多個有效費率方案,且這些方案會依 API 呼叫次數收費,則貨幣餘額用量有時可能會不一致。
APIBAAS-1647 以系統管理員身分登入後,BaaS UI 會顯示「Error getting roles」(取得角色時發生錯誤) 訊息
從 4.15.01 升級至 4.15.07 後,系統管理員首次登入系統時,會看到這則錯誤訊息。您可以忽略這則訊息。
DEVRT-1834 營利功能升級至 4.15.07
apigee-upgrade.sh 指令碼會在結尾顯示下列訊息,提示您執行其他指令碼:
**************************************
In order to complete the monetization upgrade please run:
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh
**************************************

您可以忽略這則訊息。該指令碼並非必要,無法執行。

DEVRT-1951 營利全新安裝缺少通知設定
在全新安裝的 Apigee Edge for Private Cloud 4.15.07.00 版中,缺少下列營利通知設定。這些設定與管理 UI 中「管理」>「通知」頁面上的通知類型相對應。
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
如要解決這個問題,請按照下列步驟操作。您需要 Cassandra 執行個體的 IP 位址。如要找出這個檔案,請查看 <installation-root>/apigee4/conf/cassandra/cassandra.yaml 或 <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties。
  1. 執行下列指令。請保留 {ORG_ID} 變數,但替換 <org_name>、<installation-root> 和 <cassandra_ip_address>。
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/ui/mint-org-specific-ui-schedulers.txt > /tmp/mint-org-specific-ui-schedulers.txt
    
    <installati>on-root/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-ui-schedulers.txt
  2. 重新啟動管理伺服器。
DEVRT-1952 從 4.14.07.00 升級營利功能時缺少通知設定
在 Apigee Edge for Private Cloud 從 4.14.07.00 版升級至 4.15.07.00 版時,缺少下列營利通知設定,導致營利報表無法正常運作。
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
如要解決這個問題,請按照下列步驟操作。您需要 Cassandra 執行個體的 IP 位址。如要找出這個檔案,請查看 <installation-root>/apigee4/conf/cassandra/cassandra.yaml 或 <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties。
  1. 執行下列指令。請保留 {ORG_ID} 變數,但替換 <org_name>、<installation-root> 和 <cassandra_ip_address>。
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/system/mint-org-specific-system-schedulers.txt > /tmp/mint-org-specific-system-schedulers.txt
    
    <installati>on-root/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-system-schedulers.txt
  2. 重新啟動管理伺服器。
OPDK-1878 無法在多個資料中心安裝作業中設定 Pod 名稱
Edge 安裝指南指定在多個資料中心安裝作業的無訊息安裝檔案中,將 Pod 名稱設為「gateway-1」和「gateway-2」。不過,如果重新命名 Pod,路由器和訊息處理器就無法正確註冊及存取。這個問題也會導致 setup-org.sh 指令碼無法找到可用的訊息處理器。

解決方法是在兩個資料中心的無訊息安裝檔案中,使用 MP_POD 屬性將 Pod 名稱設為「gateway」。
OPDK-1886

節點無法存取本機 IP 位址,例如 192.168.x.y
嘗試存取本機 IP 位址時,系統顯示「connect EINVAL」錯誤。
解決方法是編輯訊息處理器節點上的 /<install_dir>/apigee4/conf/apigee/message-processor/nodejs.properties 檔案,將下列行註解排除:

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

然後重新啟動訊息處理器節點:

<install_dir>/apigge4/bin/apigee-service message-processor restart 
OPDK-1958 升級時,所有節點都必須存取管理伺服器上的通訊埠 8080
在執行階段,下列元件必須存取管理伺服器上的通訊埠 8080: 路由器、訊息處理器、UI、Postgres 和 Qpid。不過,升級時,所有節點都必須存取管理伺服器上的通訊埠 8080,包括 Cassandra 和 Zookeeper 節點。
OPDK-1962 升級後必須重新設定 Edge API 的 SSL
如果您在升級至 4.15.07.00 之前,已將 Edge API 設為使用 SSL,則必須在升級後重新設定 SSL。如要瞭解如何為 Edge API 設定 SSL,請參閱 Edge 作業指南。