您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
我們於 2015 年 5 月 19 日星期二發布了 Apigee Edge for Private Cloud 的季度版本。
舊版產品名稱「Apigee Edge On-premises」或「OPDK」現已改為「Apigee Edge for Private Cloud」。
如有任何疑問，請前往 Apigee 客戶服務團隊。
如需查看所有 Apigee Edge 版本資訊的清單，請參閱「Apigee 版本資訊」。
新功能和強化功能
以下是本版本的新功能和強化功能。
OpenLDAP - 安裝和升級
目前 OpenLDAP 是 Edge 新安裝和升級作業唯一支援的 LDAP 伺服器。
API 服務
以下是 Edge API Services 的新功能和強化功能。
WebSocket
為了在網路用戶端和伺服器之間啟用即時網路通訊，Edge 支援 WebSocket 通訊協定。Edge 可在 WebSocket 通訊中扮演用戶端或伺服器的角色。如要瞭解如何在 Edge 中設定及使用 WebSocket，請參閱「使用 WebSocket 的 Apigee Edge for Private Cloud」指南。
外部驗證服務供應器支援 API 管理
Edge 會整合 Active Directory 和其他外部驗證服務供應商/LDAP 系統，這些系統包含 API 管理員使用者。詳情請參閱「Edge for Private Cloud 外部驗證設定」指南。
管理 UI 中的合作品牌
您可以將 Edge 管理 UI 與自訂標誌並列，標誌會顯示在 Apigee 標誌旁。詳情請參閱 Apigee Edge 私人雲端作業指南中的「在 Apigee UI 選單中新增自訂標誌」。
追蹤中的 Node.js 記錄
在偵錯 Node.js API 代理程式時，您可以在 API 代理程式編輯器的追蹤記錄檢視畫面中啟用 Node.js 記錄功能。如要啟用這項功能，請在安裝作業中的 apigee-base.conf 或 apigee-onpremise.conf 檔案中設定 apigee.feature.disableNodeJSLogs="false"。如要進一步瞭解 Node.js 記錄，請參閱「偵錯及排解 Node.js 代理伺服器的問題」。
密碼過期
在 Edge 4.15.01.x 中，Edge 密碼會在 30 天後自動過期。也就是說，除非使用者在密碼到期前變更密碼，否則就會遭到鎖定。但這也導致系統管理員的密碼到期，因此系統管理員無法登入 Edge。
升級至 4.15.04.00 後，系統會將預設值變更為不限時。如有需要，您可以使用 /opt/apigee4/bin/apigee-enable-pwlockout.sh 指令碼，設定 Edge 密碼的到期日。詳情請參閱 Apigee Edge 私人雲端作業指南。
限制系統管理員存取特定電子郵件網域的權限
您可以限制 sysadmin 或 sysadmin 唯讀角色的成員資格，只允許特定電子郵件網域中的使用者加入。如要啟用這項功能，請按照 Apigee Edge for Private Cloud Operations Guide 的說明，將允許的網域新增至 apigee4/conf/apigee/management-server/security.properties 檔案。
管理工具使用者介面錯誤訊息
我們重新設計了管理 UI 中的錯誤訊息顯示方式，讓使用者能更有效率地運用螢幕空間。
新的 OAuthV2 錯誤變數
這些與錯誤相關的新變數是由 OAuthV2 政策設定：
- oauthV2.<policy-name>.failed：如果政策失敗，則設為 true。
- oauthv2.<policy_name>.<fault_name> - 錯誤的名稱。例如 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
在使用者介面的「機構使用者」頁面中，刪除按鈕已改為「移除」按鈕。這麼做是為了讓您清楚瞭解，當您從機構中移除使用者時，該使用者的 Apigee 帳戶仍會處於有效狀態。
請參閱 http://apigee.com/docs/api-services/content/managing-organization-users。
管理 UI 中的篩選選項
在管理使用者介面的「API Proxy」、「產品」、「開發人員」和「應用程式」頁面中，您可以使用新的篩選選項進行搜尋。
離線追蹤工具
您可以使用離線追蹤記錄工具查看及分析先前儲存的追蹤記錄工作階段。儲存的追蹤記錄工作階段基本上是追蹤記錄工作階段的「錄影」，可用於需要進行疑難排解和進一步分析的情況。離線追蹤工具的 UI 與「即時」追蹤工具類似。
詳情請參閱「使用離線追蹤工具」。
使用者設定中顯示的使用者角色
在管理介面 (使用者名稱 > 使用者設定) 的「使用者設定」頁面中，現在會顯示使用者的角色。
Edge 管理使用者介面強化功能
這個版本包含 Edge 管理使用者介面中的一些小型可用性和一致性改善項目。
Analytics 服務
以下是 Edge Analytics Services 的新功能和改善項目。
可查看六個月的資料
使用管理 UI 或 API 產生數據分析報表時，系統預設無法存取目前日期前六個月前的資料。如要存取六個月前的資料，請與 Apigee 支援團隊聯絡。
加入數據分析的變數
下列新變數會傳遞至 Edge 分析，可在 API 代理追蹤視窗的 AX 階段中查看。
- apigee.edge.execution.is_target_error：可讓您判斷 API 錯誤是目標端錯誤 (值為「1」)，還是不含目標的錯誤 (值為「0」)，以便判斷 HTTP 回應是否失敗。如果是成功的 HTTP 回應，這個值會為空值。
-
apigee.edge.execution.is_policy_error：可用於判斷在失敗的 HTTP 回應中，是否有政策失敗 (值為「1」)，或是否沒有政策失敗 (值為「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 Performance (新)：顯示 API Proxy 流量模式和處理時間。取代 API Proxy Performance 資訊主頁。請參閱「API Proxy 效能」。
- 流量組成 (修訂版)：全面修訂資訊主頁的外觀、感受和內容。評估主要 API、應用程式、開發人員和產品對整體 API 計畫的相對貢獻。請參閱「流量組成」。
- 錯誤分析 (修訂版)：完全修訂外觀和內容。顯示 API Proxy 和目標的錯誤率。請參閱「錯誤代碼分析資訊主頁」。
-
我們已重新命名下列現有資訊主頁：
開發人員服務
以下是 Edge 開發人員服務的新功能和強化功能。
Swagger 2.0 支援 SmartDocs
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 時，系統不會再發生錯誤。 |
| MGMT-1894 | 開發人員應用程式頁面永遠無法載入開發人員欄 |
| MGMT-1872 | 無法下載自訂報表 |
| MGMT-1777 | 無法新增電子郵件地址的頂層網域為 .acn 的使用者 |
| MGMT-1362 | 如果電子郵件地址含有「_」字元，系統就無法傳送忘記密碼電子郵件 修正私有雲端中含有底線的電子郵件地址重設密碼問題。 |
| CORERT-613 | 「unrecognized_name」導致 SSL 握手失敗 |
| APIRT-1346 | OAuth2.0 - 如果 hash.oauth.tokens.enabled 為 true，則會在存取權杖回應中傳回經雜湊處理的值 |
這個版本也包含下列版本的錯誤修正項目：
| Edge Cloud | Edge for Private Cloud |
|---|---|
已知問題
這個版本有下列已知問題。
| 問題 ID | 說明 |
|---|---|
| 不適用 |
發布版本未包含兩個 Cassandra 指令碼，這些指令碼是在營利安裝或升級時，由安裝程式所使用。 如要解決這個問題，請在 Cassandra 安裝或升級後執行下列指令，完成營利功能的安裝/升級：
|
| CORERT-318 | 含有大量酬載 (100 個 KB) 的 API 呼叫有時可能會停止運作。如要解決這個問題，請在 router.properties 檔案中設定下列屬性值：HTTPServer.streaming.buffer.limit=0 (預設設定為 10) |