4.17.01 - Edge for Private Cloud 版本資訊

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

我們已於 2017 年 1 月 25 日星期三，發布新版 Apigee Edge for Private Cloud。

自上一個 Edge for Private Cloud 功能版本推出以來，我們已推出下列版本，並納入這個功能版本：

請參閱「關於版本編號」，瞭解如何判斷您的 Edge for Private Cloud 版本是否包含特定雲端版本。

版本總覽

這個版本包含多項重要功能，可協助您進一步控管及保護 API。

共用流程和流程掛鉤可讓您建立一組可重複使用的政策和行為，並套用至多個 API Proxy。

鍵/值對應 (KVM) 原本就是 Edge 的功能，可長期保留鍵/值組合，現在則可加密，進一步提升資料安全性。

如要更靈活地控管開發人員對 API 的存取權，Edge 管理 UI 提供更多選項，可用於建立及管理 API 金鑰和密鑰 (憑證)、撤銷開發人員應用程式，以及停用開發人員。這些強化功能可讓您更輕鬆地實作 API 金鑰輪替等策略，並透過撤銷開發人員應用程式 (停用其所有金鑰) 或停用開發人員 (停用開發人員的所有應用程式和金鑰) 來停用多個 API 金鑰。

在淘汰方面，營利限制功能已停用。

本主題其餘部分將詳細說明此版本包含的所有新功能、更新和錯誤修正。

淘汰與停用

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

已停用：營利限制 (Cloud 16.10.26 UI)

營利限制功能已從管理 UI (「Admin」>「Limits」) 中移除。詳情請參閱淘汰通知，包括替代方案：http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice。(DEVRT-3259)

不再支援 RedHat/CentOS 6.5 版

如果您目前使用的是 RedHat/CentOS 6.5 版，則必須先將作業系統更新至 6.6 以上版本，才能更新至 Edge 4.17.01。

新功能與最新資訊

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

如需進一步瞭解和操作說明，請參閱 Edge for Private Cloud 說明文件。

私有雲

您可以在使用者首次存取 Edge UI 時顯示同意橫幅。同意橫幅會顯示 HTML 格式的文字，以及使用者選取後可前往登入畫面的按鈕。詳情請參閱「啟用同意橫幅」。

API BaaS 支援多個資料中心

您現在可以在多個資料中心安裝 API BaaS。詳情請參閱「API BaaS 的多資料中心安裝」。

新的 API BaaS 安裝設定參數

API BaaS 設定檔新增了兩個設定參數：

  • BAAS_CASS_DC_LIST：指定 BaaS 資料中心的區域名稱。如果是單一資料中心，請指定與 BAAS_CASS_LOCALDC 相同的值。
  • BAAS_CLUSTER_SEEDS - 指定用於定義 BaaS 叢集種子的 BaaS Stack 節點。

詳情請參閱「將 Apigee Edge 4.16.09 更新至 4.17.01」。

不再使用 apigee-service 指令執行 API BaaS 的「deploy」選項

API BaaS Stack 和 Portal 不再支援 apigee-service 指令的 deploy 選項。而是使用「configure」和「restart」選項。詳情請參閱「API BaaS 安裝」。

API BaaS 的新通訊埠規定

所有 BaaS Stack 節點現在都必須開啟通訊埠 2551，供所有其他 Stack 節點存取。如果您有多個 BaaS 資料中心，則必須能從所有資料中心的所有 Stack 節點存取通訊埠。

詳情請參閱「API BaaS 安裝」和「安裝需求」。

開發人員服務入口網站現在使用 Postgres 做為資料庫，並使用 Nginx 做為網路伺服器

對於所有新安裝，入口網站會使用 Postgres 做為資料庫，而非 MySQL 和 MariaDB。從舊版升級至 4.17.01 的客戶會繼續使用 MySQL 或 MariaDB。

4.17.01 的新安裝作業也會將 Nginx 安裝為網路伺服器。從舊版升級至 4.17.01 的客戶則會繼續使用 Apache。

開發人員服務入口網站不再預設啟用 SmartDocs

您必須在入口網站啟用 SmartDocs。如要進一步瞭解 SmartDocs，請參閱「使用 SmartDocs 記錄 API」。

現在可透過 RPM 安裝開發人員服務入口網站

開發人員服務入口網站 4.17.01 版是使用與 Edge 和 API BaaS 相同的存放區和工具，從 RPM 安裝。詳情請參閱「開發人員服務入口網站安裝」。

RPM 安裝和 .tar 更新程式使用不同的元件：

RPM-based install

.tar-based 安裝

網路伺服器

Nginx

Apache

Web root

/opt/apigee/apigee-drupal

/var/www/html

通訊埠

8079

80

資料庫

PostgreSQL

MySQL

PHP

php-fpm (FastCGI)

mod_php (與 Apache 執行中程序)

Qpid 已升級至 1.35 版

這個版本包含 Qpid 1.35 版。

Cassandra 已升級至 2.1.16 版

這個版本包含 Cassandra 2.1.16 版。

Play 升級至 2.4 版

這個版本包含 Play 2.4 UI 架構。

新增對 RedHat/CentOS 7.3 版的支援

Edge 現已支援 RedHat/CentOS 7.3 版。

Beta 版監控資訊主頁更新

Edge 監控資訊主頁 Beta 版已更新為：

  • 加入 Cassandra、Zookeeper、OpenLDAP、Postgres 和 Qpid 的新資訊主頁。
  • 將 4.16.09 中的 Influx 版本從 0.11 升級至 1.0.2。
  • 修正多項穩定性問題。

詳情請參閱「Apigee Monitoring 資訊主頁 Beta 版總覽」。

現在可以在安裝設定檔中設定 Postgres 密碼

使用 PG_PWD 屬性，在安裝設定檔中設定 Postgres 密碼。詳情請參閱「Edge 設定檔參考資料」。

啟用 EPEL 存放區

您必須啟用 Extra Packages for Enterprise Linux (或 EPEL)，才能安裝或更新 Edge。詳情請參閱「安裝需求」。

使用的指令取決於 RedHat/CentOS 版本：

  • RedHat/CentOS 7.x：
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • RedHat/CentOS 6.x：
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

使用 NSCD (名稱服務快取 Daemon) 時，停用 IPv6 的 DNS 查詢

如果您已安裝並啟用 NSCD (名稱服務快取 Daemon)，訊息處理器會執行兩次 DNS 查詢：一次針對 IPv4，一次針對 IPv6。使用 NSCD 時，必須停用 IPv6 的 DNS 查詢功能。詳情請參閱安裝需求。

如要停用 IPv6 的 DNS 查詢，請按照下列步驟操作：

  1. 在每個訊息處理器節點上，編輯 /etc/nscd.conf。
  2. 設定下列屬性：
    enable-cache hosts no

API 服務

共用流程和流程掛鉤，用於運作 API Proxy (Cloud 16.09.21)

新的「共用流程」功能可讓您在 API Proxy 中執行功能。只要將條件式政策和資源合併至共用流程，即可從任何 API Proxy 參照該流程，執行單一來源的可重複使用邏輯。舉例來說，共用流程可能會驗證 API 金鑰、防範尖峰停止，以及記錄資料。

您可以在管理 UI (「API」>「共用流程」) 中定義共用流程，然後透過兩種方式參照：

  • 在 API Proxy 中使用新的 Flow Callout 政策
    或

  • 在名為「流程掛鉤」的新構件上，位於下列位置：

    這些連接點可讓您在個別 Proxy 的主要流程點前後執行作業邏輯。您可以在管理 UI (「API」>「環境設定」>「流程掛鉤」) 中，將共用流程指派給這些流程掛鉤位置。

    • 要求：在 ProxyEndpoint PreFlow 之前，TargetEndpoint PostFlow 之後
    • 回應：在 TargetEndpoint PreFlow 之前，ProxyEndpoint PostFlow 之後

詳情請參閱「可重複使用的共用流程」和「使用流程掛鉤附加共用流程」。

加密鍵/值對應 (Cloud 16.09.21)

您可以建立加密鍵/值對應 (KVM)，用於儲存憑證或 PII/HIPAA 資料等機密資訊。這項功能與現有的 Edge 安全儲存庫 (vault) 不同，旨在取代該儲存庫，因為 vault 值只能透過 Node.js (以及 Management API) 存取。您可以使用 Node.js 或鍵/值對應作業政策，存取加密的 KVM 值。

建立加密 KVM

  • 使用現有的 KVM 管理 API。建立 KVM 時，如果您在酬載定義中加入 “encrypted”: “true”，Edge 會產生與 KVM 範圍相同的加密金鑰，並使用該金鑰加密 KVM。
  • 您無法使用鍵/值對應作業政策建立加密 KVM。您必須先使用 KVM Management API 建立已加密 KVM，才能在政策中使用。
  • 您無法加密現有的未加密 KVM。

使用加密的 KVM

  • 使用鍵/值對應作業政策，取得及更新加密的 KVM 值。
  • 取得加密金鑰值時，請在保留值的變數前加上關鍵字「private」。例如：<Get assignTo="private.secretVar">。該 private.secretVar 變數會保留解密後的值。
  • 使用政策更新值時，您不需要採取任何特殊行動。在加密的 KVM 中，系統會自動加密這個值。
  • 您也可以在 Node.js 程式碼中使用 apigee-access 模組，存取解密後的值。使用 getKeyValueMap() 函式，根據名稱和範圍擷取 KVM。傳回的物件有兩個函式：getKeys(callback) 可取得鍵名稱陣列，get(key, callback) 則可取得特定鍵的值。舉例來說，以下指令會取得名為 VerySecureKVM 的 apiproxy 範圍 KVM，並擷取 key1 的加密值：
    var apigee = require('apigee-access');
  var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy');
  encryptedKVM.get('key1', function(err, secretValue) {
  // use the secret value here
});

詳情請參閱「使用鍵/值對應」和「在 Node.js 中存取鍵/值對應」。

(APIRT-1197)

在 UI 中建立加密鍵/值對應 (16.10.26 UI)

在管理 UI (「APIs」>「Environment Configuration」>「Key Value Maps」) 中建立環境範圍的鍵/值對應 (KVM) 時，您可以使用新的「Encrypted」核取方塊建立加密 KVM。將金鑰新增至 KVM 後，加密值會在管理 UI 中顯示為星號 (*****)。在加密 KVM 中新增金鑰/值的方式，與在非加密 KVM 中新增金鑰/值的方式完全相同。雲端版本 160921 已完整支援加密 KVM 的後端。(EDGEUI-764)

API Proxy 中繼資料中包含的 OpenAPI 規格網址 (Cloud 16.09.21)

根據 OpenAPI 規格建立 API Proxy 時，OpenAPI 規格的位置會儲存在 API Proxy 中繼資料中。舉例來說，如果您使用 Management API 取得 Proxy 修訂版本的詳細資料，中繼資料會包含 OpenAPI 規格的路徑，格式如下：

"spec" : "https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"

這項強化功能支援新一代 Edge，可將 OpenAPI 規格連結至新開發人員入口網站中的 API Proxy、API 產品和 API 參考資料。(MGMT-2913)

為 SOAP Proxy 產生 OpenAPI 規格 (Cloud 16.10.05 UI)

根據 WSDL 建立「REST 到 SOAP 到 REST」Proxy 時，Edge 會根據 Proxy 資源自動產生託管的 OpenAPI 規格。您可以前往 http(s)://[edge_domain]/[proxy_base_path]/openapi.json 存取規格。不過，轉換不一定準確，因為並非所有 XML 架構規則都能在 OpenAPI 規格中表示。(EDGEUI-718)

Edge 託管的 WSDL，適用於直通式 SOAP Proxy (Cloud 16.10.05 UI)

根據 WSDL 建立「Pass-Through SOAP」Proxy 時，Edge 會託管 WSDL，並在 Proxy 中建立流程，讓您存取。您可以透過 http(s)://[edge_domain]/[proxy_base_path]?wsdl 存取託管的 WSDL，這是用戶端透過 Proxy 呼叫 SOAP 服務的新服務端點網址。(EDGEUI-718)

API Proxy 精靈中的新範例股票報價 WSDL (Cloud 16.08.24.01)

使用 API Proxy 精靈建立 SOAP 服務 API 時，範例中會提供替代股票報價 WSDL：https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL。(EDGEUI-655)

開發人員服務

使用者介面中的開發人員應用程式管理功能 (Cloud 16.10.05 UI)

Edge UI 中的開發人員應用程式管理功能經過多項強化，變得更加強大：

  • 您可以在新的「應用程式狀態」欄位中撤銷及核准應用程式 (在編輯模式下)。在檢視模式下，這個欄位也會顯示目前的應用程式狀態。如果應用程式遭到撤銷，其 API 金鑰都無法用於 API 呼叫。金鑰本身不會撤銷，如果開發人員重新獲得核准，金鑰就能再次使用。如果應用程式處於撤銷狀態，API 金鑰的「已核准」標籤會顯示為刪除線文字。
  • 開發人員應用程式詳細資料頁面現在會顯示 API 金鑰到期日，且金鑰會依到期日整理在「憑證」部分。舉例來說，沒有到期日的金鑰會與相關聯的 API 產品顯示在一個群組中，而 90 天後到期的金鑰則會與相關聯的產品顯示在另一個群組中。您無法變更現有憑證的到期日。
  • 在開發人員應用程式編輯模式中，您可以使用新的「新增憑證」按鈕，產生具有特定到期時間或日期 (或無到期日) 的 API 金鑰。建立憑證時 (或之後)，您可以新增 API 產品。
    這項功能會取代開發人員應用程式詳細資料頁面上的「重新產生金鑰」按鈕。該按鈕已移除。

這些強化功能會在使用者介面中加入 Management API 已提供的功能。 (EDGEUI-104)

在 UI 中啟用/停用應用程式開發人員 (Cloud 16.10.05 UI)

您可以在 Edge UI (「Developer Details」頁面、編輯模式、「Activate/Deactivate」按鈕) 中，將應用程式開發人員的狀態變更為「有效」或「無效」。開發人員處於停用狀態時，其開發人員應用程式 API 金鑰或使用這些金鑰產生的 OAuth 權杖，在呼叫 API Proxy 時均無效。(EDGEUI-304)

UI 中未使用的開發人員指標 (16.10.26 UI)

如果應用程式開發人員設為「Inactive」，即使開發人員的應用程式和憑證仍處於「Approved」狀態，也會失效。現在，在管理 UI 中查看停用開發人員的應用程式和憑證時，應用程式和憑證上的「已核准」狀態標籤會以刪除線文字顯示，且滑鼠游標懸停在標籤上時，會顯示開發人員已停用的工具提示。如果開發人員恢復為「有效」狀態，其核准的應用程式和憑證會再次生效，且「已核准」標籤上的刪除線文字會移除。(EDGEUI-728)

Analytics 服務

重新命名「錯誤代碼分析」資訊主頁 (16.10.26 UI)

「錯誤分析」資訊主頁已重新命名為「錯誤代碼分析」。資訊主頁包含 HTTP 狀態碼為 4xx 和 5xx 的 API 呼叫。(EDGEUI-738)

Proxy 資訊主頁上的 TPS 資料 (16.10.26 UI)

每秒平均交易次數 (「平均 TPS」) 的資料已新增至 Proxy 流量主資訊主頁。此外，將滑鼠游標懸停在「Proxy Traffic」和「Proxy Performance」圖表上的個別資料點時，工具提示會顯示該時間間隔的每秒交易數。(EDGEUI-668)

Analytics 錯誤顯示 (16.10.26 UI)

當數據分析資訊主頁收到 500 錯誤時，管理 UI 會顯示「報表逾時」，無論錯誤為何。為提供更完善的疑難排解功能，使用者介面現在會顯示實際錯誤。(EDGEUI-753)

修正錯誤

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

Edge for Private Cloud 4.17.01

問題 ID 說明
APIBAAS-1990 當 smtp.auth 為 false 時，API BaaS Stack 不會再嘗試向 SMTP 進行驗證
APIRT-3032

執行「apigee-service baas-usergrid restart」指令現在也會執行「configure」

您不必再針對 BaaS Stack 執行「apigee-service baas-usergrid configure」，然後再執行「apigee-service baas-usergrid restart」。
APIRT-3032

如果主機名稱是 IP 位址，請勿執行 DNS 查詢。
DOS-4070

「apigee-all -version」現在會顯示 edge-mint-* RPM 的版本
DOS-4359

新增「pdb」選項，僅安裝 Postgres 資料庫。

僅在安裝 Developer Services 入口網站時使用。 請參閱「安裝開發人員服務入口網站」。

Cloud 16.10.26 (UI)

問題 ID 說明
EDGEUI-768 無法使用 StockQuote WSDL 建立 Proxy

Cloud 16.09.21_9

問題 ID 說明
MGMT-3674 無法為啟用 HIPAA 的組織建立加密 KVM 或 Vault
MGMT-3647 電子郵件地址含有大寫字母的使用者，在存取使用者角色時會收到 403 錯誤訊息

Cloud 16.09.21

問題 ID 說明
APIRT-3507 JavaScript 服務呼叫發生間歇性錯誤 (例如 SNI 錯誤)
APIRT-3408 MP 版本 160817 apigee-access 數據分析模組處理訊息的方式不同
APIRT-3390

更新存取權杖政策傳回的錯誤回應有所變更
APIRT-3389
APIRT-3381 客戶正式環境 Proxy 延遲時間過長
APIRT-3366 所有新試用組織的 JavaScript 政策都失敗
APIRT-3363 剖析無效網址時，傳回 500 狀態和 ApplicationNotFound
APIRT-3356 OAuth 無效權杖訊息
APIRT-3355 OAuth Proxy 間歇性發生 403 錯誤
APIRT-3285
APIRT-3261 憑證會根據正式環境中的其他開發應用程式進行驗證
APIRT-3234 Node.js 應用程式傳回 NPE
APIRT-3223 Apigee 快取過時問題
APIRT-3193 Node.js 目標伺服器在移至 ASG 後停止運作
APIRT-3152 cachedlogs 管理呼叫導致記錄訊息中斷
APIRT-3117 MP 的 CPU 使用率達到 100%，並停止提供流量
APIRT-3064 路由器 - 路由器的自訂 503 錯誤訊息
APIRT-2620 為部分封鎖步驟建立獨立執行緒集區，改善負載處理
CORESERV-774 使用有效金鑰和無效 apiproduct 參照存取，導致內部伺服器錯誤

Cloud 16.10.05 (UI)

問題 ID 說明
EDGEUI-697 報表頁面匯出按鈕
「匯出」按鈕已從「自訂報表」首頁移除。每個自訂報表頁面都提供報表匯出功能。

Cloud 16.08.24.01

問題 ID 說明
EDGEUI-663 為 Weather.wsdl 的 WeatherHttpGet 通訊埠產生的 Proxy 在執行階段失敗，並顯示 500 錯誤
為 SOAP 服務產生 API Proxy 時，API Proxy 精靈不會再顯示沒有 SOAP 通訊協定繫結的 WSDL 通訊埠。這是正常現象，因為精靈只會產生 SOAP 要求。
EDGEUI-658 SOAP WSDL 傳遞作業名稱問題
EDGEUI-653 選取「啟用 CORS」選項時，建立 Node.js API Proxy 發生錯誤
EDGEUI-648 從使用者介面發出的呼叫在 2 到 3 分鐘後逾時
EDGEUI-623 Firefox 無法使用「組織記錄」的「變更日期」按鈕
上一頁
4 月 17 日
下一頁
4 月 16 日