自訂連接器

雖然 Azure Logic Apps、Microsoft Power Automate 和 Microsoft Power Apps 提供超過 325 種連接器來連線到 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 和連接器使用其中一種標準驗證方法 (建議使用 Azure Active Directory)：

• 一般 OAuth 2.0
• 特定服務的 OAuth 2.0，包括 Azure Active Directory (Azure AD)、Dropbox、GitHub 和 SalesForce
• 基本驗證
• API 金鑰

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

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 應用程式中使用連接器

使用自訂連接器的方式就跟使用由 Microsoft 管理的連接器一樣。 您必須與您的 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 集合建立自訂連接器
  • 從頭開始建立自訂連接器

進階教學課程

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

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

提供意見反應

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