Edge Microgateway 總覽

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

Edge Microgateway 2.4.x 版

目標對象

本主題是 Edge Microgateway 的一般介紹，適用於所有對象。

什麼是 Apigee Edge Microgateway？

Apigee Edge Microgateway 是 API 的安全 HTTP 訊息處理器。其主要工作是安全地處理來自後端服務的請求和回應，並異步將寶貴的 API 執行資料推送至 Apigee Edge，供 Edge Analytics 系統使用。Edge Microgateway 安裝和部署作業簡單，您可以在幾分鐘內啟用及執行執行個體。

通常，Edge Microgateway 會安裝在與後端目標服務相近的受信任網路中。它提供企業級安全防護，以及一些重要的外掛程式功能 (例如尖峰封鎖、配額和分析)，但不包含 Apigee Edge 的完整功能或足跡。您可以將 Edge Microgateway 安裝在相同資料中心，甚至可以安裝在後端服務所在的電腦上。

主要用途

混合雲 API 管理解決方案 (例如 Edge Microgateway) 的常見用途包括：

  • 縮短在附近執行的服務 API 流量的延遲時間。舉例來說，如果 API 使用者和供應者相距不遠，您不一定需要 API 經過中央閘道。

  • 為安全性或法規遵循目的，將 API 流量控制在企業核准的範圍內。
  • 如果網路連線暫時中斷，系統會繼續處理訊息。
  • 您也可以參閱 Apigee 社群中的這篇使用情境討論。

主要功能和優點

  • 安全性。Edge Microgateway 會使用 Apigee Edge 為每個用戶端應用程式核發的已簽署存取權杖或 API 金鑰，驗證要求。
  • 快速部署。與 Apigee Edge 的完整部署作業不同，您可以在幾分鐘內部署及執行 Edge Microgateway 例項。
  • 網路鄰近性。您可以在 Edge Microgateway 與後端目標 API 互動的相同機器、子網路或資料中心中，安裝及管理 Edge Microgateway。
  • Analytics。Edge Microgateway 會將 API 執行資料以非同步方式傳送至 Apigee Edge，再由 Edge Analytics 系統處理。您可以使用完整的 Edge Analytics 指標、資訊主頁和 API 套件。
  • 減少延遲時間。與 Apigee Edge 的所有通訊都是非同步的，不會在處理用戶端 API 要求時發生。這樣一來，Edge Microgateway 就能收集 API 資料並傳送至 Apigee Edge，而不影響延遲時間。
  • 熟悉度。Edge Microgateway 會使用並與 Edge 管理員已熟悉的 Apigee Edge 功能互動，例如 Proxy、產品和開發人員應用程式。
  • 設定：您不需要編寫程式碼，即可設定及管理 Edge Microgateway。所有內容都會透過設定處理。
  • 便利性：您可以將 Edge Microgateway 與現有的應用程式監控和管理基礎架構和程序整合。
  • 使用簡便：安裝、設定和維護都很簡單。
  • Logging。記錄檔會詳細列出 Edge Microgateway 在處理 API 時遇到的所有一般和例外事件。
  • CLI。您可以透過指令列介面啟動、停止及重新啟動 Edge Microgateway、擷取運作統計資料、查看記錄檔、要求存取權權杖等。

關於 Edge Microgateway 的須知事項

本節說明 Edge Microgateway 的運作方式、基本架構、設定和部署方式。

為什麼要使用 Edge Microgateway？

將 API 管理元件移至靠近後端目標應用程式的位置，可縮短網路延遲時間。雖然您可以在私有雲端安裝 Apigee Edge，但為了支援完整的功能組合和資料密集功能 (例如金鑰管理、營利和數據分析)，Apigee Edge 的完整部署作業必然會變得龐大且複雜。也就是說，在每個資料中心的內部部署 Apigee Edge 不一定是理想做法。

透過 Edge Microgateway，您可以取得佔用空間較小的應用程式，並在靠近後端應用程式的環境中執行。您還能充分運用 Apigee Edge 的數據分析、安全性和其他功能。

部署情境範例

本節說明 Edge Microgateway 的幾種可能部署情境。

同一部機器

圖 1 顯示 Edge Microgateway 以最簡單的可能設定部署時，要求處理路徑會如何運作，其中 Edge Microgateway 和後端目標 API 會安裝在同一台電腦上。

圖 1：最簡單的 Edge Microgateway 部署方式

不同機器

由於用戶端、Edge Microgateway 和後端 API 實作之間的所有通訊都是透過 HTTP，因此您可以在 API 實作所在的不同電腦上安裝 Apigee Edge Microgateway，如圖 2 所示。

圖 2： Edge Microgateway 與後端目標 API 分開

代理多個應用程式

單一 Edge Microgateway 執行個體可用於前端多個後端目標應用程式，如圖 3 所示。

圖 3：Edge Microgateway 可為多個 API Proxy 擔任前端

搭配負載平衡器

Edge Microgateway 本身可由標準反向 Proxy 或負載平衡器做為前端，用於 SSL 終止和/或負載平衡，如圖 4 所示。

圖 4：使用負載平衡器執行 Edge Microgateway

內部網路部署

如圖 5 所示，您可以使用 Edge Microgateway 保護內部網路流量，同時透過 Apigee Edge 保護網際網路流量。假設 API 端點 /orders 是透過 Apigee Edge Cloud 進行 Proxy，並命中後端目標 https://mycompany.com/orders。這可由左側的目標 API 實作項目代表。這個 API 接著可能會呼叫由右側目標實作項目代表的多個 API 端點。例如，它可能會在內部呼叫 /customers 和 /transactions。另請參閱 Apigee 社群的 這篇貼文。

圖 5：執行 Edge Microgateway 以保護內部網路流量

依附於 Apigee Edge

Edge Microgateway 會依附於 Apigee Edge 並與其互動。Edge Microgateway 必須與 Apigee Edge 通訊才能運作。Edge Microgateway 與 Edge 互動的主要方式如下：

  • 啟動時，Edge Microgateway 會取得特殊的「Edge Microgateway 感知」Proxy 清單，以及 Apigee Edge 機構的所有產品清單。針對每個傳入的用戶端要求，Edge Microgateway 會判斷要求是否與其中一個 API Proxy 相符，然後根據與該 Proxy 相關聯的產品中的金鑰，驗證傳入的存取金鑰或 API 金鑰。
  • Apigee Edge Analytics 系統會儲存及處理從 Edge Microgateway 非同步傳送的 API 資料。
  • Apigee Edge 會提供用來簽署存取權權杖的憑證，或是提供用戶端透過 Edge Microgateway 發出 API 呼叫時所需的 API 金鑰。您可以使用 CLI 指令取得這些權杖。

一次性設定

您必須先設定 Edge Microgateway，才能與 Apigee Edge 機構通訊。在啟動時，Edge Microgateway 會使用 Apigee Edge 啟動引導作業。Edge Microgateway 會從 Apigee Edge 擷取所需資訊，自行處理 API 呼叫，包括在 Apigee Edge 上部署的 Edge Microgateway 感知 Proxy 清單。我們稍後會進一步說明這些 Proxy。

Edge Microgateway 不必與 Apigee Edge 共置；Apigee Edge 公開和私人雲端服務同樣適用。

如果您想透過實際操作來學習，請直接前往「設定及設定 Edge Microgateway」一文，瞭解如何使用方便的 CLI 指令設定 Edge Microgateway。

關於 Edge Microgateway 感知 Proxy 的須知事項

Edge Microgateway 感知 Proxy 會為 Edge Microgateway 提供特定資訊，讓 Edge Microgateway 處理用戶端 API 要求。在 Edge Microgateway 啟動時，系統會從 Apigee Edge 下載這些 Proxy 的相關資訊。

您或您的 API 團隊可以使用 Apigee Edge 管理 UI 或其他方式，在 Apigee Edge 上建立這些 Proxy。這項操作很簡單，詳情請參閱「設定及設定 Edge Microgateway」一文。

Edge Microgateway 感知 Proxy 的特性包括：

  • Micro-aware Proxy 會向 Edge Microgateway 提供兩項重要資訊：基準路徑和目標網址。
  • Micro-aware Proxy 必須指向 HTTP 目標端點。後端目標不得是 TargetEndpoint 定義中 ScriptTarget 元素參照的 Node.js 應用程式。詳情請參閱上述附註。
  • Proxy 名稱前面必須加上 edgemicro_。例如：edgemicro_weather。
  • 您無法在 Apigee Edge 管理 UI 的 Proxy 編輯器中編輯 Edge Microgateway Proxy。也就是說，您無法新增政策或新增條件式流程。(如果您嘗試，系統會忽略這些值)。
  • 否則，Edge Microgateway Proxy 會顯示在 Edge 管理工具使用者介面中，與 Edge 上的其他 API Proxy 相同。
  • 如同 Edge 上的任何 API Proxy，Edge Microgateway Proxy 可納入產品，並與開發人員應用程式建立關聯。
  • 如同其他 Proxy，您可以追蹤 Edge Microgateway Proxy 的數據分析。
  • 您無法使用 Apigee Edge Trace 工具追蹤 Edge Microgateway 代理程式。

進一步瞭解 Edge Microgateway 和 Apigee Edge Analytics

當 API 流量流經 Edge Microgateway 時，Edge Microgateway 會緩衝並異步傳送 API 執行資料至 Apigee Edge，Edge Analytics 系統會在該處儲存及處理資料。這種非同步通訊可讓 Edge Microgateway 充分利用 Edge 分析功能，同時維持相對較小的占用空間，並減少處理額外負擔或阻斷。您和團隊可以使用 Edge Analytics 的完整資訊主頁和自訂報表功能，分析經過 Edge Microgateway 的流量。

圖 6：Edge 上的 Proxy Traffic 資訊主頁

如要進一步瞭解 Edge Analytics，請參閱「Analytics 資訊主頁」。

關於 Edge Microgateway 安全性

Apigee Edge 的角色

如先前所述，Apigee Edge 可確保 Edge Microgateway 的所有用戶端要求。Apigee Edge 的主要角色如下：

  • 提供用於做為 API 金鑰的用戶端憑證，或用於產生用戶端可用於透過 Edge Microgateway 發出安全 API 呼叫的有效存取權權杖。
  • 提供 Edge Microgateway 需要的憑證，才能將 API 執行資料傳送至 Apigee Edge Analytics 系統。在初始設定步驟中，Edge Microgateway 會取得這些憑證一次。(詳情請參閱「設定及調整 Edge Microgateway」一文)。
  • 提供平台，可將 API 資源整合至產品、註冊及管理開發人員，以及建立及管理開發人員應用程式。

用戶端應用程式驗證

  • Edge Microgateway 支援透過存取權杖和 API 金鑰驗證用戶端。安全性金鑰和符記是由 Apigee Edge 產生，並由 Edge Microgateway 驗證每個 API 呼叫。
  • 如果已啟用 oauth 外掛程式，Edge Microgateway 會檢查已簽署的存取權憑證或 API 金鑰，如果有效，API 呼叫會繼續傳送至後端目標。如果無效，系統會傳回錯誤。
  • 請參閱「設定 Edge Microgateway」一文，瞭解取得及使用存取權權杖所需的步驟。如要瞭解 API 金鑰，請參閱「 Edge Microgateway 的操作和設定參考資料」中的「使用 API 金鑰安全性」。
。

在 Apigee Edge 上驗證 Edge Microgateway

  • Edge Microgateway 會發出非同步呼叫，以便更新 Apigee Edge 上的數據分析資料，但這項操作需要驗證。這項驗證會透過公開/私密金鑰組合，透過 CLI 或使用環境變數傳遞至 Edge Microgateway。您首次安裝及啟動 Edge Microgateway 時，就會取得並使用這些金鑰。

API 產品管理平台

  • Edge 是一種平台，可將 API 資源整合至產品、註冊及管理開發人員，以及建立及管理開發人員應用程式。舉例來說，您可以為一般 Apigee Edge Proxy 建立及組合產品和開發人員應用程式等實體，同樣地，您也可以為 Edge Microgateway Proxy 執行相同操作。為每個「套件」產生公開和私密安全性金鑰，即可實現 API 層級安全性。這個機制與 Apigee Edge 上的 API 安全性運作方式相同。

我可以將現有的 Edge 代理程式實作項目移至 Edge Microgateway 嗎？

您無法將含有相關聯政策或條件式流程的現有 Proxy 遷移至 Edge Microgateway。Edge Microgateway 要求您建立新的「microgateway-aware」Proxy。這些 Proxy 必須使用特殊前置字串 edgemicro_ 命名。在啟動時，Edge Microgateway 會偵測這些 edgemicro_* 代理程式，並下載每個代理程式的設定資訊。這項資訊包括目標網址和資源路徑。從那時起，系統就不會使用這些 Proxy。這些 Proxy 中的任何政策或條件式流程都不會執行。

使用微型網關感知 Proxy 的另一個原因是，Edge Microgateway 會非同步將分析資料推送至 Edge，以便為每個微型網關感知 Proxy 提供資料。接著，您就可以查看微型閘道感知 Proxy 的數據分析資料，就像在 Edge Analytics 使用者介面中查看任何其他 Proxy 一樣。

設定主題會逐步引導您完成所有步驟，讓您開始透過 Edge Microgateway 代理 API 呼叫，包括在 Apigee Edge 上執行幾個簡單步驟，設定 Edge Microgateway 所需的設定，包括建立微型閘道感知 Proxy。請參閱「設定及設定 Edge Microgateway」一文。

我可以搭配 Edge Microgateway 代理程式使用政策嗎？

如上一節所述，您無法將政策附加至 Apigee Edge 中的「microgateway-aware」Proxy。Edge Microgateway 使用外掛程式提供類似 Edge 政策的功能，例如配額、尖峰流量防範、API 金鑰安全性和 OAuth2 安全性。請參閱「使用外掛程式」。您也可以撰寫自訂外掛程式，如「開發自訂外掛程式」一文所述。

如何瞭解 Edge Microgateway？

Apigee 提供下列資源：