您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
我們在 2015 年 5 月 19 日 (星期二) 發布了 Apigee Edge for Private Cloud 的季版。
舊版產品名稱「Apigee Edge On-premises」或「OPDK」現在改為「Apigee Edge for Private Cloud」。
如有任何問題，請與 Apigee Edge 支援團隊聯絡。
如需所有 Apigee Edge 版本資訊的清單，請參閱「Apigee 版本資訊」。
新功能和強化項目
這個版本的新功能和強化功能如下。
OpenLDAP - 安裝和升級
對於新安裝和升級安裝作業，Edge 現在只支援 OpenLDAP 伺服器。
API 服務
以下是 Edge API 服務的新功能和強化功能。
WebSocket
為啟用網頁用戶端與伺服器之間的即時網頁通訊，Edge 支援 WebSocket 通訊協定。在 WebSocket 通訊中，Edge 可以扮演用戶端或伺服器的角色。如要瞭解如何在 Edge 中設定及使用 WebSocket，請參閱「Apigee Edge for Private Cloud Using WebSockets」指南。
API 管理服務支援外部驗證提供者
Edge 會與 Active Directory 和其他外部驗證供應商/LDAP 系統整合，這些系統包含您的 API 管理使用者。詳情請參閱「Edge for Private Cloud 外部驗證設定」指南。
管理 UI 中的合作品牌
您可以與 Apigee 標誌並列顯示自訂標誌，共同宣傳 Edge 管理 UI。詳情請參閱 Apigee Edge for Private Cloud Operations Guide 中的「Adding a custom logo to the Apigee UI menu」(在 Apigee UI 選單中新增自訂標誌)。
Trace 中的 Node.js 記錄
偵錯 Node.js API Proxy 時，您可以在 API Proxy 編輯器的「追蹤記錄」檢視畫面中啟用 Node.js 記錄功能。如要啟用這項功能，請在安裝作業的 apigee-base.conf 或 apigee-onpremise.conf 檔案中，設定 apigee.feature.disableNodeJSLogs="false"。如要進一步瞭解 Node.js 記錄，請參閱「偵錯及排解 Node.js Proxy 的問題」。
密碼過期
在 Edge 4.15.01.x 中，Edge 密碼會在 30 天後自動過期。也就是說，使用者必須在密碼到期前變更密碼，否則將無法登入。不過，這也導致系統管理員的密碼過期，因此系統管理員無法登入 Edge。
升級至 4.15.04.00 版後，密碼預設不會過期。如有需要，您可以使用 /opt/apigee4/bin/apigee-enable-pwlockout.sh 指令碼，設定 Edge 密碼的有效期限。詳情請參閱 Apigee Edge for Private Cloud Operations Guide。
限制系統管理員存取特定電子郵件網域
您可以限制只有特定電子郵件網域的使用者，才能擔任系統管理員或系統管理員唯讀角色。如要啟用這項功能，請按照 Apigee Edge for Private Cloud Operations Guide 中的說明，將允許的網域新增至 apigee4/conf/apigee/management-server/security.properties 檔案。
管理使用者介面錯誤訊息
管理使用者介面中的錯誤訊息顯示方式經過重新設計，可更有效率地運用螢幕空間。
新的 OAuthV2 錯誤變數
OAuthV2 政策會設定下列與錯誤相關的新變數：
- oauthV2.<policy-name>.failed - 如果政策失敗，請設為 true。
- oauthv2.<policy_name>.<fault_name> - The name of the fault. 例如 invalid_request
- oauthv2.<policy_name>.<fault_cause> - 錯誤原因。 例如：權杖已過期
請參閱 http://apigee.com/docs/api-services/content/oauthv2-policy。
建立產品
建立新產品時，除了顯示名稱，現在還可指定產品名稱。
請參閱 http://apigee.com/docs/developer-services/content/creating-api-products。
從機構移除使用者的 UI
在 UI 的「機構使用者」頁面中，「刪除」按鈕已替換為「移除」按鈕。 這樣做是為了清楚說明，從機構移除使用者後，該使用者的 Apigee 帳戶仍會保持有效。
請參閱 http://apigee.com/docs/api-services/content/managing-organization-users。
管理 UI 中的篩選選項
在管理 UI 的「API Proxies」、「Products」、「Developers」和「Apps」頁面中，您可以使用新的篩選選項進行搜尋。
離線追蹤工具
離線追蹤工具可讓您查看及分析先前儲存的追蹤記錄工作階段。儲存的追蹤工作階段基本上是追蹤工作階段的「記錄」，可用於需要疑難排解和進一步分析的情況。離線追蹤工具的 UI 與「即時」追蹤工具類似。
詳情請參閱「使用離線追蹤工具」。
使用者設定中顯示的使用者角色
在管理 UI 的「使用者設定」頁面 (使用者名稱 >「使用者設定」)，現在會顯示使用者的角色。
強化 Edge 管理使用者介面
這個版本在 Edge 管理使用者介面中，進行了多項小幅改善，提升可用性和一致性。
數據分析服務
以下是 Edge Analytics Services 的新功能和強化項目。
可查看六個月的資料
使用管理使用者介面或 API 產生數據分析報表時，系統預設不會提供距離目前日期超過六個月的資料。如要存取六個月前的資料，請與 Apigee Edge 支援團隊聯絡。
已將變數新增至數據分析
下列新變數會傳遞至 Edge Analytics，並顯示在 API 代理追蹤視窗的 AX 階段。
- apigee.edge.execution.is_target_error - 可讓您判斷 API 錯誤是不成功的 HTTP 回應的目標端錯誤 (值為「1」) 或非目標錯誤 (值為「0」)。如果 HTTP 回應成功，這個值會是空值。
-
apigee.edge.execution.is_policy_error - 可讓您判斷政策是否失敗 (值為「1」)，或在不成功的 HTTP 回應中沒有任何政策失敗 (值為「0」)。如果 HTTP 回應成功，這個值會是空值。
下列相關變數提供詳細資料，說明最先失敗的政策。如果沒有任何政策失敗，這些值會是空值。- apigee.edge.execution.fault_policy_name - 失敗的政策名稱。
- apigee.edge.execution.fault_flow_name - 政策中失敗的流程名稱 (例如 PreFlow、PostFlow 或使用者定義的流程)。
- apigee.edge.execution.fault_flow_state：政策在流程中附加的位置。可能的值包括：PROXY_REQ_FLOW、TARGET_REQ_FLOW、TARGET_RESP_FLOW、PROXY_RESP_FLOW。
資訊主頁
- API、開發人員、產品和開發人員應用程式的成效圖表已移至其他位置。這些資訊過去會顯示在這些實體的主要頁面底部。如要存取圖表，請選取各頁面頂端的「Analytics」分頁標籤。
- 這個版本包含下列現有或新資訊主頁的重大更新：
- Apigee 資訊主頁 (修訂版)：包含三種指標圖表：Proxy 流量、開發人員參與度和開發人員應用程式。每個圖表都提供「更多詳細資料」檢視畫面，可讓您深入瞭解各項指標。請參閱 Apigee 資訊主頁。
- Proxy 效能 (新)：顯示 API Proxy 流量模式和處理時間。取代 API Proxy 效能資訊主頁。請參閱「API Proxy 效能」。
- 流量構成 (修訂)：資訊主頁的外觀、風格和內容全面修訂。評估主要 API、應用程式、開發人員和產品對整體 API 計畫的相對貢獻。請參閱「流量構成」。
- 錯誤分析 (修訂版)：全面修訂外觀和內容。顯示 API Proxy 和目標的錯誤率。請參閱錯誤代碼分析資訊主頁。
-
這些現有資訊主頁已重新命名：
開發人員服務
以下是 Edge 開發人員服務的新功能和強化功能。
SmartDocs 支援 Swagger 2.0
SmartDocs 支援匯入 Swagger 2.0 規格文件，並維持與 Swagger 1.2 的回溯相容性。後續版本將支援安全機制物件和集中式結構定義。
營利
以下是 Edge 營利功能的新功能和強化項目。如要進一步瞭解營利，請參閱「已知問題」一節。
公司和開發人員的處理方式不同
公司和開發人員現在會分開處理，因此您可以更靈活地為開發人員新增多間公司，以及為公司新增多位開發人員。管理使用者介面現在提供「公司」和「開發人員」的個別視窗 (可從「發布」選單存取)。
請參閱「管理公司和開發人員」。
在營利報表中，公司仍是主要篩選器，但篩選器標籤已從「開發人員」變更為「公司」。
修正錯誤
這個版本修正了下列錯誤。
| 問題 ID | 說明 |
|---|---|
| OPDK-954 | 4.15.01 Cassandra 架構未升級 |
| MGMT-1986 | 新增開發人員時發生使用者介面錯誤 |
| MGMT-1983 | 取得 OAuth 2.0 授權碼 API 會傳回錯誤狀態 |
| MGMT-1962 | 使用高強度密碼登入管理 UI 時發生錯誤 使用特定特殊字元 (例如百分比符號) 登入 UI 時，不會再發生登入失敗的問題。 |
| MGMT-1894 | 「開發人員應用程式」頁面無法載入「開發人員」欄 |
| MGMT-1872 | 無法下載自訂報表 |
| MGMT-1777 | 無法新增電子郵件地址的頂層網域為 .acn 的使用者 |
| MGMT-1362 | 如果電子郵件地址含有「_」，系統將無法傳送「忘記密碼」電子郵件 修正私人雲中含有底線的電子郵件地址無法重設密碼的問題。 |
| CORERT-613 | 安全資料傳輸層握手失敗，原因為「unrecognized_name」 |
| APIRT-1346 | OAuth2.0 - Hashed value is returned in access token response when hash.oauth.tokens.enabled is true |
這個版本也包含下列版本的錯誤修正項目：
| Edge Cloud | Edge for Private Cloud |
|---|---|
已知問題
這個版本有下列已知問題。
| 問題 ID | 說明 |
|---|---|
| 不適用 |
發布版本未包含安裝程式在營利安裝或升級時使用的兩個 Cassandra 指令碼。 如要解決這個問題，請在安裝或升級 Cassandra 後執行下列指令，完成營利安裝/升級：
|
| CORERT-318 | 如果 API 呼叫的酬載很大 (數百 KB)，有時可能會停止回應。如要解決這個問題，請在 router.properties 檔案中設定下列屬性值：HTTPServer.streaming.buffer.limit=0 (預設設定為 10) |