Microsoft 인증을 위한 커넥터 제출

아티클
06/23/2023

이 토픽에서는 다음 방법에 대해 설명합니다.

커넥터를 오픈 소스 리포지토리에 게시합니다.
ISV Studio에서 인증을 위한 커밋 정보를 제출합니다. (이 단계는 독립 판매자에게는 적용되지 않습니다.)

일반적으로 인증 프로그램의 일부로 오픈 소싱이 필요합니다. 문제가 있는 경우 Microsoft 담당자에게 문의하세요.

커넥터 오픈 소스

이 섹션은 확인된 게시자(독립 게시자 포함)에게 적용됩니다.

중요

불일치를 줄이려면 인증 포털에 커넥터를 추가하기 전에 커넥터를 공개해야 합니다. GitHub에 처음 기여하는 경우 Power Platform 샘플 - 첫 기여 세션에 참여하십시오.

오픈 소스 리포지토리에서 끌어오기 요청을 엽니다.
Microsoft 인증 엔지니어가 최초 요청 후 영업일 기준 1~2주 이내에 피드백을 제공합니다. 피드백에 커넥터 업데이트가 필요한 경우 끌어오기 요청에 대한 업데이트를 제출해야 합니다. 이를 위해 추가로 1~2주를 허용합니다.

커넥터 소유권을 유지하고, 커넥터의 변경을 수락하거나 거부할 수 있습니다.
Microsoft는 끌어오기 요청을 승인하고 병합합니다. 커넥터의 끌어오기 요청이 병합되는 즉시 커넥터 아티팩트를 ISV Studio에 제출할 수 있습니다. 지침을 보려면 ISV 스튜디오에 제출로 이동합니다.

커넥터 오픈소싱의 이점

커넥터를 오픈 소싱하면 다음과 같은 여러 가지 이점이 있습니다.

이전에 기본적으로 릴리스된 변경할 수 없는 커넥터에 기능을 쉽게 추가합니다.
커넥터의 향상 및 유지 관리를 위해 개발자 커뮤니티의 기여를 활용합니다.
사용자가 기능 요청을 제출하고 기여할 수 있도록 플랫폼을 설정합니다.
커넥터 변경 사항에 대한 더 풍부한 추적 기록을 제공합니다.
여러 개발자가 협업할 수 있도록 지원합니다.

우리 프로그램에 대한 다음 사항이 중요합니다.

API가 아니라 커넥터 파일만 오픈 소싱합니다. 이 데이터는 이미 Microsoft Power Platform 공개 API를 통해 사용자가 액세스할 수 있습니다.
커넥터 아티팩트가 GitHub 리포지토리에 저장되어 공개적으로 사용할 수 있습니다. 여기서는 기존의 오픈 소스 커넥터를 볼 수 있습니다.
개인 식별 정보 데이터 또는 지적 재산은 리포지토리에 저장되지 않습니다.
Microsoft는 GitHub의 커넥터에 대한 CODEOWNERS 파일에 여러분을 추가하며 커넥터에 대한 변경 사항은 스스로 관리해야 합니다.

로컬 파일에서 업로드

오픈 소싱에서 예외를 받은 경우 로컬 커넥터 파일을 업로드하여 커넥터를 제출해야 합니다.

사용자 지정 커넥터 파일을 Microsoft에 제출할 .zip 보관 파일 형식으로 지정합니다.
유효성 검사를 통과하고 요구되는 3개의 커넥터 아티팩트 파일이 모두 포함된 보관 파일만 제출합니다.
- apiDefinition.swagger.json
- apiProperties.json
- 커넥터 아이콘
중요

macOS를 사용하는 경우 .zip 아카이브에 3개의 커넥터 아티팩트_파일만_포함되어 있는지 확인하십시오. 기본적으로 macOS에는 .zip 아카이브에 다른 폴더 및 파일이 포함되어 있습니다.

ISV Studio에 제출

이 섹션은 확인된 게시자(독립 게시자 제외)에게 적용됩니다.

커넥터의 끌어오기 요청이 병합되는 즉시 커넥터 아티팩트를 ISV 스튜디오의 커넥터 인증 탭에 제출합니다.

제출에 성공하면 영업일 기준 1~2주 이내에 인증 엔지니어로부터 회신을 받을 수 있습니다. 제출에 문제가 있는 경우 피드백을 기반으로 제출을 업데이트해야 합니다. 인증 엔지니어가 회신하는 데 영업일 기준 1~2주가 추가로 소요됩니다.

오픈 소싱에서 예외가 허용된 경우 Microsoft 담당자가 지시할 때까지 커넥터를 제출하지 마십시오. 제출하기 전에 인증 프로세스의 모든 단계를 수행하고 아티팩트를 검증했는지 확인하십시오.

검토를 위해 제출 버튼은 모든 필드에 유효한 입력이 포함된 경우 사용할 수 있습니다.

올바른 이메일 주소로 제출을 만들고 있는지 확인합니다.
ISV Studio의 커넥터 인증 탭에서 다음 방법 중 하나로 파일을 제출하라는 메시지가 표시됩니다.
- 오픈 소스 커넥터에서 GitHub 커밋 정보를 입력합니다.
  
  참고
  
  커넥터 PR의 최근 커밋 ID를 제공하고 있는지 확인합니다.
- 이전 단계에서 만든 .zip 아카이브를 업로드합니다.
ISV Studio에 다음 정보를 입력하세요.
- 커넥터 테스트 정보 및 자격 증명:
  - 원활한 테스트를 위해 가능한 한 많은 정보를 제공합니다. 올바른 테스트 정보를 제공하고 있는지 확인합니다.
  중요
  
  커넥터 유형이 OAuth인 경우 유효한 클라이언트 ID와 클라이언트 암호를 제공하고 있는지 확인합니다. 이 정보는 제출 후에 변경할 수 없습니다. 수신되면 Azure Key Vault에 저장됩니다.
  
  이를 변경하려면 Microsoft 연락처에 연결하세요.
  - 커넥터에서 인증 유형으로 OAuth를 사용하는 경우 허용 목록에 추가된 다음 리디렉션 URL을 앱에 추가합니다.
    
    https://global.consent.azure-apim.net/redirect
    https://global-test.consent.azure-apim.net/redirect
  - MFA(다단계 인증)를 사용하는 계정을 제공하지 말고, 만약 그럴 경우 인증 팀이 다단계 인증–보호 계정에 제대로 액세스할 수 있는 단계를 알려주세요.
- 문제가 있는 경우 Microsoft에 연락할 수 있는 지원 이메일입니다.
커넥터 아티팩트를 제출하는 데 어려움이 있는 경우 Microsoft 담당자에게 문의하십시오.
아티팩트를 제출한 후 intro.md를 활동 제어 또는 기능 문서에 별도로 첨부하세요. 이 intro.md는 커넥터의 공개 문서에 포함됩니다. 이는 오픈 소싱 단계에서 제출한 readme.md와는 별개입니다.

커넥터의 작업 또는 트리거에 대한 정보는 인증 중에 자동으로 생성되니 intro.md 내에 포함하지 마십시오.
(필수) intro.md 파일에 대한 템플릿의 예로 다음 마크 다운을 사용하세요.

Provide a detailed description here, distinct from your connector's description, of the value that the connector offers users and a high-level overview of functionality that the connector supports. This description should be no more than one paragraph of eight sentences.

## <a name="prerequisites"></a>Prerequisites

Provide information about any prerequisites that are required to use this connector. For example, an account on your website or a paid service plan. 

## <a name="how-to-get-credentials"></a>How to get credentials

Provide detailed information about how a user can get credentials to use the connector. Where possible, this should be step-by-step instructions with links pointing to relevant parts of your website.

If your connector doesn't require authentication, this section can be removed.

## <a name="get-started-with-your-connector"></a>Get started with your connector

Provide users with a step-by-step process for getting started with your connector. This is where you should highlight common use cases, such as your expected popular triggers and actions, and how they can help in automation scenarios. Include images where possible.

## <a name="known-issues-and-limitations"></a>Known issues and limitations

If your connector has any known issues and limitations, include a detailed description of them here. This information should be as robust as possible so users have plenty of information should they run into problems. If any workarounds are known, include them here.

## <a name="common-errors-and-remedies"></a>Common errors and remedies

Highlight any errors that might commonly occur when using the connector (such as HTTP status code errors), and what the user should do to resolve the error.

## <a name="faq"></a>FAQ

Provide a breakdown of frequently asked questions and their respective answers here. This can cover FAQs about interacting with the underlying service or about the connector itself.

커넥터와 intro.md을 제출하면 커넥터 테스트를 준비할 수 있습니다. 지침은 인증에서 커넥터 테스트를 참고하십시오.

인증 전에 제출 업데이트

이 섹션은 확인된 게시자(독립 게시자 제외)에게 적용됩니다.

다음 상황에서는 인증 과정에 있지만 아직 인증되지 않은 커넥터만 업데이트해야 합니다.

Microsoft에서 변경을 요청한 경우.
인증 전에 해결해야 할 중요한 문제를 발견한 경우.

중요

인증 프로세스 중 업데이트가 있으면 프로세스가 재설정됩니다. 업데이트 제출 후 오픈 소스 리포지토리에서 업데이트된 아티팩트와 함께 끌어오기 요청을 제출합니다.

업데이트를 제출하는 방법:

ISV Studio의 커넥터 인증 탭으로 이동하여 기존 제출을 선택합니다.
오른쪽에 열리는 창에서 최신 버전을 선택합니다.
커넥터 제출 보기의 왼쪽 하단 모서리에서 업데이트 제출을 선택합니다.
편집 확인 프롬프트에서 확인을 선택합니다. 인증 프로세스가 재설정됩니다.
제거를 선택하여 기존 커넥터 아카이브를 제거하십시오. 다음 중 하나를 수행합니다.
- GitHub 통합을 사용하여 오픈 소스 리포지토리에서 업데이트된 아티팩트 수집
- 업데이트된 .zip 보관소 업로드
제출 양식의 필드를 입력합니다. 최신 업데이트에 적용되는 적절한 정보—테스팅 포함—를 제공하고 있는지 확인합니다.
커넥터 제출 보기의 왼쪽 하단 모서리에서 검토를 위해 제출을 선택합니다. 다음 이미지에 표시된 확인 메시지가 보이고 Microsoft에서 검토 프로세스를 시작합니다.