다음을 통해 공유

Microsoft Store ID 키 갱신

  • 아티클

이 방법을 사용하여 Microsoft Store 키를 갱신합니다. Microsoft Store ID 키을 생성하면, 키는 30일 동안 유효합니다. 키가 만료되기 전에 이 메서드를 사용하여 새 키를 재협상하는 데 사용할 수 있습니다.

Microsoft.StoreServices 라이브러리 UserStoreId.RefreshStoreId API를 통해 이 메서드의 기능을 제공합니다.

메모

이전에는 Microsoft Store 키의 수명이 더 길었으며 키가 이미 만료된 후 일부 경우에는 갱신할 수 있었습니다. 이제 개발자는 수명 동안만 키를 갱신할 것으로 예상해야 하며 만료되기 전에 키를 갱신하기 위해 키의 만료 날짜를 기록해야 합니다.

중요하다

Microsoft Store 키는 만료되기 전에 갱신할 수 있지만 보안 문제에 대한 응답으로 만료 날짜 이전에 키를 해지할 수 있습니다. 따라서 서비스는 AuthenticationTokenInvalid로 갱신 시도가 실패하는 경우를 처리해야 합니다. 이 경우 클라이언트에서 사용자에 대한 새 Microsoft Store 키 또는 원래 Microsoft Store 키를 생성하는 데 사용되는 메서드를 생성해야 합니다.

필수 구성 요소

이 메서드를 사용하려면 다음이 필요합니다.

  • Entra ID 액세스 토큰으로, 대상 URI 값이 https://onestore.microsoft.com/.default인 것입니다.
  • 앱클라이언트 쪽 코드에서 생성된 만료된 Microsoft Store ID 키입니다.

자세한 내용은 서비스제품 자격 관리를 참조하세요.

요청

요청 구문

키 유형 메서드 요청 URI
수집품 올리기 https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
구매하다 올리기 https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

요청 헤더

머리글 유형 묘사
호스트 문자열 collections.mp.microsoft.com 또는 purchase.mp.microsoft.com값으로 설정해야 합니다.
콘텐츠-길이 숫자 요청 본문의 길이입니다.
Content-Type 문자열 요청 및 응답 유형을 지정합니다. 현재 지원되는 값은 application/json입니다.

요청 본문

매개 변수 유형 설명 필수
서비스 티켓 문자열 Entra ID 액세스 토큰입니다. 예
열쇠 문자열 만료된 Microsoft Store ID 키입니다. 예

요청 예제

POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew HTTP/1.1
Content-Length: 2774
Content-Type: application/json
Host: collections.mp.microsoft.com

{
    "serviceTicket": "eyJ0eXAiOiJKV1QiLCJhb….",
    "Key": "eyJ0eXAiOiJKV1QiLCJhbG…."
}

응답

응답 본문

매개 변수 유형 묘사
열쇠 문자열 Microsoft Store 컬렉션 API 또는 구매 API에 대한 향후 호출에 사용할 수 있는 새로 고친 Microsoft Store 키입니다.

응답 예제

HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyfHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2015 07:31:12 GMT

{
    "key":"eyJ0eXAi….."
}

오류 코드

코드 오류 내부 오류 코드 묘사
401 무단 인증 토큰이 유효하지 않습니다. 엔트라 ID 액세스 토큰 또는 갱신 중인 Microsoft Store 키가 잘못되었습니다. 경우에 따라 ServiceError의 세부 정보에 토큰이 만료되거나 appid 클레임이 누락된 경우와 같은 추가 정보가 포함됩니다.
401 무단 클라이언트 ID 불일치 Microsoft Store ID 키의 clientId 클레임 및 Entra ID 액세스 토큰의 appid 클레임이 일치하지 않습니다.