自訂連接器

雖然 Azure Logic Apps、Microsoft Power Automate 和 Microsoft Power Apps 提供超過 1,000 種連接器來連線到 Microsoft 和已驗證服務，但您想與之通訊的服務也有可能無法透過預先建置的連接器來連線。 自訂連接器可以解決這種情況，您可以建立 (甚至共用) 具有其自身的觸發程序和動作的連接器。

生命週期

1. 建立您的 API

自訂連接器是 REST API 的包裝函式（Logic Apps 也支援 SOAP API），允許 Logic Apps、Power Automate 或 Power Apps 與該 REST 或 SOAP API 通訊。 這些 API 可以是：

• 公用（在公用網際網路上可見），例如 Spotify、Slack、Rackspace 或您管理的 API。
• 私人 (只在您的網路上可見)。

對於您計畫建立和管理的公用 API，請考慮使用其中一種 Microsoft Azure 產品：

• Azure Functions
• Azure Web Apps
• Azure API 應用程式

至於私人 API，Microsoft 會透過內部部署的資料閘道提供內部部署資料連線。

2. 保護 API 安全

為您的 API 和連接器使用其中一種標準驗證方法 (建議使用 Microsoft Entra 識別碼 )：

• 一般 OAuth 2.0
• 特定服務的 OAuth 2.0，包括 Microsoft Entra 識別碼、Dropbox、GitHub 和 SalesForce
• 基本驗證
• API 金鑰

您可以在 Azure 入口網站中為您的 API 設定 Microsoft Entra 識別碼驗證，這樣就不需執行驗證。 或者，您也可以在您的 API 代碼中要求並強制進行驗證。 如需更多有關自訂連接器之 Microsoft Entra 識別碼的詳細資訊，請參閱使用 Microsoft Entra 識別碼來保護您的 API 和連接器。

2.1. OAuth 2.0

新建立之使用 OAuth 2.0 自動進行身份驗證的自訂連接器，具有每個連接器重新導向 URI。 現有的 OAuth 2.0 連接器必須在 2024 年 2 月 17 日前，更新為使用每個連接器重新導向 URI。

• 如果您使用 web 介面建立了自訂連接器，請編輯您的自訂連接器，移至安全性索引標籤並選取核取方塊，更新為唯一重新導向 URL，然後儲存以啟用每個連接器重新導向 URI。
• 如果您透過使用命令列介面 (CLI) 工具的多重驗證建立了自訂連接器，則需要使用 CLI 工具來更新您的連接器以設定 "redirectMode": "GlobalPerConnector"。
• 將自訂連接器更新為使用每個連接器重新導向 URI (透過在安全性索引標籤中的設定或使用 CLI 工具) 後，您應該從 OAuth 2.0 應用程式中移除全域重新導向 URI，並新增新產生的唯一重新導向 URL到您的 OAuth 2.0 應用程式。
• 我們將從 2024 年 2 月 17 日開始對現有的 OAuth 2.0 自訂連接器，強制執行此更新。 任何尚未更新為使用每個連接器重新導向 URI 的自訂連接器，都將無法進行新連接，並會向使用者顯示錯誤訊息。
• 若要找出哪些自訂連接器需要更新才能遷移到每個連接器重新導向 URL，您可以建立一個簡單的流程，該流程使用 Power Apps 的以管理員身份取得自訂連接器動作，用於管理員連接器並解析其結果。 本文之後附加的流程使用相同方法來擷取所有自訂連接器。 然後，它會對連接參數的屬性套用篩選條件以過濾掉非 Oauth 自訂連接器，然後使用另一個篩選條件來僅選取不使用每個連接器唯一重新導向 URL 的連接器。 最後，它會將選定的自訂連接器放入在流程開始時初始化的陣列變數中，並產生 HTML 表格，顯示那些連接器的名稱和建立者。 您只需匯入此解決方案即可將此流程匯入到您的環境中。 您可以進一步擴充流程，以將 HTML 表格作為電子郵件發送給自己。 或您也可以擴充它來直接發送電子郵件給連接器建立者，並提供他們需要更新之連接器的名稱。

3. 描述 API 並定義自訂連接器

當您有具備驗證存取的 API 之後，接下來要做的事就是描述您的 API，讓 Logic Apps、Power Automate 或 Power Apps 可以與您的 API 進行通訊。 支援的方法如下：

• OpenAPI 定義 (先前稱為 Swagger 檔案)

  • 從 OpenAPI 定義建立自訂連接器
  • OpenAPI 文件

• Postman 集合

  • 建立 Postman 集合
  • 從 Postman 集合建立自訂連接器
  • Postman 文件

• 使用自訂連接器入口網站從頭開始（僅適用 Power Automate 和 Power Apps）

  • 從頭開始建立自訂連接器

OpenAPI 定義和 Postman 集合使用不同的格式，但兩者都是無從驗證語言的電腦可讀取文件，可描述您的 API。 您可以根據 API 所使用的語言和平台，從各種工具產生這些文件。 在幕後，Logic Apps、Power Automate 及 Power Apps 使用 OpenAPI 來定義連接器。

4. 在 Logic Apps、Power Automate 或 Power Apps 應用程式中使用連接器

使用自訂連接器的方式就跟使用預建連接器一樣。 您必須與您的 API 建立連線，才能使用該連線來呼叫任何已在自訂連接器中公開的作業。

在 Power Automate 中建立的連接器可在 Power Apps 中使用。 同樣的，在 Power Apps 中建立的連接器可在 Power Automate 中使用。 對於在邏輯應用程式中建立的連接器，就不是這樣了。 但是，您可以重複使用 OpenAPI定義或 Postman 集合來重新建立這些服務中的連接器。 如需詳細資訊，請參閱適當的教學課程：

• 從流程使用自訂連接器
• 從應用程式使用自訂連接器
• 從邏輯應用程式中使用自訂連接器

5. 共用您的連接器

您可以與組織中的使用者共用您的連接器，就像在 Logic Apps、Power Automate 或 Power Apps 中共用資源一樣。 共用是選擇性的，但是可能會有想讓與其他使用者共用您的連接器的情形。

如需詳細資訊，請參閱在貴組織中共用自訂連接器。

6. 認證您的連接器

如果您想將連接器與 Logic Apps、Power Automate 及 Power Apps 的所有使用者共用，您可以提交連接器以進行 Microsoft 認證。 Microsoft 會檢閱您的連接器、檢查技術和內容的合規性及驗證功能。

如需詳細資訊，請參閱提交您的連接器以進行 Microsoft 認證。

教學課程

教學課程使用認知服務文字分析 API。 Microsoft 已提供此 API 的連接器。 這是教導自訂連接器生命週期，以及自訂連接器如何支援獨特案例的絕佳範例。

案例

您所建置的連接器會公開文字分析情緒作業，該作業會傳回輸入文字的人氣分數 (0.000 到 1.000)。

先決條件

• 下列其中一項訂閱：

  • Azure 訂閱 (Logic Apps)
  • Power Automate
  • Power Apps

• 初步了解如何建立 Logic Apps、Power Automate 流程或 Power Apps。

• 認知服務文字分析 API 的 API 金鑰。

取得 API 金鑰

文字分析 API 使用 API 金鑰來驗證使用者。 當使用者透過自訂連接器建立與 API 的連接時，使用者會指定此金鑰的值。 若要取得 API 金鑰：

• 要求 API 金鑰以試用 API。 這不需要 Azure 訂閱。

• 將文字分析 API 新增至您的 Azure 訂閱。 當您擁有訂閱中的 API 資源之後，請從金鑰區段取得 API 金鑰：

  

開始教學課程

• 如果您使用的是 Logic Apps，請參閱：

  • 建立 Azure Logic Apps 自訂連接器

• 如果您使用的是 Power Automate 或 Power Apps，請參閱：

  • 從 OpenAPI 定義建立自訂連接器
  • 從 Postman 集合建立自訂連接器
  • 從頭開始建立自訂連接器

進階指引

本節中的教學課程和影片為您提供在實作過程中運用 Power Platform 連接器所需的見解。

教學課程

下列教學教程提供特定自訂連接器案例的詳細資料：

• 延伸 OpenAPI 定義
• 從自訂連接器的 Postman 集合建立
• 使用 Microsoft Entra 識別碼進行驗證
• 建立 Web API 的連接器
• 使用 Webhook 作為觸發程序
• 建立 Logic Apps SOAP API 連接器

Video

下列 45 分鐘影片告訴您 Power Platform 連接器的運作方式。 這也會示範如何建立簡單和進階自訂連接器。

另請參閱

所有連接器的清單

提供意見反應

非常感謝您提供有關連接器平台問題，或新功能構想的意見反應。 若要提供意見反應，請移至提交問題或取得連接器說明，然後選取您的意見反應類型。