사용자 지정 커넥터Custom Connectors

Azure Logic Apps, Microsoft Power AutomateMicrosoft Power Apps에서는 325개 이상의 커넥터를 제공하여 Microsoft 및 타사 서비스에 연결할 수 있도록 지원합니다. 물론 사전 빌드된 커넥터를 사용할 수 없는 서비스에 연결해야 할 경우도 있을 수 있습니다.While Azure Logic Apps, Microsoft Power Automate, and Microsoft Power Apps offer over 325+ connectors to connect to Microsoft and non-Microsoft services, you may want to communicate with services that aren't available as prebuilt connectors. 사용자 지정 커넥터는 고유한 트리거 및 동작으로 커넥터를 만들고 심지어 공유할 수 있도록 하여 이 시나리오를 해결합니다.Custom connectors address this scenario by allowing you to create (and even share) a connector with its own triggers and actions.

수명 주기Lifecycle

1. API 구축1. Build your API

사용자 지정 커넥터는 REST API(Logic Apps는 SOAP API도 지원)를 둘러싸는 래퍼로 Logic Apps, Power Automate 또는 Power Apps에서 해당 REST 또는 SOAP API와 통신합니다.A custom connector is a wrapper around a REST API (Logic Apps also supports SOAP APIs) that allows Logic Apps, Power Automate, or Power Apps to communicate with that REST or SOAP API. 이러한 API는 다음과 같이 사용될 수 있습니다.These APIs can be:

  • 공개(공개 인터넷에 표시) 예를 들어, Spotify, Slack, Rackspace 또는 관리하는 APIPublic (visible on the public internet) such as Spotify, Slack, Rackspace, or an API you manage
  • 비공개(네트워크에만 표시)Private (visible only to your network)

작성 및 관리하려는 공개 API의 경우 다음 Microsoft Azure 제품 중 하나를 사용하십시오.For public APIs that you plan to create and manage, consider using one of these Microsoft Azure products:

비공개 API의 경우 Microsoft는 온-프레미스 데이터 게이트웨이를 통해 온-프레미스 연결을 제공합니다.For private APIs, Microsoft offers on-premises data connectivity through an on-premises data gateway. 이 게이트웨이는 Logic Apps, Power Automate 및 Power Apps에서 지원합니다.These gateways are supported by Logic Apps, Power Automate, and Power Apps.

2. API 보호2. Secure your API

API 및 커넥터에 다음 표준 인증 방법 중 하나를 사용합니다(Azure Active Directory 권장).Use one of these standard authentication methods for your APIs and connectors (Azure Active Directory is recommended):

인증을 구현할 필요가 없도록 Azure Portal에서 API에 대해 Azure AD 인증을 설정하거나 API 코드에 인증을 요구하고 적용할 수 있습니다.You can set up Azure AD authentication for your API in the Azure portal so you don't have to implement authentication, or you can require and enforce authentication in your API's code. 사용자 지정 커넥터에 대한 Azure AD에 대해 자세히 알아보려면 Azure AD로 API 및 커넥터 보호를 참조하십시오.For more information about Azure AD for custom connectors, see Secure your API and connector with Azure AD.

3. API에 대해 설명하고 사용자 지정 커넥터 정의3. Describe the API and define the custom connector

인증된 액세스 권한이 있는 API가 있으면 다음으로 해야 할 일은 Logic Apps, Power Automate 또는 Power Apps가 API와 통신할 수 있도록 API를 설명하는 것입니다.Once you have an API with authenticated access, the next thing to do is to describe your API so that Logic Apps, Power Automate, or Power Apps can communicate with your API. Outlook용 Microsoft Dynamics CRM을 지원하는 접근 방식은 다음과 같습니다.The following approaches are supported:

OpenAPI 정의 및 Postman 컬렉션은 다른 형식을 사용하지만 둘 다 API를 설명하는 언어 독립적인 머신 읽기 가능 문서입니다.OpenAPI definitions and Postman collections use different formats, but both are language-agnostic, machine-readable documents that describe your API. API에서 사용하는 언어 및 플랫폼에 따라 다양한 도구에서 이러한 문서를 생성할 수 있습니다.You can generate these documents from various tools based on the language and platform used by your API. 배후에서 Logic Apps, Power Automate 및 Power Apps는 OpenAPI를 사용하여 커넥터를 정의합니다.Behind the scenes, Logic Apps, Power Automate, and Power Apps use OpenAPI to define connectors.

4. Logic App, Power Automate 또는 Power Apps 앱에서 커넥터 사용4. Use your connector in a Logic App, Power Automate, or Power Apps app

사용자 지정 커넥터는 Microsoft 관리 커넥터와 동일한 방식으로 사용됩니다.Custom connectors are used the same way Microsoft-managed connectors are used. API에 연결해야 하며 그 연결을 사용하여 사용자 지정 커넥터에 노출된 모든 작업을 호출할 수 있습니다.You'll need to create a connection to your API and then you can use that connection to call any operations that you've exposed in your custom connector.

Power Automate에서 생성된 커넥터는 Power Apps에서 사용할 수 있습니다.Connectors created in Power Automate are available in Power Apps. 마찬가지로 Power Apps에서 생성된 커넥터는 Power Automate에서 사용할 수 있습니다.Likewise, connectors created in Power Apps are available in Power Automate. Logic Apps에서 만든 커넥터에는 해당되지 않지만 OpenAPI 정의 또는 Postman 컬렉션을 재사용하여 이러한 서비스에서 커넥터를 다시 만들 수 있습니다.This is not true for connectors created in Logic Apps, but you can reuse the OpenAPI definition or Postman collection to recreate the connector in any of these services. 자세한 내용은 해당 자습서를 참조하십시오.For more information, see the appropriate tutorial:

5. 커넥터 공유5. Share your connector

Logic Apps, Power Automate 또는 Power Apps에서 리소스를 공유하는 것과 같은 방식으로 조직의 사용자와 커넥터를 공유 할 수 있습니다.You can share your connector with users in your organization in the same way that you share resources in Logic Apps, Power Automate, or Power Apps. 공유는 선택 사항이지만 다른 사용자와 커넥터를 공유하려는 시나리오가 있을 수 있습니다.Sharing is optional, but you may have scenarios where you want to share your connectors with other users.

자세한 내용은 조직에서 사용자 지정 커넥터 공유를 참조하세요.For more information, see Share custom connectors in your organization.

6. 커넥터 인증6. Certify your connector

커넥터를 Logic Apps, Power Automate 및 Power Apps의 모든 사용자와 공유하려는 경우 Microsoft 인증을 위해 커넥터를 제출할 수 있습니다.If you'd like to share your connector with all users of Logic Apps, Power Automate, and Power Apps, you can submit your connector for Microsoft certification. Microsoft는 커넥터를 검토하고 기술 및 콘텐츠 규정 준수를 확인하며 기능의 유효성을 검사합니다.Microsoft will review your connector, check for technical and content compliance, and validate functionality.

자세한 내용은 Microsoft 인증을 위해 커넥터 제출을 참조하세요.For more information, see Submit your connectors for Microsoft certification.

자습서Tutorial

자습서는 Cognitive Services 텍스트 분석 API 를 사용합니다.The tutorial uses the Cognitive Services Text Analytics API. Microsoft는 이미 이 API에 대한 커넥터를 제공하지만 사용자 지정 커넥터 수명주기 및 사용자 지정 커넥터가 고유한 시나리오를 지원할 수 있는 방법을 가르치는 좋은 예입니다.Microsoft already provides a connector for this API, but it is a good example for teaching the custom connector lifecycle and how custom connectors can support unique scenarios.

시나리오Scenario

개발자가 빌드하는 커넥터는 텍스트 입력에 대한 감정 점수(0.000~1.000)를 반환하는 Text Analytics 감정 작업을 노출합니다.The connector you'll build exposes the Text Analytics Sentiment operation, which returns the sentiment score (0.000 to 1.000) for the text input.

필수 구성 요소Prerequisites

  • 다음 구독 중 하나:One of the following subscriptions:
  • Logic Apps, Power Automate 흐름 또는 Power Apps를 만드는 방법에 대한 기본 이해Basic understanding of how to create Logic Apps, Power Automate flows, or Power Apps
  • Cognitive Services Text Analytics API에 대한 API 키API key for the Cognitive Services Text Analytics API

API 키 가져오기Get an API key

Text Analytics API는 API 키 사용자를 인증합니다.The Text Analytics API uses an API key to authenticate users. 사용자가 사용자 지정 커넥터를 통해 API에 연결하면 이 키 값을 지정합니다.When a user creates a connection to the API through a custom connector, the user specifies the value of this key. 다음을 통해 API 키를 얻을 수 있습니다.You can get an API key by:

자습서 시작Start the tutorial

고급 자습서Advanced tutorials

다음 자습서는 특정 사용자 지정 커넥터 시나리오에 대한 자세한 정보를 제공합니다.The following tutorials provide more detail for specific custom connector scenarios: