4.15.07.00 - Apigee Edge 私有雲版本資訊

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

2015 年 9 月 8 日星期二，我們發布了主要功能版本的 Apigee Edge 不公開功能 Cloud 上精進自己的技能。

自舊版 Private Cloud 的每季版本 (4.15.04.00) 以來，以下是

• 雲端：15.04.15、 15.04.29、15.05.27、15.06.10 和 15.06.24
• 私有雲：4.15.04.01

您可以升級至哪些 Edge 版本 4.15.07.00

視現行的 Edge 版本而定，您可以採取下列其中一種做法：

• 直接升級至 4.15.07.00
• 逐步升級，意即您必須從目前版本升級至其他版本 ，請升級至 4.15.07.00。

詳情請參閱 Cloud Edge for Private Cloud 版本可以升級到哪些 Edge 版本。 4.15.07.00.

從 4.15.01.x 版或舊版升級之前

1. 檢查 Cassandra SSTable 版本：
   1. 將目錄變更為 /<install-root>/apigee4/data/cassandra/data。
   2. 執行尋找指令，
      >尋找 。-name *-ic-*
      若您執行 Cassandra 1.2 SSTable，結果應會傳回一組 .db 檔案。
   3. 執行以下尋找指令：
      >尋找 。-name *-hf*
      結果應該是空白的，表示沒有任何採用 hf 格式的 .db 檔案。如果 hf 格式，那麼 並升級至 4.15.07.00。
      
      hf 格式為 Cassandra 1.0 SSTables。如果有任何 hf 格式的 *.db 檔案， 升級 SSTable。
2. 如果發現任何格式為 hf 的 *.db 檔案，請升級 SSTable 方法是在每個 Cassandra 節點上執行下列指令，直到升級所有 Cassandra 為止 節點數：
   &gt; /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost 升級資料表 -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 樣式穩定版：
   &gt;cd /&lt;install-root&gt;/apigee4/data/cassandra/data
   &gt;尋找 。-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)

SmartDoc 安裝

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

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

如果設定 ENABLE_CASS_AUTH、CASS_USERNAME 和 CASS_PASSWORD 環境變數。(OPDK-1309)

Edge 平台

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

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

支援 OAuth 權杖雜湊的 SHA2

為了在資料庫出現安全性漏洞的情況下，為 OAuth 憑證提供更完善的保護，Edge 支援 SHA2 雜湊 OAuth 權杖 (除了 SHA1 以外) 的演算法。以全新或高層級程度為依據 則可為新符記啟用及設定雜湊，並保留舊版的雜湊 套用該功能先前使用 Edge for Private Cloud keymanagement.properties 檔案 (位於 管理伺服器和訊息處理工具) 啟用 OAuth 權杖的自動 SHA1 雜湊。這個 屬性。

如果您之前使用 hash.oauth.tokens.enabled 屬性啟用 SHA1 雜湊， 這個版本的升級指令碼會自動為您產生新的機構層級屬性。目的地： 升級後驗證，請使用這個 API 以系統管理員的身分執行 GET： https://{host}:{port}/v1/o/{your_org}.

• 如要瞭解如何透過新屬性為貴機構啟用權杖雜湊功能，請參閱 「資料庫中的雜湊權杖」要求存取權杖 主題。
• 如要瞭解如何大量雜湊處理現有權杖，請參閱 Private Cloud 專用 Edge 作業指南。(APIRT-1389)。

記錄檔的平面目錄結構

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

環境快取效能

如要妥善管理記憶體內快取和使用率，請參閱「記憶體中的元素數量上限」 環境快取資源的設定已淘汰。全世界共用的 所有快取資源 (包括預設快取) 都會按照分配給 快取。根據預設，為特定訊息處理器配置的記憶體內快取記憶體總量 佔可用記憶體總量的 40% (取決於訊息中的快取屬性設定) 處理器 cache.properties 檔案只有在符合下列條件的情況下，系統才會從記憶體內快取中移除元素： 快取記憶體不足或元素過期。

使用「記憶體中的元素數量上限」一節將做法還原為舊版行為的房源 快取管理方式，請在 overrideMaxElementsInCacheResource=false 中設定 下載快取。(APIRT-1140)。

API 服務

這個版本新增的 API 服務功能如下：

預設使用新的 Proxy 編輯器

根據預設，管理使用者介面會啟用新的 API Proxy 編輯器。新版編輯器提供以下功能： 許多可用性都提高，包括更全面地檢視條件式流程和 「總覽」頁面上的端點、「開發」頁面上的所有設定，以及 條件式流程、端點和政策，較完整的 XML 檢視畫面，而非小片段 搜尋可檢索檔案名稱和文字等內容。(MGMT-2279)

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

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

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

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

存取權控管政策

強化了存取權控管政策，以便更精細的 IP 位址評估 X-FORWARDED-FOR HTTP 標頭。

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

存取權實體政策中的新實體

存取實體政策提供下列新實體：取用端金鑰範圍、 Licensecode、requesttoken 和 verifier.詳情請參閱存取實體政策。

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

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

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

API Proxy 編輯器中的最新版 Trace 功能已從 Beta 版移至 Beta 版 正式發布版。存取「傳統追蹤記錄」「存取傳統版追蹤記錄」 連結。

透過管理 UI 說明選單存取 Apigee 社群的權限

您可以透過管理 UI 說明選單存取 Apigee 社群。

管理平台 UI 中的錯誤訊息

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

• 管理 UI 用於分類及顯示整個使用者介面上的所有錯誤訊息 持續登入工作階段，除非您關閉這些邀請。本次更新後，系統將清除錯誤訊息 當使用者離開原本所在的網頁時，就會自動啟動。(MGMT-2254)
• 管理 UI 不會再隱藏重複的錯誤訊息。(MGMT-2242)

UI 效能和錯誤改善項目

我們針對管理 UI 的各方面改進了一般強化功能，包括顯示頁面 效能和錯誤訊息清除

管理 UI 中的「機構使用者」頁面角色超連結

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

訊息流程中的新目標變數

訊息流程中的新變數可為目標端點和 目標伺服器：

• TargetEndpoint：request.url 取代 target.basepath.with.query。
• TargetServer：loadbalancing.targetserver 取代 targetserver.name。 此外，target.basepath 只會在 會在 TargetEndpoint 的<Path> HTTPTargetConnection <LoadBalancer> 元素。

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

Edge 支援使用「伺服器名稱指示」向南傳送 (從訊息處理器到目標連線) 端點)。如要使用 SNI，請與 Apigee 支援聯絡。

必須使用 Java 1.7。

使用 SNI 做為 TLS/SSL 的擴充功能，可在同一處提供多個 HTTPS 目標 IP 位址和通訊埠，這些目標不必使用相同的憑證。

不需要特有設定。如果您的環境設定為向南 SNI (預設為邊緣雲端)，Edge 支援此架構。

Edge 會自動從要求網址擷取「主機名稱」， 即可將該要求新增至 SSL 握手要求。舉例來說，如果目標主機是 https://example.com/request/path，則 Edge 會新增 server_name 擴充功能，如下所示 如下：

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

「Signature Algorithm」(簽名演算法)在「SSL 憑證詳細資料」中

全新的「簽名演算法」] 欄位將新增至 SSL 憑證詳細資料，可在 管理 UI (Admin > SSL 憑證) 和 management API (取得 來自 KeyStore 或 Truststore 的認證詳細資料)。這個欄位會顯示「sha1WithRSAEncryption」 或「sha256WithRSAEncryption」，視用來產生 憑證

顯示即將到期的 SSL 憑證

管理使用者介面的「SSL 憑證」頁面 ([管理員] > [SSL 憑證]) 會指出何時 SSL 憑證的有效期限為 10、15、30 或 90 天，視您在 新的到期下拉式選單欄位。

威脅防護錯誤設定

根據預設，Edge 會擲回 HTTP 500 內部伺服器錯誤狀態碼和執行失敗 錯誤。您可以 而是用新的機構層級資源引發錯誤行為設定機構時 將 features.isPolicyHttpStatusEnabled 屬性設為 true，則在以下 行為發生：

• 要求：附加威脅防護政策到任何要求流程時，無效的訊息 會傳回 400 狀態碼和對應的政策錯誤訊息。
• 回應：在任何回應流程中附加威脅防護政策，無效的訊息 仍然會傳回 500 狀態碼，而系統會擲回其中一項相應的政策錯誤訊息 (而非只有 ExecutionFailed)。

雲端客戶必須聯絡 Apigee 支援，將 Edge Private Cloud 客戶才能使用這項功能。 每季發布私有雲。

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

已為非政策實體更新參考結構定義，例如 TargetEndpoint、 ProxyEndpoint、APIProxy 等許多其他引擎。請參閱 https://github.com/apigee/api-platform-samples/tree/master/schemas。 (APIRT-1249)。

開發人員服務

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

SmartDoc 正式發布

SmartDoc 已從 Beta 版升級為正式發布版。更新與新功能 包括：

• 支援 Swagger 2.0，包括以檔案或網址匯入，以及支援下列功能： 並採用自訂名稱的安全物件
• 改善產生 SmartDoc 的範本視覺設計。
• 開發人員入口網站的可用性和工作流程改善項目，歡迎透過「內容」存取 &gt;Drupal 的「SmartDoc」選單。
• 稱為「自訂權杖」驗證功能現已改稱「API 金鑰」。
• 驗證「安全性」物件狀態。
• 在範本層級設定用戶端驗證。不會再重設新的修訂版本 任何預先設定的 SmartDoc 用戶端憑證。

如需更多功能說明，請參閱此網誌 文章。

如需 SmartDoc 文件，請參閱使用 SmartDoc 建立文件 API

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

Edge 中的開發人員應用程式同時含有不會變更的內部名稱，以及具有下列顯示名稱的顯示名稱： 以及變更在管理使用者介面的「開發人員應用程式」頁面中 (「發布」>「開發人員應用程式」>「 應用程式名稱)，應用程式內部的「名稱」資訊會與 [顯示名稱] 一起顯示，方便您 依內部名稱視覺化辨識應用程式，以便進行疑難排解及管理 API 管理作業。

Analytics 服務

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

保留數據用量上限

透過管理 UI 或 API 產生數據分析報表時，超過六個月的資料 根據預設，當前日期的起算日期後即無法存取。如需存取 6 歲以上的資料 請洽詢 Apigee 支援團隊。

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

(選用) 傳統版自訂分析報表，在 管理 UI

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

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

營利

這個版本新增的營利功能如下。

房價方案電子郵件通知

新的費率方案電子郵件通知類型，可讓你在開發人員達到特定數量時，通知他們 已購買的磁碟區/套裝組合費率方案中的交易或金額限制適用對象 詳情請參閱設定 透過通知範本接收通知

週期性費用和匯總計算週期的同步處理

在費率方案中，可能套用了兩個不同的時間範圍：

• 週期性費用期間 (在費率方案的「費用」分頁中設定)， 開發人員須支付週期性費用。
• 匯總基準週期 (在磁碟區頻帶或套裝組合方案的價目表上定義)， 為開發人員重設套件後所判斷。

現在已同步這兩個經期。同時購買非零的週期性費用和 Volume 頻帶時 或套裝組合價目表所含的費率，都會使用週期性收費週期。例如： 如果有每月週期性費用，則價目表組合也會每月重設 (根據預設， 每月月初)。

如果沒有週期性費用，系統會根據 價目表舉例來說，假設開發人員在每個月的 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 呼叫中的自訂屬性陣列會經過網址編碼。

SmartDoc 升級程序

如果您在 Beta 版測試期間已使用 SmartDoc，您可以啟用新功能 如要使用正式發布版，您必須先升級開發人員的 SmartDoc 入口網站。

已在開發人員入口網站發布的任何 SmartDoc 頁面將繼續 不過，您必須先按照更新程序操作，才能修改或發布任何現有變更 或新網頁

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

如何從 SmartDoc Beta 版升級為正式發布版

1. 更新並測試 15.05.27 版本： 為 dev 或 test 環境 Pantheon。
2. 建立新模型以取代目前使用的任何 API 模型。
   • 如果您已匯入 Swagger 或 WADL 文件，請再次匯入新的文件 修訂版本。
   • 如果您已透過 SmartDoc 模組維護 API 模型，請將 SmartDoc JSON，使用檔案附件匯入新模型。
3. 設定模型修訂版本的安全性屬性。在「內容」> 智慧文件 >模型頁面中，選取安全性設定。
   
4. 在模型設定頁面檢查所有預先設定的驗證 (內容 > SmartDoc)，方法是按一下作業部分中的設定 。
   
5. 更新所有自訂範本，使用 CSS 和 JS 素材資源第 6 版，並配合 任何新的物件名稱 (例如 authSchemes 和 apiSchema)。如要瞭解如何更新 SmartDoc 如需範本，請參閱使用 利用 SmartDoc 來記錄 API。
6. 重新轉譯並發布模型修訂版本。
7. 驗證新文件後，請更新 production 入口網站，並連結到 15.05.27 版本。

如果您是 Edge 企業客戶，且對升級作業有問題或疑慮， 程序，請傳送電子郵件至 marsh@apigee.com 和 cnovak@apigee.com。否則，請使用 Apigee 社群， 回應。

日後推出的功能變更和強化項目

本節預覽預計日後推出的功能異動和強化項目：

變更為 回應快取政策的行為

在未來的版本中 (待確定)， &lt;ExcludeErrorResponse&gt;回應快取政策的元素將會變更。

目前行為：元素 <ExcludeErrorResponse>的 回應快取政策預設為 false。這表示根據預設 回應快取政策會快取可能的 HTTP 狀態碼 (包括 3xx)。

未來行為：元素 <ExcludeErrorResponse>的 回應快取政策預設為 true。這表示根據預設，只有在回應中含有 HTTP 時 系統會快取狀態碼 200 到 205。如要覆寫這個行為並快取所有 狀態碼，就需要將元素 <ExcludeErrorResponse> 設為到 。

目前解決方法： 適用於 Private Cloud 4.15.07.00 以下版本 (如有) 當您只想快取狀態碼為 200 到 205 的回應時，必須明確地將 元素 <ExcludeErrorResponse>設為 true

修正錯誤

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

已知問題

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

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
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 
************************************** 

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