4.17.09 - Edge for Private Cloud 版本資訊

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

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

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

版本總覽

這個版本最重要的功能是新增支援安全宣告標記語言 (SAML) 2.0，做為 Edge、API BaaS 和開發人員服務入口網站的驗證機制。搭配使用 SAML 和 Edge，除了支援您提供的任何其他服務 (也支援 SAML) 之外，還能支援 Edge UI 和 API 的 SSO。

SAML 驗證具有多項優點，使用 SAML 可讓您：

• 全面掌控使用者管理。使用者離開貴機構並集中取消佈建後，系統會自動拒絕他們存取 Edge。
• 控管使用者存取 Edge 時的驗證方式。您可以為不同的 Edge 機構選擇不同的驗證類型。
• 控管驗證政策。SAML 提供者可能支援更符合企業標準的驗證政策。
• 您可以監控 Edge 部署作業的登入、登出、登入嘗試失敗次數和高風險活動。
• 請注意，SAML 僅用於驗證。授權仍由 Edge 使用者角色控管。

詳情請參閱「在 Edge for Private Cloud 上支援 SAML」。

這個版本也包含許多其他重要功能，包括：

• 可將開發人員服務入口網站從 Apache/MySQL 遷移至 Postgres/Nginx
• 在 Edge UI 中停用 TLS 的指令
• 用於設定 Edge 安裝作業的新屬性
• 自訂用戶端金鑰和密鑰的命名規則
• 支援 Red Hat/CentOS 7.4 版

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

淘汰與停用

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

淘汰項目

Apigee 安全儲存空間 (保管庫) 即將淘汰

Apigee 安全儲存庫 (也稱為「保管庫」) 即將淘汰，並於 2018 年 4 月停用。保險箱提供鍵/值配對的加密儲存空間，可透過管理 API 建立，並在執行階段使用 apigee-access Node.js 模組中的函式存取。

請改用加密的鍵/值對應 (KVM)，如「使用鍵/值對應」一文所述。加密 KVM 與密碼庫一樣安全，且提供更多建立和擷取選項。(MGMT-3848)

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

在這次發布版本之前，您可以在管理 UI 中前往 API 代理項目，然後前往「成效」分頁，在代理項目的「成效」分頁和「商務交易」資訊主頁中，為圖表式比較建立不同路徑。這項功能已淘汰，無法再透過使用者介面使用。如需這項功能的替代方案，請參閱下列 Apigee 社群文章：Business Transactions API 的替代方案。 (EDGEUI-902)

新功能與最新消息

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

私有雲

Edge、API BaaS 和開發人員服務入口網站新增 SAML 支援

Edge 現在支援安全宣告標記語言 (SAML) 2.0，可做為 Edge、API BaaS 和開發人員服務入口網站的驗證機制。SAML 支援單一登入 (SSO) 環境。使用 SAML 除了可支援 Edge 的 SSO，還能支援您提供的任何其他服務，前提是這些服務也支援 SAML。

請參閱「在 Edge for Private Cloud 上支援 SAML」。

新增 apigee-ssoadminapi.sh 公用程式

啟用 SAML 後，您現在可以使用新的 apigee-ssoadminapi.sh 執行許多管理工作，例如建立使用者和機構。

請參閱「使用 apigee-ssoadminapi.sh」一文。

(DOS-5118)

現在可將 Developer Services 入口網站從 Apache/MySQL/MariaDB 遷移至 Nginx/postgres

以 .tar 為基礎安裝的開發人員服務入口網站會使用 Apache 和 MySQL 或 MariaDB。 您現在可以遷移現有的入口網站安裝作業，改用 Nginx 和 Postgres。如要更新至入口網站 4.17.09 版，就必須進行這項遷移作業。

請參閱將以 tar 為基礎的入口網站轉換為以 RPM 為基礎的入口網站。

新增對 Red Hat/CentOS 7.4 版的支援

您現在可以在 Red Hat/CentOS 7.4 版上部署 Edge for Private Cloud、API BaaS 和開發人員服務入口網站。

請參閱「支援的軟體和版本」。

新增屬性，讓安裝程式在安裝期間檢查 CPU 和記憶體需求

Edge 安裝設定檔現在支援下列屬性：

ENABLE_SYSTEM_CHECK=y 

如果輸入「y」，安裝程式會檢查系統是否符合所安裝元件的 CPU 和記憶體需求。請參閱「安裝需求」，瞭解各元件的需求。預設值為「n」，可停用檢查。

請參閱「Edge 設定檔參考資料」。

(DOS-4772)

新增屬性，可讓您在伺服器有多個介面卡時，選取安裝程式使用的 IP 位址

如果伺服器有多個介面卡，「hostname -i」指令會傳回以空格分隔的 IP 位址清單。根據預設，Edge 安裝程式會使用傳回的第一個 IP 位址，但這可能不適用於所有情況。或者，您也可以在安裝設定檔中設定下列屬性：

ENABLE_DYNAMIC_HOSTIP=y

將該屬性設為「y」後，安裝程式會提示您選取要使用的 IP 位址，做為安裝程序的一部分。預設值為「n」。

請參閱「Edge 設定檔參考資料」。

(DOS-5117)

可透過新的 UI 選項和 API 設定 TLS

新版雲端 TLS/SSL 自助式功能現已推出 Beta 版，並以 Beta 版功能的形式在 Private Cloud 中提供。這個 Beta 版的用途如下：

• 在 UI 和 API 中建立、修改及刪除金鑰儲存區和信任儲存區
• 以 PKCS12/PFX 格式上傳 TLS 憑證
• 透過 UI 或 API 產生自行簽署的憑證
• 在 UI 中測試金鑰儲存區或信任儲存庫的有效性

如要查看這些功能的 Beta 版說明文件 (PDF)，請前往：

• 使用 Edge Cloud UI 建立金鑰儲存區和信任儲存區
• 使用 Edge API 建立金鑰儲存區和信任儲存區

如需完整詳細資料，請參閱其他說明文件 (PDF)：

• 傳輸層安全標準 (TLS) 設定選項
• 為 Cloud 設定 API 的 TLS 存取權
• 設定從 Edge 到後端的 TLS
• 更新 Cloud 的 TLS 憑證

(EDGEUI-1058)

新增密碼模糊處理指令

新增指令來產生模糊處理的密碼，讓任何元件都能產生加密密碼。您可以在 Edge 管理伺服器上使用下列指令，產生經過模糊處理的密碼：

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

輸入新密碼，然後按照提示確認。基於安全考量，系統不會顯示密碼文字。這個指令會傳回以下格式的密碼：

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

請參閱「為 Edge On Premises 設定 TLS/SSL」。

(TBD-250)

新增指令，可在變更機構使用者密碼時，將新密碼設為模糊處理

如要重設機構使用者的密碼，現在請使用 apigee-service 公用程式叫用 apigee-openldap：

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

系統會提示您輸入系統管理員密碼，然後輸入新使用者密碼。基於安全考量，系統不會顯示您輸入的密碼文字。

請參閱「重設 Edge 密碼」。

(DBS-1733)

新增指令，在 Edge UI 中停用 TLS

現在可以使用下列指令，在 Edge UI 中停用 TLS：

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

請參閱「為管理 UI 設定 TLS」。

(EDGEUI-1114)

新增屬性，可控制記錄訊息中的時間戳記格式

根據預設，訊息記錄政策建立的記錄訊息中的時間戳記格式如下：

yyyy-MM-dd'T'HH:mm:ss.sssZ

例如：

2017-05-08T13:33:00.000+0000

您可以使用 Edge 訊息處理器 上的 conf_system_apigee.syslogger.dateFormat 屬性控管格式。

請參閱訊息記錄政策。

(APIRT-4196)

在 API BaaS 安裝中新增必要 SMTP 設定參數

您現在必須在 API BaaS 安裝設定檔中使用 SMTPMAILFROM 參數。這個參數會指定 API BaaS 傳送自動電子郵件時使用的電子郵件地址，例如使用者要求重設密碼時。

請參閱「BaaS 設定檔參考資料」。

(APIBAAS-2103)

新增支援功能，允許入口網站的 Edge 路由器和 Nginx 網路伺服器存取 1000 以下的連接埠

現在，您可以使用入口網站的路由器和 Nginx 網路伺服器存取 1000 以下的通訊埠，不必以其他使用者身分執行。在先前的版本中，路由器和 Nginx 網路伺服器必須以特殊使用者身分執行，才能存取 1000 以下的通訊埠。

變更 Edge UI 記錄層級的設定方式

用於設定 Edge UI 記錄層級的屬性已變更。如要瞭解新屬性和程序，請參閱「為 Edge 元件設定記錄層級」。

(EDGEUI-886)

API 服務

自訂用戶端金鑰和密鑰的命名規則

我們已更新 為開發人員應用程式建立自訂用戶端金鑰和密鑰的命名規則和驗證。用戶端金鑰和密鑰可包含字母、數字、底線和連字號。不得使用其他特殊字元。

如要進一步瞭解如何建立自訂金鑰/密鑰，請參閱「匯入現有的用戶端金鑰和密鑰」。(MGMT-3916)

驗證金鑰儲存區和目標伺服器名稱

金鑰儲存區和目標伺服器的名稱最多可有 255 個字元，且可包含字母、數字、空格、連字號、底線和半形句號。Edge 現在會在建立時驗證這項設定。 (MGMT-4098)

修正錯誤

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

Private Cloud 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (UI)

Cloud 17.08.14 (API 管理和執行階段)

Cloud 17.07.31 (API 管理)

Cloud 17.07.17 (API 管理和執行階段)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (UI)

Cloud 17.05.22.01 (營利)

Cloud 17.05.22 (UI)

Cloud 17.05.22 (API 管理)

Cloud 17.05.08 (UI)

Cloud 17.04.22 (API 管理)

已知問題

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