사용자 지정 커넥터 개요
Azure Logic Apps, Microsoft Power Automate 및 Microsoft Power Apps에서는 1,000개의 커넥터를 제공하여 Microsoft 및 인증된 서비스에 연결할 수 있도록 지원합니다. 물론 사전 빌드된 커넥터를 사용할 수 없는 서비스에 연결해야 할 경우도 있을 수 있습니다. 사용자 지정 커넥터는 고유한 트리거 및 동작으로 커넥터를 만들고 심지어 공유할 수 있도록 하여 이 시나리오를 해결합니다.
수명 주기
1. API 구축
사용자 지정 커넥터는 REST API를 둘러싸는 래퍼로 Logic Apps, Power Automate 또는 Power Apps에서 해당 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가 있습니다. 기존 OAuth 2.0 커넥터는 2024년 2월 17일 이전에 커넥터별 리디렉션 URI를 사용하도록 업데이트되어야 합니다.
- 웹 인터페이스를 사용하여 사용자 지정 커넥터를 만든 경우 사용자 지정 커넥터를 편집하고, 보안 탭으로 이동하고, 고유한 리디렉션 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가 API와 통신할 수 있도록 API를 설명하는 것입니다. Outlook용 Microsoft Dynamics CRM을 지원하는 접근 방식은 다음과 같습니다.
OpenAPI 정의(이전의 Swagger)
Postman 컬렉션
사용자 지정 커넥터 포털을 사용하여 처음부터 시작합니다( Power Automate 및 Power Apps만 해당)
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에서 필드를 업데이트(제거, 추가 또는 변경)하는 경우 다음 단계를 수행하세요.
- API에 대한 업데이트된 Swagger를 확인하도록 커넥터를 다시 게시합니다.
- 해당 커넥터를 사용하는 모든 앱에서 모든 연결 / 데이터 원본를 제거하세요.
- 해당 커넥터에 대한 연결 / 데이터 원본를 앱에 다시 추가합니다.
5. 커넥터 공유
Logic Apps, Power Automate 또는 Power Apps에서 리소스를 공유하는 것과 동일한 방식으로 조직의 사용자와 커넥터를 공유할 수 있습니다. 공유는 선택 사항이지만 다른 사용자와 커넥터를 공유하려는 시나리오가 있을 수 있습니다.
조직의 맞춤형 커넥터에 대한 자세한 내용은 공유 에서 확인하세요.
6. 커넥터 인증
커넥터를 Logic Apps, Power Automate 및 Power Apps의 모든 사용자와 공유하려는 경우 Microsoft 인증을 위해 커넥터를 제출할 수 있습니다. Microsoft는 커넥터를 검토하고 기술 및 콘텐츠 규정 준수를 확인하며 기능의 유효성을 검사합니다.
자세한 내용은 Microsoft 인증을 위해 커넥터 제출을 참조하세요.
Virtual Network 지원
Virtual Network에 연결된 Power Platform 환경에서 커넥터를 사용하는 경우 다음과 같은 제한 사항이 적용됩니다.
사용자 정의 코드를 사용하는 경우 제한 사항은 사용자 정의 커넥터에 코드 작성 에서 설명되어 있습니다.
환경가 가상 네트워크에 연결되기 전에 생성된 사용자 지정 커넥터는 다시 저장해야 합니다.
피드백 제공
커넥터 플랫폼 관련 문제 또는 새로운 기능 아이디어에 대한 피드백을 주셔서 정말 감사합니다. 피드백을 제공하려면 문제 제출 또는 커넥터 관련 도움말 보기로 이동하여 피드백 유형을 선택하십시오.