인증된 게시자 인증 프로세스

아티클
10/19/2023

이 프로세스는 확인된 게시자(독립 게시자 제외)용입니다. 독립 판매자인 경우 독립 판매자 인증 프로세스로 이동하세요.

사용자 지정 커넥터 개발을 완료한 후 다음 단계에 따라 인증을 준비하고 Microsoft에 제출할 커넥터 파일을 생성합니다.

참고

이 항목은 Azure Logic Apps, Power Automate, Power Apps의 사용자 지정 커넥터를 인증하는 방법을 설명합니다. 이 문서의 단계를 수행하기 전에 커넥터 인증 받기를 읽고 Microsoft에서 사용자 지정 커넥터를 등록하세요.

기본 인증 프로세스 워크플로

다음 순서도는 기본 인증 프로세스 워크플로를 보여줍니다. 이 문서에서 번호가 매겨진 단계는 워크플로에 해당합니다. 인증 프로세스를 완료하는 데 필요한 세부 정보를 제공해야 합니다.

순서도의 확장된 보기를 보려면 오른쪽 하단에 있는 돋보기 아이콘을 선택하세요.

이 순서도에 대한 자세한 내용을 보려면 심층 커넥터 인증 프로세스 워크플로로 이동하세요.

1단계: 커넥터 등록

인증을 적용하기 위해 사용자 지정 커넥터에 대한 개발을 완료할 필요가 없습니다. 인증 프로세스를 시작하려면 등록 양식을 작성하여 인증을 위해 커넥터를 등록하세요.

다음과 같은 Microsoft 담당자가 영업일 기준 2일 이내에 이메일을 보낼 예정입니다.

사용자 지정 커넥터를 이해합니다.
개발 프로세스에 대해 알아보십시오.
인증 프로세스를 안내합니다.

2단계: 제출 요건 충족

인증된 커넥터 간에 높은 수준의 품질과 일관성을 유지하기 위해 Microsoft는 사용자 지정 커넥터가 인증을 위해 준수해야 하는 요구 사항과 지침을 제공합니다.

커넥터에 제목 지정

반드시 존재해야 하며 영어로 작성해야 합니다.
기존 커넥터 제목과 다르고 고유해야 합니다.
제품 또는 조직의 이름이어야 합니다.
인증된 커넥터의 기존 명명 패턴을 따라야 합니다. 독립 게시자의 경우 커넥터 이름은 커넥터 이름(독립 게시자) 패턴을 따라야 합니다.
30자를 초과할 수 없습니다.
"API", "Connector"라는 단어 또는 Power Platform 제품 이름(예: "Power Apps")을 포함할 수 없습니다.
캐리지 리턴, 새 줄 또는 공백을 포함하여 영숫자가 아닌 문자로 끝날 수 없습니다.

예제

좋은 커넥터 제목: "Azure Sentinel", "Office 365 Outlook"
좋지 않은 커넥터 제목: "Azure Sentinel's Power Apps 커넥터", "Office 365 Outlook API"

커넥터에 대한 설명 작성

반드시 존재해야 하며 영어로 작성해야 합니다.
문법 및 맞춤법 오류가 없어야 합니다.
커넥터가 제공하는 주요 목적과 가치를 간결하게 설명해야 합니다.
30자보다 짧거나 500자보다 길 수 없습니다.
Power Platform 제품 이름(예: "Power Apps")을 포함할 수 없습니다.

커넥터 아이콘 디자인

이 섹션은 독립 판매자에게는 적용되지 않습니다.

100 x 100 ~ 230 x 230 픽셀 범위 내에서 1:1 크기의 로고를 만듭니다(둥근 모서리 없음).
불투명하고 흰색이 아닌 색상(#ffffff) 배경과 지정된 아이콘 배경 색상과 일치하는 기본 색상이 아닌 색상(#007ee5)을 포함해야 합니다.
인증된 다른 커넥터 아이콘과 다르게 고유해야 합니다.
"icon.png"와 같이 PNG 형식으로 제출해야 합니다.
로고 크기는 일관된 배경과 이미지 높이 및 너비의 70% 미만입니다.
브랜드 색상이 유효한 16진수 색상인지 확인하고 흰색(#ffffff) 또는 기본값(#007ee5)이 아니어야 합니다.

작업 및 매개 변수 요약 및 설명 정의

반드시 존재해야 하며 영어로 작성해야 합니다.
문법 및 맞춤법 오류가 없어야 합니다.
작업 및 매개변수 요약은 80자 이하의 구문이어야 하며 영숫자 또는 괄호만 포함해야 합니다.
작업 및 매개 변수 설명은 완전한 서술형 문장이어야 하며 구두점으로 끝나야 합니다.
Microsoft Power Platform 제품 이름(예: "Power Apps")을 포함할 수 없습니다.

정확한 작업 응답 정의

예상 응답만 있는 정확한 스키마로 작업 응답을 정의하세요.
정확한 스키마 정의와 함께 기본 응답을 사용하지 마십시오.
swagger의 모든 작업에 대해 유효한 응답 스키마 정의를 제공합니다.
응답 스키마가 동적인 특별한 경우를 제외하고 빈 응답 스키마는 허용되지 않습니다. 즉, 출력에 동적 콘텐츠가 표시되지 않으며 제작자는 JSON을 사용하여 응답을 구문 분석해야 합니다.
빈 작업은 허용되지 않습니다.
필요한 경우가 아니면 빈 속성을 제거하십시오.

Swagger 속성 확인

"openapidefinition"이 올바른 형식의 JSON 파일에 있는지 확인하세요.
Swagger 정의가 OpenAPI 2.0 표준 및 커넥터의 확장 표준을 준수하는지 확인하십시오.

연결 매개 변수 확인

속성이 "UIDefinition"(표시 이름, 설명)에 대한 적절한 값으로 업데이트되었는지 확인하세요.

연결 매개 변수가 기본 인증을 사용하는 경우 다음 예와 같이 JSON 형식이 올바른지 확인하세요.

{
  "username": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourUsernameLabel",
      "description": "The description of YourUsernameLabel for this api",
      "tooltip": "Provide the YourUsernameLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": true,
        "required": "true"
        }
  }
},
  "password": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourPasswordLabel",
      "description": "The description of YourPasswordLabel for this api",
      "tooltip": "Provide the YourPasswordLabel tooltip text",
      "constraints": {
        "tabIndex": 3,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

연결 매개 변수에 인증으로 APIKey가 있는 경우 다음 예와 같이 JSON 형식이 올바른지 확인하세요.

{
  "api_key": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourApiKeyParameterLabel",
      "tooltip": "Provide your YourApiKeyParameterLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

연결 매개 변수에 인증으로 일반 OAuth가 있는 경우 다음 예와 같이 JSON 형식이 올바른지 확인하세요.

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "oauth2",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "AuthorizationUrl": {
          "value": "https://contoso.com"
        },
        "TokenUrl": {
          "value": "https://contoso.com"
        },
        "RefreshUrl": {
          "value": "https://contoso.com"
        }
      },
      "clientId": "YourClientID"
    },
    "uiDefinition": null
  }
}

연결 매개 변수에 OAuth2 ID 공급자가 있는 경우 해당 ID 공급자가 지원되는 OAuth2 공급자 목록에 있는지 확인하세요. 다음은 GitHub OAuth2 ID 공급자의 예입니다.

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "github",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {},
      "clientId": "YourClientId"
    },
    "uiDefinition": null
  }
}

연결 매개 변수에 인증으로 Microsoft Entra ID가 있는 경우 다음 예와 같이 JSON 형식이 올바른지 확인하세요.

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "aad",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "LoginUri": {
          "value": "https://login.microsoftonline.com"
        },
        "TenantId": {
          "value": "common"
        },
        "ResourceUri": {
          "value": "resourceUri"
        },
        "EnableOnbehalfOfLogin": {
          "value": false
        }
      },
      "clientId": "AzureActiveDirectoryClientId"
    },
    "uiDefinition": null
  }
}

양질의 영어 문자열 만들기

커넥터는 Power Automate 현지화의 일부로 현지화되므로 커넥터를 개발할 때 영어 문자열의 품질이 번역 품질의 핵심입니다. 다음은 제공할 문자열의 값을 생성할 때 집중해야 할 몇 가지 주요 영역입니다.

모든 문자열 값에 오타가 없는지 확인하려면 맞춤법 검사 프로그램을 실행하세요. 불완전한 영어 문자열이 있으면 번역 결과가 불완전하거나 문맥상 정확하지 않습니다.
문장이 완전한 형태인지 확인하세요. 문장이 완전하지 않으면 낮은 품질의 번역이 생성될 수도 있습니다.
문장의 의미가 명확한지 확인하세요. 문장의 의미가 모호하면 품질이 떨어지거나 번역이 잘못될 수도 있습니다.
요약, x-ms-summaries, 설명이 문법적으로 올바른지 확인하십시오. 복사하여 붙여넣지 마십시오. 제품 내에서 어떻게 표시되는지 알아보려면 커넥터 문자열 지침으로 이동하십시오.
가능하면 런타임 복합 문자열을 사용하지 마세요. 대신 완전한 형식의 문장을 사용하세요. 연결된 문자열이나 문장은 번역을 어렵게 하거나 잘못된 번역을 유발할 수 있습니다.
약어를 사용하는 경우 명확하게 하기 위해 대문자로 표시해야 합니다. 이렇게 하면 인쇄상의 오류로 오인될 가능성이 줄어듭니다.
Camel 형식의 문자열(예: minimumHighways 또는 MinimizeHighways)는 일반적으로 번역 불가능한 것으로 간주됩니다. 문자열 값을 현지화하려면 CaMel 양식 문자열을 수정해야 합니다.

3단계: 솔루션 검사기를 실행하여 커넥터 유효성 검사

솔루션 검사기는 커넥터가 인증을 위해 Microsoft에서 요구하는 표준을 준수하는지 확인하기 위해 정적 분석을 수행하는 메커니즘입니다. Power Automate 또는 Power Apps의 솔루션에 커넥터를 추가하고 솔루션 검사기로 사용자 지정 커넥터 유효성 검사의 지침에 따라 솔루션 검사기를 실행합니다.

솔루션 검사기 실행 방법을 알아보려면 이 비디오를 시청하세요!

4단계: 메타데이터 추가

커넥터 아티팩트(파일)에는 커넥터 및 해당 엔드 서비스를 설명하는 특정 메타데이터가 포함되어야 합니다. 메타데이터로 제공되는 정보는 커넥터 설명서에 게시되며 모든 사용자가 공개적으로 액세스할 수 있습니다. 개인 정보나 기밀 정보를 제공하지 말고, 이 정보를 제공하는 데 문제가 있는 경우 Microsoft 담당자를 통해 알려주십시오. 메타데이터를 문서화하는 방법을 학습하려면 커넥터 참조 아래의 커넥터별 설명서 페이지 중 하나를 방문하세요.

4a단계: 판매자 및 stackOwner 속성

"판매자" 는 회사 또는 조직의 이름입니다. 전체 회사 이름을 제공합니다(예: "Contoso Corporation"). 영숫자 형식이어야 합니다.
"stackOwner" 는 커넥터가 연결되는 백엔드 서비스 스택의 소유 회사 또는 조직입니다. 영숫자 형식이어야 합니다.

게시자	Description	예
확인됨	ISV가 stackOwner를 대신하여 커넥터를 구축하지 않는 한 publisher와 stackOwner는 동일합니다.	"게시자": "Tesla", "stackOwner": "Tesla"
독립	스택 소유자와 게시자 소유자를 제공해야 합니다.	"게시자": "Nirmal Kumar", "stackOwner": "ITGlue"

파일 위치: apiProperties.json
자세히 알아보려면 API 속성 파일로 이동하십시오.

구문: 게시자 and stackOwner 속성은 apiProperties.json 파일 내에 최상위 속성으로 존재합니다. 다음과 같이 강조 표시된 줄을 추가합니다. 표시된 대로 특성 이름과 스키마를 정확히 입력했는지 확인하십시오.

샘플 코드 조각에서 사용할 수 있는 게시자 및 stackOwner 속성을 보여주는 스크린샷.

4c단계: 샘플 코드 조각

다음 코드 조각을 사용하여 정보를 복사하고 입력할 수 있습니다. 이전 섹션에서 설명한 대로 올바른 위치의 올바른 파일에 코드 조각을 추가했는지 확인하십시오.

    "publisher": "_____",
    "stackOwner": "_____"

    "contact": {
      "name": "_____",
      "url": "_____",
      "email": "_____"
    }

    "x-ms-connector-metadata": [
      {
        "propertyName": "Website",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Privacy policy",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Categories",
        "propertyValue": "_____;_____"
      }
    ]

참고

현재 stackOwner속성 및 Paconn CLI 도구 사용에 제한이 있습니다. 자세한 내용은 README 파일의 제한 사항을 참고하십시오.

4d단계: JSON 파일 형식 및 제한 사항

속성이 올바르게 정렬되었는지 확인합니다.
JSON을 Visual Studio Code에 붙여넣습니다. 맞춤법 검사기와 같은 확장자 및 JSON 플러그인과 같은 플러그인을 자유롭게 사용하십시오.
Swagger 파일은 1MB를 초과할 수 없습니다.
- 커넥터 구축을 시작하기 전에 커넥터 디자인을 고려하십시오. 커넥터를 2개 이상의 커넥터로 분류해야 하는지 판단하십시오.
- 더 큰 swagger 파일은 커넥터를 사용할 때 지연을 일으킬 수 있습니다.
예를 들어 플랫폼에 3개의 서로 다른 HubSpot 커넥터가 있습니다.

4e단계: 사용자 지정 커넥터 파일 유효성 검사

paconn validate --api-def [Location of apiDefinition.swagger.json]를 실행합니다. 도구에서 커넥터 정의의 유효성을 검사하고 제출 전에 수정해야 하는 오류를 알려줍니다.

커넥터에서 인증 유형으로 OAuth를 사용하는 경우 허용 목록에 추가된 다음 리디렉션 URL을 앱에 추가합니다.

https://global.consent.azure-apim.net/redirect/{apiname}
https://global-test.consent.azure-apim.net/redirect/{apiname}

5단계: 커넥터 아티팩트 준비

이 단계를 완료하는 데 약 1주일이 걸립니다.

참고

인증하기 전에 사양을 준수하고 커넥터의 품질을 보장했는지 확인하세요. 이렇게 하지 않으면 변경하라는 메시지가 표시되기 때문에 인증이 지연됩니다.
호스트 URL의 프로덕션 버전을 제공하십시오. 준비, 개발 및 테스트 호스트 URL은 허용되지 않습니다.

Microsoft에서 제공하는 명령줄 인터페이스(CLI) 도구를 사용하여 다운로드한 커넥터 아티팩트라는 파일 세트를 Microsoft에 제출합니다. 이 도구는 차단 오류에 대해 커넥터의 유효성을 검사합니다.

시작하려면 다음 단계를 수행하세요.

설치 지침에 따라 Microsoft Power Platform 커넥터 CLI 도구를 설치합니다.
paconn login을 실행하고 명령줄을 사용하여 Microsoft Power Platform에 로그인합니다. 지침에 따라 Microsoft의 디바이스 코드 프로세스를 사용하여 로그인합니다.
인증을 받은 후 사용자 지정 커넥터 파일을 다운로드합니다.
- paconn download를 실행합니다. 명령줄에서 커넥터의 번호를 지정하여 사용자 지정 커넥터가 있는 환경을 선택한 다음, 사용자 지정 커넥터 이름을 선택합니다.
도구는 폴더의 커넥터 아티팩트를 paconn을 실행한 파일 시스템 위치로 다운로드합니다. 게시자 유형에 따라 다양한 아티팩트가 표시됩니다.

게시자	아티팩트
확인됨	`apiDefinition.swagger.json` `apiProperties.json` `settings.json` 커넥터 아이콘
독립	`apiDefinition.swagger.json` `apiProperties.json`

검증된 게시자와 독립 게시자 모두 apiProperties.json을 자신의 아티팩트에 다운로드하게 됩니다. 이 파일에서 IconBrandColor를 설정해야 합니다.

확인된 게시자: apiProperties 파일에서 iconBrandColor를 브랜드 색상으로 설정합니다.
독립 게시자: apiProperties 파일에서 iconBrandColor를 "#da3b01"로 설정합니다.

Readme 파일 아티팩트 생성

Readme.md 파일은 독립 게시자와 인증된 게시자 모두에 필요합니다. 커넥터의 기능을 문서화하려면 Readme.md 파일을 만들어야 합니다. 포함할 문서 예제를 보려면 Readme.md 예제를 참조하십시오. GitHub 리포지토리에서 다른 Readme.md 파일을 보고 Readme.md 파일 작성에 대해 알아보십시오.

독립 게시자이고 커넥터가 OAuth를 사용하는 경우 자격 증명을 얻는 방법에 대한 지침을 포함해야 합니다.

팁

알려진 문제와 제한은 사용자를 최신 상태로 유지하기 위한 훌륭한 섹션입니다.

6단계: 배포를 위해 커넥터 제출

제출 과정에서 커넥터를 당사 Microsoft Power Platform 커넥터 리포지토리에 오픈 소싱하게 됩니다.

Microsoft 인증을 위해 커넥터 제출 지침을 따라 GitHub 및 인증 포털에 제출합니다.

인증된 게시자인 경우 사용자 지정 코드를 사용하는 경우 script.csx 파일을 제출해야 합니다.
오픈 소스 리포지토리 끌어오기 요청을 제출하면 Microsoft는 영업일 기준 1~2주 이내에 커넥터를 배포하고 유효성을 검사합니다. 업데이트가 필요한 경우 추가로 1~2주가 소요됩니다.

**커넥터에 OAuth가 있는 경우 ISV Studio에 패키지를 제출하고 커넥터 제출 요청에서 API 이름을 가져와 앱을 업데이트하세요.

제출의 일부로 Microsoft는 CLA-봇, Swagger Validator 및 호환성이 손상되는 변경 탐지기 도구를 사용하여 커넥터의 유효성을 검사합니다. Swagger 오류를 해결해야 하는 경우 Swagger 유효성 검사기 오류 수정으로 이동합니다.

7단계: 인증된 게시자가 수행한 테스트에 대한 기대치

커넥터의 유효성을 검사한 후 철저한 테스트를 수행하도록 요청합니다.

인증에서 커넥터 테스트의 지침에 따라 테스트 준비를 위해 프리뷰 영역에 환경을 만듭니다.
일주일 이내에 Microsoft 담당자에게 테스트를 완료했음을 알리고 배포를 시작할 수 있습니다.
커넥터의 기능과 콘텐츠가 Microsoft와 귀하 모두에 의해 검증된 후 테스트를 위해 미리 보기 영역에 배포할 커넥터를 준비합니다.

8단계: 배포 대기

테스트에 대한 유효성이 검증된 후 커넥터를 모든 제품 및 지역에 배포합니다.

중요

평균적으로 커넥터를 배포하는 데 영업일 기준 3~4주가 걸립니다. 이는 커넥터의 크기나 복잡성에 관계없이 새 커넥터인지 업데이트인지에 관계없이 필요합니다. 무결성을 보호하기 위해 커넥터는 모든 배포에서 따라야 하는 기능과 콘텐츠를 테스트하기 위해 동일한 유효성 검사 작업을 받게 됩니다.

지역에 대한 배포는 단계적으로 수행되므로 커넥터가 배포될 지역의 이름을 이메일로 알려드립니다. 배포 지연 또는 중단이 있는 경우 인증된 게시자는 ISV 포털의 활동 제어에서 상태를 찾을 수 있습니다. 독립 게시자는 이메일로 알림을 받습니다.

프로덕션 배포

프로덕션을 위한 커넥터 배포 일정은 금요일 아침(PST/PDT)에 시작됩니다. 다음 예정된 배포에 커넥터를 포함하려면 최소 24시간 전에 프로덕션 배포 준비가 되었음을 Microsoft에 알려야 합니다. 인증된 게시자는 ISV 포털의 활동 제어에서 알림을 보냅니다. 독립 게시자는 Microsoft 담당자에게 알릴 수 있습니다.

지역 배포

다양한 지역에 대한 배포는 미리 결정된 일일 순서로 이루어집니다. 지역은 다음과 같습니다.

테스팅.
미국 프리뷰.
일본과 인도를 제외한 아시아.
영국을 제외한 유럽.
브라질, 캐나다, 일본, 인도.
호주, 영국 및 미국.

예를 들어 커넥터가 월요일에 배포되도록 예약된 경우 1일차에 테스트 지역에 배포됩니다. 그런 다음 2일차에 미국 프리뷰 지역에 배포됩니다. 커넥터가 6개 지역 모두에 배포될 때까지 배포가 매일 계속됩니다.

토요일, 일요일 및 미국 공휴일에는 배포하지 않습니다.

커넥터가 인증을 마치면 Power Automate 블로그에서 커넥터에 대한 마케팅 기회에 대해 알려 드리겠습니다.

9단계: 배포 후 옵션 살펴보기

커넥터가 배포된 후 탐색할 수 있는 몇 가지 옵션은 다음과 같습니다:

ISV 포털에서 언제든지 커넥터 원격 분석을 볼 수 있습니다. 커넥터의 상태 및 사용량을 보려면 ISV 포털에서 인증된 커넥터에 대한 주요 인사이트 얻기를 참조하세요.
커넥터에 업데이트를 제출하십시오. 자세한 내용은 인증된 커넥터 업데이트를 참고하십시오.
커뮤니티 토론 포럼에서 커넥터를 모니터링하여 고객에게 문제가 발생하거나 커넥터에 대한 기능 요청이 있는지 확인합니다.
프리뷰 태그 제거를 요청하세요. 커넥터가 일정 기간 동안 공개적으로 사용 가능하고 특정 요구 사항을 충족하면 일반 공급 태그가 재할당될 수 있습니다. 이 태그는 커넥터가 생산 준비 제품임을 나타냅니다. 자세한 내용은 커넥터를 미리보기에서 일반 공급으로 이동을 참조하십시오.

제출 전 체크리스트

Microsoft 인증을 위한 커넥터 제출로 이동하기 전에 다음을 확인하십시오.

커넥터는 2단계: 제출 요건 충족 및 4단계: 메타데이터 추가에 설정된 모든 표준을 충족합니다.
요약, 설명 또는 가시성 정보가 누락된 작업이 없습니다.
작업이 예상대로 작동하는지 확인하기 위해 사용자 지정 커넥터를 테스트했습니다(작업당 최소 10개의 성공적인 호출).
런타임 또는 스키마 유효성 검사 오류가 사용자 지정 커넥터 마법사의 테스트 섹션에 나타납니다.

팁

YouTube 비디오, 블로그 또는 기타 콘텐츠를 만들어 커넥터 시작 방법에 대한 샘플이나 스크린샷을 공유합니다.
- Readme.md 파일에 링크를 포함하면 문서에 추가할 수 있습니다.
툴팁을 Swagger 파일에 추가하면 사용자를 도울 수 있습니다.

인증된 게시자(독립 게시자가 아님)인 경우 Microsoft 인증을 위해 제출할 때 파트너 계약 및 비공개 계약에 동의해야 합니다. 제출하기 전에 이러한 사용 약관과 언어를 검토하려면 Microsoft 담당자에게 문의하세요.

다음 단계

Microsoft 인증을 위한 커넥터 제출

피드백 제공

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