什麼是 Azure Logic Apps 中的連接器

當您使用 Azure Logic Apps 建置工作流程時,可以使用連接器來處理其他應用程式、服務、系統和平台中的資料、事件和資源,而無需撰寫程式碼。 連接器提供一或多個預先建置的作業,可當成工作流程中的步驟使用。

在連接器中,每個作業都是啟動工作流程的觸發程序,或是執行特定工作的後續動作,其中包含您可以設定的屬性。 雖然許多連接器同時有觸發程序和動作,但有些連接器只提供觸發程序,而另一些連接器則只提供動作。

在 Azure Logic Apps 中,連接器提供內建版本、受控版本或兩者同時使用。 許多連接器通常會要求您先建立和設定基礎服務或系統的連線,以便您可以驗證使用者帳戶的存取權。 如果您想要存取的資源或系統沒有可用的連接器,則可以使用一般 HTTP 作業傳送要求,或者您也可以建立自訂連接器

此概觀提供連接器其及一般運作方式的高階簡介。 如需連接器的詳細資訊,請參閱下列文件:

內建連接器與受控連接器的比較

在 Azure Logic Apps 中,連接器可以是「內建」或「受控」。 有些連接器同時有兩個版本。 可用版本取決於您是建立在多租用戶 Azure Logic Apps 中執行的「取用」邏輯應用程式工作流程,或是在單一租用戶 Azure Logic Apps 中執行的「標準」邏輯應用程式工作流程。 如需邏輯應用程式資源類型的詳細資訊,請參閱資源類型和主機環境差異

  • 內建連接器是設計用於在 Azure Logic Apps 內直接且原生地執行。

  • 受控連接器由 Microsoft 在 Azure 中部署、裝載和管理。 連接器主要為 API 提供 Proxy 或包裝函式,基礎服務或系統使用該 API 與 Azure Logic Apps 進行通訊。

    • 在「取用」工作流程中,受控連接器會根據其定價層級顯示在設計工具的 [標準] 或 [企業] 標籤底下。

    • 在「標準」工作流程中,所有受控連接器都會顯示在 [Azure] 標籤的設計工具底下。

如需詳細資訊,請參閱下列文件:

觸發程序

觸發程序會指定在工作流程啟動前需要滿足的條件,且一律是任何工作流程中的第一個步驟。 每個觸發程序也會遵循特定的引發模式,以控制觸發程序如何監視和回應事件。 通常,觸發程序會遵循「輪詢」模式或「推送」模式。 有時候,這兩個觸發程序版本都可使用。

  • 「輪詢」觸發程序會定期依指定的排程檢查特定服務或系統,以檢查是否有新的資料或特定事件。 如果有新的資料可用,或發生特定事件,這些觸發程序會建立並執行工作流程的新執行個體。 接著,這個新執行個體可以使用傳遞為輸入的資料。

  • 「推送」或「webhood」觸發程序會接聽新的資料或事件發生,而不需輪詢。 當新的資料可用或發生特定事件時,這些觸發程序會建立並執行工作流程的新執行個體。 接著,這個新執行個體可以使用傳遞為輸入的資料。

例如,假設您想要建置一個在檔案上傳至 FTP 伺服器時執行的工作流程。 作為工作流程的第一個步驟,您可以新增名為新增或修改檔案時FTP 觸發程序,該程序會遵循輪詢模式。 接著指定排程以定期檢查上傳事件。

觸發程序引發時通常會傳遞事件輸出,以供後續動作參考及使用。 針對 FTP 範例,觸發程序會自動輸出檔名和路徑等資訊。 您也可以設定觸發程序以包含檔案內容。 因此,若要處理此資料,您必須在工作流程新增動作。

動作

動作會指定要執行的工作,且一律會顯示為工作流程中的後續步驟。 您可以在工作流程中使用多個動作。 例如,您可以使用檢查 SQL 資料庫中新客戶資料的 SQL Server 觸發程序來啟動工作流程。 觸發之後,您的工作流程可以具有可取得客戶資料的 SQL Server 動作。 在此 SQL Server 動作之後,您的工作流程可以使用不同動作處理資料,例如建立 CSV 資料表的資料作業動作

連接權限

在「取用」邏輯應用程式工作流程中,您需要特定權限才能建立或管理邏輯應用程式資源、工作流程及其連線。 如需這些權限的詳細資訊,請參閱安全作業 - Azure Logic Apps 中的安全存取和資料

連線的建立、設定和驗證

在工作流程中使用連接器的作業之前,許多連接器會要求您先建立目標服務或系統的連線。 若要在工作流程設計工具內建立連線,您必須使用帳號憑證 (和其他連線資訊) 來驗證身分識別。

例如,在工作流程可以存取和使用您的 Office 365 Outlook 電子郵件帳戶之前,您必須授權該帳戶的連線。 針對某些內建連接器和受控連接器,您可以設定並使用受控識別以進行驗證,而非提供您的認證。

儘管您在工作流程內建立連線,這些連線實際上會以自己的資源定義來分隔 Azure 資源。 若要檢閱這些連線資源定義,請根據您是否有取用或標準工作流程,遵循下列步驟:

連線安全性與加密

連線設定詳細資料,例如伺服器位址、使用者名稱和密碼、認證和祕密都會進行加密並儲存在受保護的 Azure 環境中。 這項資訊只能用於邏輯應用程式資源,以及由具有連線資源權限的用戶端使用,並使用連結存取檢查來強制執行。 使用 Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth) 的連線,例如 Office 365、Salesforce 和 GitHub 會要求您登入,但 Azure Logic Apps 只會將存取和重新整理權杖儲存為祕密,而非登入認證。

只要該服務或系統允許,建立的連線就可以存取目標服務或系統。 對於使用 Microsoft Entra ID OAuth 連線的服務 (例如 Office 365 和 Dynamics),Azure Logic Apps 會無限期地重新整理存取權杖。 其他服務可能會限制 Logic Apps 可以在不重新整理情況下使用權杖的時間長度。 某些動作如變更密碼,會使所有存取權杖失效。

注意

如果您的組織不允許透過 Azure Logic Apps 中的連接器存取特定資源,您可以封鎖使用 Azure 原則建立此類連線的功能。

如需保護邏輯應用程式工作流程和連線的詳細資訊,請參閱 Azure Logic Apps 中的安全存取和資料

連線的防火牆存取

如果您使用限制流量的防火牆,且邏輯應用程式工作流程需要透過該防火牆進行通訊,則必須設定防火牆,以允許存取邏輯應用程式工作流程所在 Azure 區域中 Azure Logic Apps 平台或執行階段使用的輸入輸出 IP 位址。

如果您的工作流程也使用受控連接器 (例如 Office 365 Outlook 連接器或 SQL 連接器),或是使用自訂連接器,則防火牆也需要允許存取您邏輯應用程式資源的 Azure 區域中所有受控連接器輸出 IP 位址。 如需詳細資訊,請參閱防火牆壁組態

自訂連接器和 API

在多租用戶 Azure Logic Apps 的取用工作流程中,您可以呼叫非立即可用連接器的 Swagger 型或 SOAP 型 API。 您也可以透過建立自訂 API Apps 來執行自訂程式碼。 如需詳細資訊,請參閱下列文件:

在單一租用戶 Azure Logic Apps 的標準工作流程中,您可以建立基於原生執行服務提供者的自訂內建連接器,適用於任何標準邏輯應用程式工作流程。 如需詳細資訊,請參閱下列文件:

ISE 和連接器

對於需要直接存取 Azure 虛擬網路中資源的工作流程,您可以建立專用整合服務環境 (ISE),以在專用資源上建置、部署和執行工作流程。 如需有關建立 ISE 的詳細資訊,請參閱從 Azure Logic Apps 連線至 Azure 虛擬網路

在 ISE 內建立的自訂連接器不適用於內部部署資料閘道。 不過,這些連接器可以直接存取連線至裝載 ISE 的 Azure 虛擬網路中內部部署資料來源。 因此,ISE 中的邏輯應用程式工作流程在與這些資源通訊時,很可能不需要資料閘道。 如果您在需要內部部署資料閘道的 ISE 外部建立自訂連接器,ISE 中的工作流程可以使用這些連接器。

在工作流程設計工具中,當您瀏覽要用於 ISE 工作流程的內建連接器或受控連接器時,CORE 標籤會出現在內建連接器上,而 ISE 標籤會出現在設計為搭配使用 ISE 的受控連接器上。

Example CORE connector

CORE

具有此標籤的內建連接器會在與您工作流程相同的 ISE 中執行。

Example ISE connector

ISE

具有此標籤的受控連接器會在與您邏輯應用程式相同的 ISE 中執行。

如果您有連線至 Azure 虛擬網路的內部部署系統,ISE 可讓您的工作流程直接存取該系統,而不需要使用內部部署資料閘道。 相反地,如果有的話,您可以使用系統的 ISE 連接器、HTTP 動作或自訂連接器

針對沒有 ISE 連接器的內部部署系統,請使用內部部署資料閘道。 若要尋找可用的 ISE 連接器,請檢閱 ISE 連接器

Example non-ISE connector

沒有標籤

您可以繼續使用所有其他沒有標籤的連接器,以在全域的多組織用戶 Logic Apps 服務中執行。

已知問題

下表包含 Azure Logic Apps 連接器的已知問題:

錯誤訊息 描述 解決方案
Error: BadGateway. Client request id: '{GUID}' 此錯誤會導致更新邏輯應用程式資源上的標記,其中一或多個連線不支援 Microsoft Entra ID OAuth 驗證 (例如 SFTP ad SQL) 導致這些連線中斷。 若要避免此行為,請避免更新這些標記。

下一步