파트너 센터에서 API 액세스 설정

  • 아티클

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

이 문서에서는 파트너 센터 SDK를 고려하여 개발해야 하는 계정에 대해 설명합니다. 또한 이 문서에서는 통합 샌드박스 계정을 만들고 통합 샌드박스에서 테스트하는 방법에 대해서도 설명합니다.

참고 항목

API에 액세스하려면 테넌트가 CSP 테넌트여야 하며, 사용자는 간접 공급자 또는 직접 청구 파트너여야 합니다.

계정 정의

API 통합을 통합하고 테스트하는 데 도움이 되도록 파트너 센터는 다음 두 가지 종류의 계정을 지원합니다.

주 파트너 계정

이는 실제 고객의 실제 주문을 만드는 계정입니다. 기본 계정에 로그인할 때 파트너 센터 SDK 또는 파트너 대시보드 UI를 사용하여 변경하거나 트랜잭션을 수행하면 실제 고객을 위한 공식 주문으로 처리됩니다. 청구서에 반영되며 회사는 비용을 지불할 책임이 있습니다.

통합 샌드박스 계정

이는 코드를 광범위하게 배포하기 전에 해당 코드를 테스트하고 파트너 센터 API와 통합하기 위한 계정입니다. 통합 샌드박스 계정에 로그인했을 때 변경한 내용과 트랜잭션이 청구서에 표시되지만 청구서 금액을 지불할 필요가 없습니다. 청구서 pdf에는 "지불하지 마세요. 이는 샌드박스 청구서이며 별도의 조치가 필요하지 않습니다."라는 고지 사항이 있습니다.

통합 샌드박스 계정과 기본 계정은 독립적으로 작동하며, 관리자 계정, 사용자 계정, 고객, 주문, 구독 또는 기타 데이터를 공유하지 않습니다.

통합 샌드박스는 제한된 수의 고객, 주문, 구독, 라이선스 등이 포함된 트랜잭션을 지원합니다.

통합 샌드박스 계정은 정책에 따라 통합 테스트 용도로만 사용됩니다.

기본적으로 통합 샌드박스 계정이 없습니다. 따라서 파트너 센터 SDK를 사용하려면 이 계정을 직접 만들어야 합니다.

계정 설정

이 섹션에서는 파트너 센터 SDK의 주 파트너 계정 및 통합 샌드박스 계정을 설정하는 방법에 대해 설명합니다.

통합 샌드박스 만들기

  1. 전역 관리자 계정으로 파트너 센터에 로그인하고 설정(기어)를 선택합니다.

    참고 항목

    샌드박스를 만들려면 파트너 글로벌 관리 파트너 센터에 로그인해야 onmicrosoft.com 기본 별칭(예: alias@domain.onmicrosoft.com)을 사용해야 합니다. 사용자가 사용자 지정 작업을 사용하여 로그인하면 샌드박스 만들기가 실패합니다기본.

  2. 계정 설정을 선택한 다음 통합 샌드박스를 선택합니다.

    참고 항목

    통합 샌드박스 옵션이 표시되지 않으면 글로벌 관리자 계정이 없을 수 있습니다. 또한 통합 샌드박스 계정을 사용하고 있을 수 있으며, 통합 샌드박스가 이미 설정되어 있습니다.

  3. 통합 샌드박스 관리자 계정에 대한 연락처 정보를 입력합니다. 그런 다음, 계정 만들기를 선택합니다. 계정이 만들어졌다는 확인 메시지가 표시될 때까지 몇 분 정도 기다립니다.

  4. 확인 메시지가 표시되면 파트너 대시보드에서 로그아웃합니다.

  5. 새 통합 샌드박스 관리자 계정을 사용하여 다시 로그인합니다. 지정한 암호와 함께 username@domain 형식을 자격 증명에 사용해야 합니다.

  6. 통합 샌드박스 페이지에서 계정 설정을 선택하여 샌드박스 계정 설정을 완료합니다.

API 액세스 사용

계정이 설정된 후에는 통합 샌드박스와 함께 파트너 센터 SDK를 사용하기 전에 API 액세스를 사용하도록 설정해야 합니다. 주 파트너 계정과 통합 샌드박스 계정 모두에 대해 별도로 API에 액세스하도록 설정해야 합니다.

  1. 전역 관리자 계정으로 파트너 센터에 로그인하고 설정(기어)를 선택합니다.

  2. 계정 설정을 선택한 다음 앱 관리를 선택합니다.

  3. 아직 기존 앱이 없는 경우 새 웹앱을 추가합니다. 기존 웹앱이 있는 경우 키 추가 단추를 선택합니다.

  4. 웹앱을 만드는 경우 앱 등록 정보, 특히 키를 복사하여 안전한 위치에 저장합니다.

  5. 파트너 대시보드에서 로그아웃합니다.

  6. 통합 샌드박스 계정을 사용하여 다시 로그인합니다. 2-5단계를 반복하여 통합 샌드박스에서 API 액세스를 사용하도록 설정합니다.

코드 작성 및 테스트

통합 샌드박스에서 코드를 작성하고 테스트할 수 있습니다. Microsoft Entra ID를 사용하여 파트너 센터 인증을 설정하려면 다음 정보가 필요합니다.

항목 이름 항목 위치
앱 ID/클라이언트 ID 설정(기어)에서 계정 설정, 앱 관리를 선택합니다. 앱 ID/클라이언트 ID가 등록된 애플리케이션 앱 ID로 나열됩니다.
키 API 액세스 사용 섹션에서 웹앱을 만든 경우 5단계에서 저장한 키입니다.
도메인 통합 샌드박스에 대한 도메인입니다.

테스트된 코드 실행

실제 고객 데이터와 함께 솔루션을 사용하려면 통합 샌드박스 자격 증명에서 주 파트너 계정 자격 증명으로 변경해야 합니다.

기본 파트너 계정에서 테스트된 코드를 사용할 준비가 되면 Microsoft Entra 보안 토큰을 가져와야 합니다. 이 보안 토큰은 통합 샌드박스 앱, 키 및 도메인 대신 파트너 센터 앱, 키 및 도메인을 기반으로 합니다.

  1. 파트너 센터 인증의 단계에 따라 기본 파트너 센터 자격 증명을 사용하여 Microsoft Entra 보안 토큰을 가져옵니다. (이전에 통합 샌드박스에 대한 Microsoft Entra 보안 토큰을 가져오기 위해 다음 단계를 수행했습니다.)

  2. 코드의 통합 보안 토큰을 주 파트너 계정에 대한 새 보안 토큰으로 바꿉니다.