사용자 지정 커넥터

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

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 및 커넥터에 다음 표준 인증 방법 중 하나를 사용합니다(Microsoft Entra ID 권장).

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

2.1. OAuth 2.0

OAuth 2.0을 사용하여 자동으로 인증하는 새로 생성된 사용자 지정 커넥터에는 커넥터별 리디렉션 URI가 있습니다. 기존 OAuth 2.0 커넥터는 2024년 2월 17일 이전에 커넥터별 리디렉션 URI를 사용하도록 업데이트되어야 합니다.

  • 웹 인터페이스를 사용하여 사용자 지정 커넥터를 만든 경우 사용자 지정 커넥터를 편집하고, 보안 탭으로 이동하고, 고유한 리디렉션 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의 관리자로 사용자 지정 커넥터 가져오기 작업을 사용하고 해당 결과를 구문 분석하는 간단한 흐름을 만들 수 있습니다. 이 문서 뒷부분에 첨부된 흐름은 동일한 것을 사용하여 모든 사용자 지정 커넥터를 가져옵니다. 그런 다음 연결 매개 변수 속성에 필터 조건을 적용하여 비Oauth 사용자 지정 커넥터를 필터링한 다음, 커넥터별 고유 리디렉션 URL을 사용하지 않는 커넥터만 선택하는 또 다른 필터를 적용합니다. 마지막으로 선택한 사용자 지정 커넥터를 흐름 시작 시 초기화된 배열 변수에 넣고 해당 커넥터의 이름과 작성자를 표시하는 HTML 테이블을 생성합니다. 이 솔루션을 가져오기만 하면 이 흐름을 환경으로 가져올 수 있습니다. 흐름을 더욱 확장하여 HTML 테이블을 자신에게 이메일로 보낼 수 있습니다. 또는 커넥터 작성자에게 직접 이메일을 보내고 업데이트해야 하는 커넥터의 이름을 제공하도록 확장할 수 있습니다.

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 앱에서 커넥터 사용

사용자 지정 커넥터는 미리 빌드된 커넥터와 동일한 방식으로 사용됩니다. 해당 연결을 사용하여 사용자 지정 커넥터에 노출된 작업을 호출하려면 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 커넥터 작동 방식을 보여줍니다. 또한 간단한 고급 사용자 지정 커넥터를 만드는 방법을 보여줍니다.

참조 항목

모든 커넥터 목록

피드백 제공

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