사용자 지정 커넥터

Azure Logic Apps, Microsoft Power AutomateMicrosoft Power Apps는 Microsoft 및 검증된 서비스에 연결하기 위해 900개 커넥터 이상을 제공하지만 미리 빌드된 커넥터로 사용할 수 없는 서비스에 연결해야 할 경우도 있을 수 있습니다. 사용자 지정 커넥터는 고유한 트리거 및 동작으로 커넥터를 만들고 심지어 공유할 수 있도록 하여 이 시나리오를 해결합니다.

Screenshot of custom connectors - overview.

수명 주기

Screenshot of custom connectors - lifecycle.

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 제품 중 하나를 사용하십시오.

비공개 API의 경우 Microsoft는 온-프레미스 데이터 게이트웨이를 통해 온-프레미스 연결을 제공합니다.

2. API 보호

API 및 커넥터에 다음 표준 인증 방법 중 하나를 사용합니다(Azure Active Directory 권장).

인증을 구현할 필요가 없도록 Azure Portal에서 API에 대한 Azure AD 인증을 설정할 수 있습니다. 또는 API 코드에서 인증을 요구하고 시행할 수 있습니다. 사용자 지정 커넥터에 대한 Azure AD에 대해 자세히 알아보려면 Azure AD로 API 및 커넥터 보호를 참조하십시오.

3. API에 대해 설명하고 사용자 지정 커넥터 정의

인증된 액세스 권한이 있는 API가 있으면 다음으로 해야 할 일은 Logic Apps, Power Automate 또는 Power Apps가 API와 통신할 수 있도록 API를 설명하는 것입니다. Outlook용 Microsoft Dynamics CRM을 지원하는 접근 방식은 다음과 같습니다.

OpenAPI 정의와 Postman 컬렉션은 서로 다른 형식을 사용하지만 둘 다 API를 설명하는 언어에 관계없이 머신에서 읽을 수 있는 문서입니다. API에서 사용하는 언어 및 플랫폼에 따라 다양한 도구에서 이러한 문서를 생성할 수 있습니다. 백그라운드에서 Logic Apps, Power Automate 및 Power Apps는 OpenAPI를 사용하여 커넥터를 정의합니다.

4. Logic App, Power Automate 또는 Power Apps 앱에서 커넥터 사용

사용자 지정 커넥터는 Microsoft 관리 커넥터와 동일한 방식으로 사용됩니다. 해당 연결을 사용하여 사용자 지정 커넥터에 노출된 작업을 호출하려면 API에 대한 연결을 만들어야 합니다.

Power Automate에서 생성된 커넥터는 Power Apps에서 사용할 수 있습니다. 마찬가지로 Power Apps에서 생성된 커넥터는 Power Automate에서 사용할 수 있습니다. Logic Apps에서 만든 커넥터에는 해당되지 않습니다. 그러나 OpenAPI 정의 또는 Postman 컬렉션을 재사용하여 이러한 서비스에서 커넥터를 다시 만들 수 있습니다. 자세한 내용은 해당 자습서를 참조하십시오.

5. 커넥터 공유

Logic Apps, Power Automate 또는 Power Apps에서 리소스를 공유하는 것과 동일한 방식으로 조직의 사용자와 커넥터를 공유할 수 있습니다. 공유는 선택 사항이지만 다른 사용자와 커넥터를 공유하려는 시나리오가 있을 수 있습니다.

자세한 내용은 조직에서 사용자 지정 커넥터 공유를 참조하세요.

6. 커넥터 인증

커넥터를 Logic Apps, Power Automate 및 Power Apps의 모든 사용자와 공유하려는 경우 Microsoft 인증을 위해 커넥터를 제출할 수 있습니다. Microsoft는 커넥터를 검토하고 기술 및 콘텐츠 규정 준수를 확인하며 기능의 유효성을 검사합니다.

자세한 내용은 Microsoft 인증을 위해 커넥터 제출을 참조하세요.

자습서

자습서는 Cognitive Services 텍스트 분석 API 를 사용합니다. Microsoft는 이미 이 API에 대한 커넥터를 제공합니다. 사용자 지정 커넥터 수명 주기와 사용자 지정 커넥터가 고유한 시나리오를 지원하는 방법을 교육하는 좋은 예입니다.

시나리오

개발자가 빌드하는 커넥터는 텍스트 입력에 대한 감정 점수(0.000~1.000)를 반환하는 Text Analytics 감정 작업을 노출합니다.

필수 조건

  • 다음 구독 중 하나:

  • Logic Apps, Power Automate 흐름 또는 Power Apps를 만드는 방법에 대한 기본 이해.

  • Cognitive Services Text Analytics API의 API 키입니다.

API 키 가져오기

Text Analytics API는 API 키 사용자를 인증합니다. 사용자가 사용자 지정 커넥터를 통해 API에 연결하면 이 키 값을 지정합니다. API 키를 얻는 방법:

  • API 키 요청을 수행하여 API를 사용해보십시오. Azure 구독이 필요하지 않습니다.

  • Azure 구독에 Text Analytics API를 추가합니다. 구독에 API 리소스가 있으면 섹션에서 API 키를 가져옵니다.

    API 키 가져오기

자습서 시작

고급 안내

이 섹션의 튜토리얼 및 비디오에서는 구현의 일부로 Power Platform 커넥터를 활용하는 데 필요한 통찰력을 제공합니다.

자습서

다음 자습서는 특정 사용자 지정 커넥터 시나리오에 대한 자세한 정보를 제공합니다.

Video

다음 45분 분량의 비디오는 Power Platform 커넥터 작동 방식을 보여줍니다. 또한 간단한 고급 사용자 지정 커넥터를 만드는 방법을 보여줍니다.

참조 항목

모든 커넥터 목록

피드백 제공

커넥터 플랫폼 관련 문제 또는 새로운 기능 아이디어에 대한 피드백을 주셔서 정말 감사합니다. 피드백을 제공하려면 문제 제출 또는 커넥터 관련 도움말 보기로 이동하여 피드백 유형을 선택하십시오.