您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
我們在 2015 年 5 月 19 日星期二發布了每季版本的 Apigee Edge (適用於私有雲)。
舊產品名稱中的「Apigee Edge On-地端部署」或「OPDK」現已更名為「Apigee Edge for Private Cloud」。
如有任何問題，請前往 Apigee 客戶服務頁面。
如需所有 Apigee Edge 版本資訊的清單，請參閱 Apigee 版本資訊。
新功能和強化項目
這個版本包含的新功能和強化項目。
OpenLDAP - 安裝與升級
OpenLDAP 是 Edge 目前唯一支援新安裝和升級安裝的 LDAP 伺服器。
API 服務
以下是 Edge API 服務的新功能和強化項目。
WebSockets
如要在網路用戶端和伺服器之間啟用即時網路通訊功能，Edge 支援 WebSocket 通訊協定。Edge 可以在 WebSocket 通訊中扮演用戶端或伺服器角色。如要瞭解如何在 Edge 中設定和使用 WebSocket，請參閱 Apigee Edge for Private Cloud 使用 WebSocket 指南。
適用於 API 管理服務的外部驗證提供者支援
Edge 可與 Active Directory 和其他包含 API 管理使用者的外部驗證供應商/LDAP 系統整合。詳情請參閱私人雲端外部驗證設定的邊緣指南。
管理使用者介面中的合作品牌功能
您可以將 Edge 管理 UI 加入品牌名稱，自訂標誌會顯示在 Apigee 標誌旁邊。詳情請參閱 Apigee Edge for Private Cloud 作業指南中的「在 Apigee UI 選單中新增自訂標誌」。
Trace 中的 Node.js 記錄
對 Node.js API Proxy 進行偵錯時，您可以在 API Proxy 編輯器的「Trace」檢視畫面中啟用 Node.js 記錄檔功能。如要啟用這項功能，請在安裝作業的 apigee-base.conf 或 apigee-onprem.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 作業指南。
限制僅限特定電子郵件網域的 sysadmin 存取權
您可以限制 sysadmin 或 sysadmin 唯讀角色的成員資格，僅限特定電子郵件網域中的使用者。如要啟用這項功能，請按照 Apigee Edge for Private Cloud 作業指南中的說明，將允許的網域新增至 apigee4/conf/apigee/management-server/security.properties 檔案。
管理 UI 錯誤訊息
管理 UI 中的錯誤訊息顯示經過重新設計，能夠更有效率地使用螢幕空間。
新的 OAuthV2 錯誤變數
下列新的錯誤相關變數是由 OAuthV2 政策設定：
- oauthV2.<policy-name>.failed：如果政策失敗，請設為 true。
- oauthv2.<policy_name>.<fault_name> - 錯誤的名稱。例如：invalid_request
- oauthv2.<policy_name>.<fault_cause> - 錯誤原因。 例如「Token Expired」
請參閱 http://apigee.com/docs/api-services/content/oauthv2-policy。
產品建立
建立新產品時，除了顯示名稱外，您現在還可以指定產品名稱。
請參閱 http://apigee.com/docs/developer-services/content/creating-api-products。
用於移除機構組織使用者的使用者介面
在 UI 的「機構使用者」頁面上，「刪除」按鈕已由「移除」按鈕取代。目的是讓使用者明確地瞭解，從機構中移除使用者時，該使用者的 Apigee 帳戶仍將維持有效。
請參閱 http://apigee.com/docs/api-services/content/managing-organization-users。
管理 UI 中的篩選選項
在管理 UI 的 API Proxy、產品、開發人員和應用程式頁面上，我們提供搜尋的全新篩選選項。
離線追蹤工具
離線追蹤工具可讓您查看及分析先前儲存的追蹤記錄工作階段。已儲存的追蹤記錄工作階段基本上是追蹤記錄工作階段的「記錄」，而且在需要疑難排解和進一步分析時相當實用。離線追蹤工具的 UI 與「即時」追蹤記錄工具相似。
詳情請參閱使用離線追蹤工具。
「使用者設定」中顯示的使用者角色
系統現在會在管理使用者介面的「使用者設定」頁面中 (使用者名稱 > 使用者設定) 顯示使用者角色。
強化邊緣管理 UI
這個版本在 Edge 管理 UI 中提供一些微小的可用性和一致性改善。
數據分析服務
以下是 Edge Analytics 服務的新功能和強化項目。
可取用 6 個月的資料
使用管理 UI 或 API 產生數據分析報表時，根據預設，無法存取 6 個月前的資料。如果您要存取超過六個月的資料，請與 Apigee 支援團隊聯絡。
變數已新增至 Analytics (分析)
下列新變數會傳送至 Edge Analytics，顯示在 API Proxy 追蹤視窗的 AX 階段。
- apigee.edge.execution.is_target_error：讓您識別 API 錯誤是目標端錯誤 (值「1」) 還是失敗 HTTP 回應 (值「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、開發人員、產品和開發人員應用程式的效能圖表已移至其他位置。原本顯示在這些實體的主頁面底部。現在，您可以選取每個頁面頂端的「數據分析」分頁標籤來存取圖表。
- 這個版本包含針對以下現有或新的資訊主頁進行重大作業：
- Apigee 資訊主頁 (修訂)：包含三個指標圖表：Proxy 流量、開發人員參與度和開發人員應用程式。每張圖表都提供「更多詳細資料」檢視畫面，可讓您深入查看各項指標。查看 Apigee 資訊主頁。
- Proxy 效能 (新功能)：顯示 API Proxy 流量模式和處理時間。取代 API Proxy 效能資訊主頁。請參閱「API Proxy 效能」。
- 流量組成 (修訂)：資訊主頁的外觀與風格經過全面修改。評估您的熱門 API、應用程式、開發人員和產品在整體 API 計畫中的相對貢獻。請參閱流量組成。
- 錯誤分析 (修訂)：全面修訂的外觀和風格與內容。顯示 API Proxy 和目標的錯誤率。請參閱錯誤代碼分析資訊主頁。
-
這些現有的資訊主頁已重新命名：
開發人員服務
以下是 Edge Developer Services 的新功能和強化項目。
Swagger 2.0 對 SmartDocs 的支援
SmartDocs 支援匯入 Swagger 2.0 規格文件，並維持與 Swagger 1.2 的回溯相容性。我們將在後續版本中支援安全配置物件和集中式結構定義。
營利
以下是 Edge 營利功能的新功能和強化項目。如要進一步瞭解營利資訊，另請參閱「已知問題」一節。
將公司和開發人員分開處理
公司和開發人員現在會分別處理，這樣不僅能靈活地為開發人員和多位開發人員加入多間公司，管理使用者介面現在為「公司」和「開發人員」(可透過「發布」選單存取) 分別提供視窗。
請參閱「管理公司和開發人員」。
在營利報表中，公司仍是主要篩選器，但篩選器標籤已從「開發人員」變更為「公司」。
修正錯誤
本次更新修正了下列錯誤。
| 問題 ID | 說明 |
|---|---|
| OPDK-954 | 4.15.01 Cassandra 結構定義未升級 |
| MGMT-1986 | 新增開發人員時發生 UI 錯誤 |
| MGMT-1983 | 取得 OAuth 2.0 授權碼 API 傳回錯誤狀態 |
| MGMT-1962 | 使用高強度密碼登入管理 UI 時發生錯誤 使用特定特殊字元 (例如百分比符號) 登入 UI 時不會再失敗。 |
| MGMT-1894 | 「開發人員應用程式」頁面一律無法載入「開發人員」欄 |
| MGMT-1872 | 無法下載自訂報表 |
| MGMT-1777 | 電子郵件地址的 TLD 是 .acn ，因此無法新增使用者 |
| MGMT-1362 | 如果電子郵件地址包含「_」，忘記密碼電子郵件地址就會失效 修正使用含有底線的電子郵件地址，解決 Private Cloud 密碼重設問題。 |
| CORERT-613 | 因「unrecognized_name」導致 SSL 握手失敗 |
| APIRT-1346 | OAuth2.0 - hash.oauth.tokens.enabled 是時，會在存取權杖回應中傳回雜湊值 |
這個版本也修正了下列版本的錯誤：
| Edge Cloud | 私有雲的邊緣 |
|---|---|
已知問題
這個版本有下列已知問題。
| 問題 ID | 說明 |
|---|---|
| 不適用 |
這個版本不包含安裝程式在營利中安裝或升級時使用的兩個 Cassandra 指令碼。 如要解決這個問題，請在 Cassandra 安裝或升級後執行下列指令，完成營利的安裝/升級作業：
|
| CORERT-318 | 含有大型酬載 (100 秒 KB) 的 API 呼叫有時可能會停止運作。如要解決這個問題，請在 Router.properties 檔案內設定以下屬性值：HTTPServer.streaming.buffer.limit=0 (預設設定為 10) |