다음을 통해 공유

사용자 지정 커넥터 개요

  • 아티클

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

사용자 정의 커넥터가 Text Analytics API와 앱을 연결하는 방식을 보여주는 스크린샷입니다.

수명 주기

5단계로 구성된 사용자 정의 커넥터 수명 주기의 스크린샷입니다.

1. API 구축

사용자 지정 커넥터는 REST API를 둘러싸는 래퍼로 Logic Apps, Power Automate 또는 Power Apps에서 해당 REST 또는 SOAP API와 통신합니다. 이러한 API는 다음과 같이 사용될 수 있습니다.

  • Spotify, Slack, Rackspace와 같이 공개된(공개 인터넷에서 볼 수 있는) API나 직접 관리하는 API.
  • 비공개(사용자의 네트워크에만 표시).

Logic Apps는 SOAP API도 지원합니다.

작성 및 관리하려는 공개 API의 경우 다음 Microsoft Azure 제품 중 하나를 사용하십시오.

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

2. API 보호

API 및 커넥터에 대해 다음 표준 인증 방법 중 하나를 사용하세요(Microsoft Entra ID 권장):

인증을 구현할 필요가 없도록 Azure Portal에서 API에 대한 Microsoft Entra ID 인증을 설정할 수 있습니다. 또는 API 코드에서 인증을 요구하고 시행할 수 있습니다. 사용자 지정 커넥터의 ID에 대한 자세한 내용은 Microsoft Entra ID로 API 및 커넥터 보안 을 참조하세요. Microsoft Entra

2.1. OAuth 2.0

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

  • 웹 인터페이스로 사용자 지정 커넥터를 만든 경우, 사용자 지정 커넥터를 편집하고 보안 탭으로 이동하여 고유한 리디렉션 URL로 업데이트 상자를 선택한 다음, 커넥터별 리디렉션 URI를 활성화하도록 저장합니다.
  • 명령줄 인터페이스(CLI) 도구 를 사용하여 multi-auth로 사용자 지정 커넥터를 만든 경우 CLI 도구를 사용하여 커넥터를 업데이트하여 설정해야 합니다 "redirectMode": "GlobalPerConnector".
  • 보안 탭이나 CLI 도구의 설정을 통해 사용자 지정 커넥터가 커넥터별 리디렉션 URI를 사용하도록 업데이트되면 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 컬렉션을 재사용하여 이러한 서비스에서 커넥터를 다시 만들 수 있습니다. 자세한 내용은 해당 자습서를 참조하십시오.

팁

API에서 필드를 업데이트(제거, 추가 또는 변경)하는 경우 다음 단계를 수행하세요.

  1. API에 대한 업데이트된 Swagger를 확인하도록 커넥터를 다시 게시합니다.
  2. 해당 커넥터를 사용하는 모든 앱에서 모든 연결/데이터 소스를 제거합니다.
  3. 해당 커넥터에 대한 연결/데이터 소스를 앱에 다시 추가합니다.

5. 커넥터 공유

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

조직 내에서 사용자 지정 커넥터 공유에서 자세히 알아보세요.

6. 커넥터 인증

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

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

Virtual Network 지원

가상 네트워크에 연결된 환경에서 커넥터를 사용하는 경우 다음과 같은 제한이 적용됩니다. Power Platform

  • 사용자 정의 코드를 사용하는 경우 제한 사항은 사용자 정의 커넥터에 코드 작성에서 설명되어 있습니다.

  • 환경이 가상 네트워크에 연결되기 전에 만들어진 사용자 지정 커넥터는 다시 저장해야 합니다.

  • 사용자 지정 커넥터를 호출하지 않고 위치 헤더를 반환하는 트리거는 지원되지 않습니다.

피드백 제공

커넥터 플랫폼 문제 또는 새로운 기능 아이디어에 대한 피드백에 감사 드립니다. 피드백을 제공하려면 문제 제출 또는 커넥터 관련 도움말 받기 로 이동하여 피드백 유형을 선택하세요.