自訂連接器概觀

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

生命週期

1. 建立您的 API

自訂連接器是 REST API 的包裝器，可讓 Logic Apps、Power Automate、Power Apps 或 Copilot Studio 與此 REST 或 SOAP API 進行通訊。 這些 API 可以是：

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

Logic Apps 還支援 SOAP 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。 必須在 2024 年 2 月 17 日之前更新現有 OAuth 2.0 連接器以使用每個連接器重新導向 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 for Admin 連接器的以管理員身分取得自訂連接器動作，並解析其結果。 本文之後附加的流程使用相同方法來擷取所有自訂連接器。 然後，它會在連線參數屬性上套用篩選條件以篩選出非 Oauth 自訂連接器，然後將依照另一個篩選條件以僅選取不使用每個連接器唯一重新導向 URL 的連接器。 最後，它會將選定的自訂連接器放入在流程開始時初始化的陣列變數中，並產生 HTML 表格，顯示那些連接器的名稱和建立者。 匯入此解決方案即可將此流程匯入到您的環境中。 您可以進一步擴充流程，以將 HTML 表格作為電子郵件發送給自己。 或您也可以擴充它來直接發送電子郵件給連接器建立者，並提供他們需要更新之連接器的名稱。

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

一旦您擁有具有經過驗證的存取權限的 API，接下來要做的就是描述您的 API，以便 Logic Apps、Power Automate、Power Apps 或 Copilot Studio 可以與您的 API 通訊。 支援的方法如下：

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

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

• Postman 集合

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

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

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

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

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

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

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

• 從流程使用自訂連接器
• 從應用程式使用自訂連接器
• 從邏輯應用程式中使用自訂連接器
• 在 Copilot Studio 中使用連接器動作

提示

如果在 API 中更新 (移除、新增，或變更) 欄位，請執行以下步驟：

1. 重新發佈連接器，以便查看 API 的更新 Swagger。
2. 移除使用該連接器之任何應用程式中的任何連線 / 資料來源。
3. 將該連接器的連線 / 資料來源重新新增到應用程式中。

5. 共用您的連接器

您可以與組織中的使用者共用連接器，方式與在 Copilot Studio、Logic Apps、Power Automate 或 Power Apps 中共用資源的方式相同。 共用是選擇性的，但您可能會有想和其他使用者共用您的連接器的情形。

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

6. 認證您的連接器

如果您想與 Copilot Studio、Logic Apps、Power Automate 和 Power Apps 的所有使用者共用您的連接器，您需要提交您的連接器以獲得 Microsoft 認證。 Microsoft 會檢閱您的連接器、檢查技術和內容的合規性，並驗證功能。

虛擬網路支援

在連到虛擬網路的 Power Platform 環境中使用連接器時，存在以下限制：

• 使用自訂代碼時，限制會在在自訂連接器中編寫代碼中說明。

• 在環境與虛擬網络建立關聯之前建立的自訂連接器，需要重新儲存。

• 不支援傳回位置標頭不會呼叫回自訂連接器的觸發程序。

提供意見反應

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