使用流程掛鉤附加共用的流程

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

您可以讓共用流程在一系列 API 上執行固定格式要求預處理或回應後處理作業。您可以使用流程掛鉤附加共用流程，讓系統在相同位置執行所有部署至特定環境的 API Proxy。這樣一來，您就能取得獨立實作及部署的邏輯序列，而這並非 Proxy 的實作程式碼。

由於附加至流程掛鉤的程式碼不在 API Proxy 核心邏輯的內容中，因此其部分行為與 API Proxy 不同。請注意以下幾點：

• 您必須具備權限，才能將共用的流程附加至流程掛鉤。您必須是機構管理員。
• 每個流程掛鉤只能附加一個共用流程。
• 您可以將相同的共用流程附加至多個流程掛鉤。
• 如果附加至流程掛鉤的共用流程發生錯誤，或是在共用流程執行期間發生錯誤，系統會拒絕訊息，並將錯誤傳回給呼叫端。
• 如果在執行流程掛鉤時遭到拒絕，系統會在呼叫的 Proxy 情境中，將詳細資料記錄到 Analytics。共用流程也可以擲回錯誤，並顯示自訂代碼和錯誤訊息

以下影片示範如何在 Apigee UI 中，將共用流程連結至流程掛鉤，然後追蹤。

透過流程掛鉤附加至 Proxy 的共用流程，可提供執行廣泛政策要求的邏輯。舉例來說，假設您有一個團隊負責管理一組安全性要求，而這組要求適用於代表不同業務單位 (LOB) 的多個團隊。各個 LOB 團隊可以根據自身需求開發 API，而無須考量更廣泛的安全性需求。安全性團隊可以在共用流程中實作這些安全性需求，然後使用流程掛鉤將流程附加至 Apigee 環境。由於共用流程不是 Proxy 程式碼的一部分，因此安全性團隊可以視需要修改，而不影響 LOB 程式碼。

透過流程掛鉤附加的共用流程，會在每個部署至 Proxy Hook 環境的 API Proxy 執行時執行。因此，只有 Apigee 機構的管理員可以使用流程掛鉤。

如要進一步瞭解共用流程，請參閱「建立可重複使用的共用流程」。

您可以使用 Apigee UI 或 Flowhooks API，將共用流程附加至流程掛鉤。您最多可在下列位置將一個共用流程連結至流程掛鉤：

• Proxy 前流程掛鉤：適用於需要在 Proxy 端點執行前強制執行的邏輯。

  舉例來說，您可以建立邏輯，在環境中的所有 API 中強制執行安全性措施。

• 目標前流程掛鉤：適用於需要在目標端點執行前強制執行的邏輯。

  舉例來說，您可以在要求抵達後端之前實作記錄功能。您也可以從要求中移除特定欄位，強制執行中介服務。

• 目標後流程掛鉤：適用於需要在目標回應執行後強制執行的邏輯。

  這項設定會在後端傳回回應後立即生效。您可以使用它記錄後端回應，或從後端回應中移除敏感欄位，以便執行某些中介服務。

• 後置 Proxy 流程掛鉤：適用於需要在 Proxy 端點之後，且在回應傳送至用戶端之前執行的邏輯。

  這可能包括 CORS 的部分強制執行邏輯、記錄回應，或執行部分混合或格式設定。

將共用流程連結至流程掛鉤

如要將共用動態流程附加至動態流程掛鉤，您必須是包含共用動態流程的機構中的管理員。