Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps는 Microsoft 및 검증된 서비스에 연결하기 위한 1,000개 이상의 커넥터를 제공하고 Microsoft Copilot Studio는 이러한 사전 구축된 커넥터를 사용할 수 있지만 사전 구축된 커넥터로 제공되지 않는 서비스와 통신해야 할 수도 있습니다. 사용자 지정 커넥터는 고유한 트리거 및 동작으로 커넥터를 만들고 심지어 공유할 수 있도록 하여 이 시나리오를 해결합니다.
수명 주기
1. API 구축
사용자 지정 커넥터는 REST API를 둘러싸는 래퍼로 Logic Apps, Power Automate, Power Apps 또는 Copilot Studio에서 해당 REST 또는 SOAP API와 통신합니다. 이러한 API는 다음과 같이 사용될 수 있습니다.
Logic Apps는 SOAP API도 지원합니다.
작성 및 관리하려는 공개 API의 경우 다음 Microsoft Azure 제품 중 하나를 사용하십시오.
비공개 API의 경우 Microsoft는 온-프레미스 데이터 게이트웨이를 통해 온-프레미스 연결을 제공합니다.
2. API 보호
API 및 커넥터에 다음 표준 인증 방법 중 하나를 사용합니다(Microsoft Entra ID 권장).
- 일반 OAuth 2.0
- Microsoft Entra ID, Dropbox, GitHub 및 SalesForce를 포함한 특정 서비스에 대한 OAuth 2.0
- 인증 유형
- API 키
인증을 구현할 필요가 없도록 Azure Portal에서 API에 대한 Microsoft Entra ID 인증을 설정할 수 있습니다. 또는 API 코드에서 인증을 요구하고 시행할 수 있습니다. 사용자 지정 커넥터에 대한 Microsoft Entra ID에 대해 자세히 알아보려면 Microsoft Entra ID로 API 및 커넥터 보호를 참조하십시오.
2.1. OAuth 2.0
OAuth 2.0을 사용하여 자동으로 인증하는 새로 만든 사용자 지정 커넥터에는 커넥터별 리디렉션 URI가 있습니다. 2024년 2월 17일 이전에 커넥터별 리디렉션 URI를 사용하도록 기존 OAuth 2.0 커넥터를 업데이트해야 합니다.
- 웹 인터페이스를 사용하여 사용자 지정 커넥터를 만든 경우 사용자 지정 커넥터를 편집하고, 보안 탭으로 이동하고, 고유한 리디렉션 URL로 업데이트 확인란을 선택한 다음, 커넥터별 리디렉션 URI를 사용하도록 저장합니다.
-
명령줄 인터페이스(CLI) 도구를 사용하는 다중 인증을 사용하여 사용자 지정 커넥터를 만든 경우 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 또는 Copilot Studio가 API와 통신할 수 있도록 API를 설명하는 것입니다. Outlook용 Microsoft Dynamics CRM을 지원하는 접근 방식은 다음과 같습니다.
OpenAPI 정의(이전의 Swagger)
Postman 컬렉션
사용자 지정 커넥터 포털을 사용하여 처음부터 시작합니다( Power Automate 및 Power Apps만 해당)
OpenAPI 정의와 Postman 컬렉션은 서로 다른 형식을 사용하지만 둘 다 API를 설명하는 언어에 관계없이 머신에서 읽을 수 있는 문서입니다. API에서 사용하는 언어 및 플랫폼에 따라 다양한 도구에서 이러한 문서를 생성할 수 있습니다. 백그라운드에서 Logic Apps, Power Automate, Power Apps 및 Copilot Studio는 OpenAPI를 사용하여 커넥터를 정의합니다.
4. Copilot Studio, Logic Apps, Power Automate 또는 Power Apps 앱에서 커넥터 사용
사용자 지정 커넥터는 미리 빌드된 커넥터와 동일한 방식으로 사용됩니다. 해당 연결을 사용하여 사용자 지정 커넥터에 노출된 작업을 호출하려면 API에 대한 연결을 만들어야 합니다.
Power Automate에서 만든 커넥터는 Power Apps 및 Copilot Studio에서 사용할 수 있으며 Power Apps에서 만든 커넥터는 Power Automate 및 Copilot Studio에서 사용할 수 있습니다. 이 가용성은 Logic Apps에서 만든 커넥터에는 해당되지 않습니다. 그러나 OpenAPI 정의 또는 Postman 컬렉션을 재사용하여 이러한 서비스에서 커넥터를 다시 만들 수 있습니다. 자세한 내용은 해당 자습서를 참조하십시오.
팁
API에서 필드를 업데이트(제거, 추가 또는 변경)하는 경우 다음 단계를 수행합니다.
- API에 대해 업데이트된 Swagger를 표시하도록 커넥터를 다시 게시합니다.
- 해당 커넥터를 사용한 모든 앱에서 연결/데이터 원본을 제거합니다.
- 해당 커넥터에 대한 연결/데이터 원본을 앱에 다시 추가합니다.
5. 커넥터 공유
Copilot Studio, Logic Apps, Power Automate 또는 Power Apps에서 리소스를 공유하는 것과 같은 방식으로 조직의 사용자와 커넥터를 공유할 수 있습니다. 공유는 선택 사항이지만 다른 사용자와 커넥터를 공유하려는 시나리오가 있을 수 있습니다.
조직에서 사용자 지정 커넥터 공유에서 자세히 알아보세요.
6. 커넥터 인증
커넥터를 Copilot Studio, Logic Apps, Power Automate 및 Power Apps의 모든 사용자와 공유하려는 경우 Microsoft 인증을 위해 커넥터를 제출해야 합니다. Microsoft는 커넥터를 검토하고 기술 및 콘텐츠 규정 준수를 확인하며 기능의 유효성을 검사합니다.
Virtual Network 지원
Virtual Network에 연결된 Power Platform 환경에서 커넥터를 사용하는 경우 다음과 같은 제한 사항이 적용됩니다.
사용자 지정 코드를 사용하는 경우 사용자 지정 커넥터에 코드 쓰기에 제한 사항이 설명되어 있습니다.
환경이 Virtual Network에 연결되기 전에 만든 사용자 지정 커넥터를 다시 저장해야 합니다.
사용자 지정 커넥터로 다시 호출하지 않는 위치 헤더를 반환하는 트리거는 지원되지 않습니다.
피드백 제공
커넥터 플랫폼 문제 또는 새로운 기능 아이디어에 대한 피드백에 감사 드립니다. 피드백을 제공하려면 문제 제출 또는 커넥터 관련 도움말 보기로 이동하여 피드백 유형을 선택하십시오.