파트너 센터에서 API 액세스 설정
에 적용됨 : 파트너 센터 | 21Vianet에서 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터
이 문서에서는 파트너 센터 SDK에 대해 개발해야 하는 계정에 대해 설명합니다. 이 문서에서는 통합 샌드박스에서 통합 샌드박스 계정 만들고 테스트하는 방법도 설명합니다.
메모
API에 액세스하려면 테넌트가 CSP(클라우드 솔루션 공급자) 테넌트여야 하며 간접 공급자 또는 직접 청구 파트너여야 합니다.
계정 정의 이해
API 통합을 통합하고 테스트할 수 있도록 파트너 센터는 두 가지 종류의 계정을 지원합니다.
기본 파트너 계정
이 계정은 실제 고객을 위한 실제 주문을 만드는 곳입니다. 기본 계정에 로그인할 때 파트너 센터 SDK 또는 파트너 대시보드 UI를 사용하여 변경하거나 트랜잭션을 수행하면 실제 고객을 위한 공식 주문으로 처리됩니다. 청구서에 반영되며 회사는 비용을 지불할 책임이 있습니다.
통합 샌드박스 계정
이 계정은 광범위하게 배포하기 전에 코드 및 파트너 센터 API와의 통합을 테스트하기 위한 것입니다. 통합 샌드박스 계정에 로그인할 때 변경한 내용과 트랜잭션이 청구서에 표시되지만 청구서 금액을 지불할 필요는 없습니다. 청구서 PDF에는 "지불하지 마시오"라는 면책 조항이 포함되어 있습니다. 샌드박스 송장이며 아무런 조치도 필요하지 않습니다."
- 통합 샌드박스 계정과 기본 계정은 독립적으로 작동합니다. 관리자 계정, 사용자 계정, 고객, 주문, 구독 또는 기타 데이터를 공유하지 않습니다.
- 통합 샌드박스는 제한된 수의 고객, 주문, 구독, 라이선스 등의 트랜잭션을 지원합니다.
- 통합 샌드박스 계정은 정책에서만 통합 테스트 목적으로 사용됩니다.
- 통합 샌드박스 계정은 기본적으로 존재하지 않습니다. 파트너 센터 SDK를 사용하려는 경우 직접 만들어야 합니다.
계정 설정
이 섹션에서는 파트너 센터 SDK에 대한 기본 파트너 계정 및 통합 샌드박스 계정을 설정하는 방법을 설명합니다.
통합 샌드박스 만들기
전역 관리자 계정으로 파트너 센터 로그인한 다음, 설정(기어 아이콘)를 선택합니다.
메모
샌드박스를 만들려면 파트너 전역 관리자가
onmicrosoft.com도메인 별칭(예:alias@domain.onmicrosoft.com)을 사용하여 파트너 센터에 로그인해야 합니다. 사용자가 사용자 지정 도메인에 로그인하면 샌드박스 만들기가 실패합니다.계정 설정을 선택한 다음 통합 샌드박스.
메모
통합 샌드박스 옵션이 표시되지 않으면 전역 관리자 계정이 없을 수 있습니다. 이전에 설정된 통합 샌드박스 계정을 이미 사용하고 있을 수도 있습니다.
리셀러 샌드박스를 생성하세요.
- 지원 티켓을 열어 샌드박스 테넌트로 사용할 새 Microsoft Entra 테넌트를 만듭니다.
- 통합 샌드박스 페이지에서 필요한 모든 정보를 제공한 다음, 페이지 아래쪽에서 테넌트 연결하기를 선택합니다.
- 1단계에서 만든 새 테넌트에 대한 전역 관리자 자격 증명으로 로그인합니다.
성공적으로 로그인하면 재판매인 샌드박스 계정이 만들어집니다. 이 계정은 심사되지 않습니다. 계정 등록이 완료되는 즉시 활성화됩니다. 참조할 샌드박스 도메인을 기록해 둡니다.
새 통합 샌드박스 관리자 계정으로 다시 로그인합니다. 지정한 암호와 함께 자격 증명에
username@domain형식을 사용합니다.계정 설정을 통합 샌드박스 페이지에서 선택하여 샌드박스 계정 설정을 완료합니다.
API 액세스 활성화
계정이 설정되면 통합 샌드박스와 함께 파트너 센터 SDK를 사용하려면 먼저 API 액세스를 사용하도록 설정해야 합니다. 기본 파트너 계정과 통합 샌드박스 계정 모두에 대해 API에 개별적으로 액세스할 수 있도록 설정해야 합니다.
- 전역 관리자 계정으로 파트너 센터 로그인한 다음, 설정(기어 아이콘)를 선택합니다.
- 계정 설정을 선택한 다음, 앱 관리.
- 기존 앱이 아직 없는 경우 새 웹앱을 추가합니다. 기존 웹앱이 있는 경우 키 추가 단추를 선택합니다.
- 웹앱을 만드는 경우 앱 등록 정보, 특히 키 복사하여 안전한 장소에 저장합니다.
- 파트너 대시보드에서 로그아웃합니다.
- 통합 샌드박스 계정으로 다시 로그인합니다. 2-5단계를 반복하여 통합 샌드박스에서 API 액세스를 사용하도록 설정합니다.
코드 작성 및 테스트
통합 샌드박스에서 코드를 작성하고 코드를 테스트할 수 있습니다. Microsoft Entra ID를 사용하여 파트너 센터 인증 설정하려면 다음 정보가 필요합니다.
- 앱 ID/클라이언트 ID: 설정(기어 아이콘) 내의 등록된 애플리케이션 앱 ID>계정 설정>앱 관리에 나열됩니다.
- 키: 이전 섹션 새 웹앱을 만든 경우 해당 키를 사용합니다.
- 도메인: 통합 샌드박스용입니다.
테스트된 코드 실행
실제 고객 데이터와 함께 솔루션을 사용하려면 통합 샌드박스 자격 증명에서 기본 파트너 계정 자격 증명으로 변경해야 합니다.
기본 파트너 계정에서 테스트된 코드를 사용할 준비가 되면 Microsoft Entra 보안 토큰이 필요합니다. 이 보안 토큰은 통합 샌드박스 앱, 키 및 도메인 대신 파트너 센터 앱, 키 및 도메인을 기반으로 합니다.
- 파트너 센터 인증 단계에 따라 기본 파트너 센터 자격 증명을 사용하여 Microsoft Entra 보안 토큰을 가져옵니다. (이전에 통합 샌드박스에 대한 Microsoft Entra 보안 토큰을 가져오기 위해 다음 단계를 수행했습니다.)
- 코드의 통합 보안 토큰을 주 파트너 계정의 새 보안 토큰으로 바꾸십시오.