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) 發布以來，已推出下列版本，並納入這個季版：

• 雲端：15.04.15、 15.04.29、15.05.27、15.06.10 和 15.06.24
• Private Cloud：4.15.04.01

可以升級至 4.15.07.00 的 Edge 版本

視目前的 Edge 版本而定，您可以：

• 直接升級至 4.15.07.00
• 逐步升級，也就是先從目前版本升級至其他 Edge 版本，再升級至 4.15.07.00。

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

從 4.15.01.x 版或舊版升級前

1. 檢查 Cassandra SSTable 版本：
   1. 將目錄變更為 /<install-root>/apigee4/data/cassandra/data。
   2. 執行 find 指令，
      > find . -name *-ic-*
      如果您執行的是 Cassandra 1.2 SSTable，結果應會傳回一組 .db 檔案。
   3. 執行下列 find 指令：
      > find . -name *-hf-*
      結果應為空白，表示沒有 hf 格式的 .db 檔案。如果沒有看到 hf 格式的檔案，代表您已完成作業，可以升級至 4.15.07.00 版。
      
      hf 格式適用於 Cassandra 1.0 SSTable。如果 hf 格式中有任何 *.db 檔案，則必須按照本程序其餘步驟所述升級 SSTable。
2. 如果發現任何 *.db 檔案採用 hf 格式，請在每個 Cassandra 節點上執行下列指令，升級 SSTable，直到所有 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 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 除了支援 SHA1，也支援 SHA2 演算法，可對 OAuth 權杖進行雜湊處理。有了新的機構層級屬性，您就能為新權杖啟用及設定雜湊，並在任何早於這項新功能的權杖上保留舊版雜湊。在 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 編輯器

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

新增「刪除 OAuth 2.0 資訊」政策

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

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

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

存取權控管政策

存取權控管政策已獲得強化，可更精細地評估 IP 位址，以便在 X-FORWARDED-FOR HTTP 標頭中含有 IP 位址時，將 IP 位址加入允許清單或拒絕清單。

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

存取實體政策中的新實體

「存取實體」政策可提供下列新實體的存取權：consumerkey-scopes、authorizationcode、requesttoken 和 verifier。詳情請參閱「存取實體政策」。

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

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

API Proxy 編輯器中移除傳統版追蹤功能

API Proxy 編輯器中的最新版 Trace 功能已從 Beta 版改為正式發布版。「存取傳統版追蹤」連結已無法使用，因此無法存取「傳統追蹤」。

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

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

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

管理使用者介面中的錯誤訊息改善項目如下：

• 管理 UI，用於在整個登入工作階段中，將所有錯誤訊息分組並顯示在 UI 上 (除非您已關閉這些訊息)。這項更新推出後，當您離開發生錯誤的頁面時，系統會自動清除錯誤訊息。(MGMT-2254)
• 管理使用者介面不會再隱藏重複的錯誤訊息。(MGMT-2242)

提升 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 Cloud 預設為此設定)，Edge 支援此設定。

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

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

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

SSL 憑證詳細資料中新增了「簽章演算法」欄位，您可以在管理使用者介面 (「管理」>「SSL 憑證」) 和管理 API (從金鑰儲存區或信任儲存區取得憑證詳細資料) 中查看。這個欄位會顯示「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 支援團隊聯絡，才能設定機構屬性。這項功能將在下一個 Private Cloud 季版中，提供給 Edge Private Cloud 客戶。

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

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

開發人員服務

這個版本包含下列 Developer Services 新功能。

SmartDocs 正式發布

SmartDocs 已從 Beta 版畢業並全面上線。更新與新功能包括：

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

如要進一步瞭解這些功能，請參閱這篇網誌文章。

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

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

Edge 中的開發人員應用程式有不會變更的內部名稱，以及可變更的顯示名稱。在管理 UI 的「開發人員應用程式」頁面 (依序點選「發布」>「開發人員應用程式」>「應用程式名稱」)，應用程式內部「名稱」會與「顯示名稱」一併顯示，方便您透過內部名稱以視覺化方式識別應用程式，進行疑難排解和 API 管理。

數據分析服務

這個版本包含下列新的 Analytics Services 功能。

保留資料的時間限制

使用管理使用者介面或 API 產生數據分析報表時，系統預設不會提供距離目前日期超過六個月的資料。如要存取六個月前的資料，請與 Apigee Edge 支援團隊聯絡。

管理 UI 將移除自訂報表的傳統版本

管理使用者介面不再提供自訂 Analytics 報表的傳統版本。

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

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

營利

這個版本包含下列營利新功能。

房價方案電子郵件通知

我們新增了「費率方案」電子郵件通知類型，讓您在開發人員達到所購量帶或套裝費率方案的特定交易或金額上限時，通知對方。詳情請參閱「使用通知範本設定通知」。

同步處理定期費用和匯總依據週期

在費率方案中，可能會有兩個不同的有效時間範圍：

• 在費率方案的「費用」分頁中設定週期性費用，決定系統何時向開發人員收取週期性費用。
• 聚合基準週期，在用量分級或套裝組合方案的費率表中定義，決定開發人員的套裝組合用量何時重設。

這兩個時間範圍現在會同步。如果費率方案中同時存在非零的週期性費用，以及量帶或套裝費率卡，則兩者都會使用週期性費用週期。舉例來說，如果每月有週期性費用，費率表組合也會每月重設 (預設為月初)。

如果沒有定期費用，系統會根據費率表中定義的匯總依據重設套裝組合。舉例來說，如果開發人員在當月 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 升級程序

如果您已在 Beta 版期間使用 SmartDocs，正式版的新功能和功能需要您在開發人員入口網站中升級 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. 設定模型修訂版本的安全性屬性。在「內容」>「SmartDocs」>「模型」頁面中，選取「安全性設定」。
   
4. 在模型設定頁面 (依序點選「內容」>「SmartDocs」)，按一下「作業」欄中的「設定」，即可查看任何預先設定的驗證。
   
5. 更新所有自訂範本，使用 CSS 和 JS 資產的第 6 版，並進行變更，以反映任何新的物件名稱，例如 authSchemes 和 apiSchema。如要瞭解如何更新 SmartDocs 範本，請參閱「使用 SmartDocs 記錄 API」。
6. 重新算繪並發布模型修訂版本。
7. 驗證新版說明文件後，請將正式入口網站更新至 15.05.27 版本。

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

日後的功能異動和強化項目

本節將預覽預計在未來推出的功能異動和強化項目：

變更為 回應快取政策行為

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

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

未來行為：回應快取政策中的 <ExcludeErrorResponse> 元素預設為 true。這表示預設只會快取 HTTP 狀態碼為 200 到 205 的回應。如要覆寫這項行為，並快取所有狀態碼的回應，您必須明確將 <ExcludeErrorResponse> 元素設為 true。

目前解決方法： 如果是 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