조회 API 인증

아티클
09/30/2024

적용 대상: 파트너 센터

이 문서에서는 조회 API에 액세스하기 위해 사용자 및 앱 토큰을 생성하도록 사용자 계정을 설정하는 방법을 요약합니다. 자세한 내용은 파트너 API 인증을 참조하세요.

필수 조건

이러한 파트너 역할 중 하나 이상이 있는 유효한 파트너 센터 계정: 조회 관리자 또는 조회 사용자입니다. 조회 역할을 사용하여 파트너 센터 계정 만들기를 참조하세요 .
Microsoft 파트너 위임이 추가된 Azure Portal의 Microsoft Entra ID(앱 등록)입니다. 클라이언트 앱 설정 참조 (Microsoft Entra ID)

REST 요청

토큰을 생성하려면 이 HTTP 스크립트를 실행하거나 동등한 POST 요청을 만듭니다.

POST https://login.microsoftonline.com/common/oauth2/token HTTP/1.1
Accept: application/json
Content-Type: application/x-www-form-urlencoded

resource=https://api.partner.microsoft.com
&grant_type=password
&scope=openid
&client_id={client-ID-here}
&client_secret={client-secret-here}
&username={partner-account-upn-here}
&password={partner-account-password-here}

샘플 요청

POST https://login.microsoftonline.com/common/oauth2/token HTTP/1.1
Accept: application/json
Content-Type: application/x-www-form-urlencoded

resource=https://api.partner.microsoft.com
&grant_type=password
&scope=openid
&client_id=00001111-aaaa-2222-bbbb-3333cccc4444
&client_secret=TestClientAppSecret23456
&username=john.doe@contoso.com
&password=PCTestPassword@123

REST 응답

응답 예제

HTTP/1.1 200 OK
Cache-Control: no-cache, no-store
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Content-Length: 1406

{"token_type":"Bearer","expires_in":"3600","ext_expires_in":"3600","expires_on":"1546469802","not_before":"1546465902","resource":"https://api.partner.microsoft.com","access_token":"token-value-removed"}

새 사용자 이름/암호 또는 클라이언트 ID 생성

새 사용자 이름/암호 또는 클라이언트 ID(Microsoft Entra ID)를 생성하려면 다음 단계를 사용합니다.

1단계: 조회 역할을 사용하여 파트너 센터 계정 만들기

관리자 계정으로 파트너 센터에 로그인하고 설정(기어)을 선택합니다.
사용자 관리를 선택한 다음 사용자 추가 단추를 선택합니다. 팝업 모달에서 새 사용자 만들기를 선택하고 계속합니다.
사용자의 FirstName, LastName, UserName 및 선택적으로 암호 복구 전자 메일을 입력합니다.
조회 역할: 동일한 페이지에서 아래로 이동하여 적절한 조회 특정 파트너 역할(조회 관리자, 조회 사용자)을 할당합니다.
- 조회 관리자는 연결된 모든 파트너 위치에 대한 조회를 만들고, 업데이트하고, 읽을 수 있습니다.
- 추천 사용자는 추천 팀에 있는 조회만 읽을 수 있습니다.
모든 사용자 세부 정보 및 역할 할당을 완료한 후 저장 단추를 선택합니다. 성공하면 새 사용자 이름(사용자 전자 메일 또는 upn)과 임시 암호가 생성됩니다.
암호를 재설정하고 계정을 활성화하려면 이러한 자격 증명을 복사하고 파트너 센터에 로그인합니다.

2단계: 클라이언트 앱 설정(Microsoft Entra ID)

관리자 계정으로 Azure Portal에 로그인합니다.
"앱 등록"를 검색하고 + 새 등록 단추를 선택합니다.
앱 이름(예: 파트너 센터 액세스 앱) 및 지원되는 계정 유형을 "단일 테넌트"(또는 요구 사항에 따라 옵트인)로 입력합니다.
등록 단추를 선택하고 새 앱 등록을 만드는 동안 기다립니다.
앱이 등록되면 클라이언트 ID를 찾고 이 데모에서 강조 표시된 대로 클라이언트 암호를 만듭니다.

다음으로, 파트너 센터 API 토큰을 생성할 수 있도록 하려면 이 클라이언트 앱에 API 권한 또는 위임(Microsoft 파트너)을 추가해야 합니다.
API 권한 관리를>선택한 다음 + 사용 권한 추가 단추를 선택합니다. 측면 패널에서 조직에서 사용하는 API 탭을 선택합니다.
API "Microsoft 파트너"를 검색하고 4990c*부터 애플리케이션(클라이언트) ID가 있는 API를 선택합니다. user_impersonation 확인란을 선택하고 권한 추가 단추를 선택합니다.

팁

"Microsoft 파트너"를 사용하여 검색해도 4990c* 앱을 찾을 수 없는 경우 "Microsoft 개발자 센터"로 검색하거나 전체 앱 ID를 사용하여 직접 검색해 보세요.
마지막으로 사용자는 추가된 권한에 대한 관리자 동의를 받아야 합니다. 동의를 부여하려면 관리자가 자신의 계정으로 로그인하고 앱으로 이동해야 합니다.

다음을 통해 공유