自訂連接器概觀
雖然 Azure 邏輯應用Microsoft Power Automate提供了 1,000 多個 Microsoft Power Apps 連接器 來連接到 Microsoft 和經過驗證的服務,但 你可能希望與不作為預生成連接器提供的服務進行通信。 自訂連接器可以解決這種情況,您可以建立 (甚至共用) 具有其自身的觸發程序和動作的連接器。
生命週期
1. 建立您的 API
自訂連接器是 REST API 的包裝函式,讓 Logic Apps、Power Automate 或 Power Apps 可以與該 REST 或 SOAP API 通訊。 這些 API 可以是:
Logic Apps 還支援 SOAP API。
對於您計畫建立和管理的公用 API,請考慮使用其中一種 Microsoft Azure 產品:
對於私有 API,Microsoft 透過 本地數據閘道提供本地資料連接。
2. 保護 API 安全
為您的 API 和連接器使用以下標準身份驗證方法之一 (Microsoft Entra 建議使用 ID ):
- 通用 OAuth 2.0
- OAuth 2.0 適用於特定服務,包括 Microsoft Entra ID、Dropbox、GitHub 和 SalesForce
- 基本身份驗證
- API 金鑰
您可以在 Azure 入口網站中為您的 API 設定 Microsoft Entra 識別碼驗證,這樣就不需執行驗證。 或者,您也可以在您的 API 代碼中要求並強制進行驗證。 有關 Microsoft Entra 自定義連接器的 ID 的更多資訊,請參閱 使用 Microsoft Entra ID保護您的 API 和連接器。
2.1. OAuth 2.0
使用 OAuth 2.0 進行身份驗證的新創建的自定義連接器會自動具有每個連接器的重定向 URI。 必須在 2024 年 2 月 17 日之前更新現有 OAuth 2.0 連接器才能使用每個連接器的重定向 URI。
- 如果您使用 Web 介面創建了自訂連接器,請編輯自定義連接器,轉到安全 選項卡 並選中 Update to unique redirect URL ,then save 複選框以啟用每個連接器重定向 URI。
- 如果您使用命令列介面 (CLI) 工具創建了具有 多重身份驗證的自訂連接器,則需要使用 CLI 工具更新連接器以進行設置。
"redirectMode": "GlobalPerConnector"
- 通過 Security(安全 ) 選項卡或 CLI 工具中的設置將自訂連接器更新為使用每個連接器的重定向 URI 後,請從 OAuth 2.0 應用程式中刪除全域重定向 URI。 您應該將新生成的唯一重定向 URL OAuth 添加到您的 2.0 應用程式中。
- 從 2024 年 2 月 17 日開始,我們將對現有 OAuth 2.0 自定義連接器強制實施此更新。 任何未更新為使用每個連接器重定向 URI 的自定義連接器都將停止用於新連接,並向使用者顯示錯誤消息。
- 要找出哪些自定義連接器需要更新才能遷移到每個連接器重定向 URL,您可以創建一個流,該流使用 管理員連接器的 Get Custom Connectors as Admin Power Apps 作並解析其結果。 本文之後附加的流程使用相同方法來擷取所有自訂連接器。 然後,它會對 connection 參數的屬性應用篩選條件,以篩選出非 Oauth 自定義連接器,然後應用另一個篩選條件,以僅選擇不使用每個連接器唯一重定向 URL 的連接器。 最後,它會將選定的自訂連接器放入在流程開始時初始化的陣列變數中,並產生 HTML 表格,顯示那些連接器的名稱和建立者。 您可以通過導入 此解決方案將此流匯入到您的環境中。 您可以進一步擴充流程,以將 HTML 表格作為電子郵件發送給自己。 或您也可以擴充它來直接發送電子郵件給連接器建立者,並提供他們需要更新之連接器的名稱。
3. 描述 API 並定義自訂連接器
當您有具備驗證存取的 API 之後,接下來要做的事就是描述您的 API,讓 Logic Apps、Power Automate 或 Power Apps 可以與您的 API 進行通訊。 支援的方法如下:
OpenAPI 定義 (先前稱為 Swagger 檔案)
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 集合來重新建立這些服務中的連接器。 如需詳細資訊,請參閱適當的教學課程:
提示
如果您更新 (刪除、新增或更改) API 中的欄位,請執行以下步驟:
- 重新發佈連接器,以便它查看更新的 API 的 Swagger。
- 刪除使用該連接器的任何應用程式中的任何連接/資料源。
- 將該連接器的連接/資料源重新添加回應用程式中。
5. 共用您的連接器
您可以與組織中的使用者共用您的連接器,就像在 Logic Apps、Power Automate 或 Power Apps 中共用資源一樣。 共用是選擇性的,但您可能會有想和其他使用者共用您的連接器的情形。
有關詳細資訊,請參閱 在組織中共用自定義連接器。
6. 認證您的連接器
如果您想將連接器與 Logic Apps、Power Automate 及 Power Apps 的所有使用者共用,您可以提交連接器以進行 Microsoft 認證。 Microsoft 會檢閱您的連接器、檢查技術和內容的合規性,並驗證功能。
有關更多資訊,請參閱 提交連接器進行 Microsoft 認證。
虛擬網路支援
在 Power Platform 連結到虛擬網路的環境中使用連接器時,存在限制:
使用自訂代碼時,在自定義連接器 中編寫代碼中解釋了限制。
在將環境關聯到虛擬網路之前創建的自定義連接器需要重新保存。
不支援返回不回調到自定義連接器的位置標頭的觸發器。
提供意見反應
非常感謝您提供有關連接器平台問題,或新功能構想的意見反應。 若要提供反饋,請轉到 提交問題或獲取有關連接器 的説明,然後選擇您的反饋類型。