사용자 Microsoft Store ID 키 갱신

아티클
06/20/2024

이 항목에서는 사용자 저장소 ID 키를 갱신하는 방법에 대해 설명합니다.

사용자 Store ID 키를 생성하면 키 수명은 30일입니다. 30일 이내에 키는 Microsoft Store 서비스에 대한 인증에 적용됩니다. 토큰을 갱신하여 동일한 Entra 애플리케이션 클라이언트 ID 및 사용자 ID에 대한 새 사용자 저장소 ID를 생성할 수도 있습니다. 30일 동안 Microsoft Store 서비스를 호출할 때 사용자 Store ID가 적용되지만 전체 수명 동안 갱신될 수 있다는 보장은 없습니다. 이러한 키에 사용되는 서명 인증서는 자주 순환됩니다. 서명 인증서가 너무 오래된 경우 사용자 Store ID를 갱신할 때 거부됩니다. 따라서 캐시된 사용자 Store ID를 갱신하려면 적어도 14일마다 갱신하는 것이 좋습니다. 이렇게 하면 최신 서명 인증서가 사용되었으며 새 사용자 Store ID를 14일 이내에 다시 갱신할 수 있습니다.

사전 요건

사용자 저장소 ID 키를 갱신하려면 다음이 필요합니다.

대상 URI 값이 https://onestore.microsoft.com인 Microsoft Entra ID 액세스 토큰
앱의 클라이언트 쪽 코드에서 생성된 만료된 Microsoft Store ID 키.

자세한 내용은 서비스 간 인증을 위한 사용자 Microsoft Store ID 요청을 참조하세요.

요청

요청 구문

키 유형	메서드	요청 URI
`Collections`	`POST`	`https://collections.mp.microsoft.com/v6.0/b2b/keys/renew`
`Purchase`	`POST`	`https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew`

요청 헤더

헤더	형식	설명
`Host`	`string`	`collections.mp.microsoft.com` 또는 `purchase.mp.microsoft.com` 값으로 설정해야 합니다.
`Content-Length`	`number`	요청 본문의 길이입니다.
`Content-Type`	`string`	요청 및 응답 유형을 지정합니다. 현재 지원되는 유일한 값은 `application/json`입니다.

요청 본문

매개 변수	형식	설명	필수
`serviceTicket`	`string`	Microsoft Entra ID 서비스 액세스 토큰	예
`key`	`string`	만료된 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..."
}

응답

응답 본문

매개 변수	형식	설명
`key`	`string`	Microsoft Store 컬렉션 API 또는 구매 API에 나중에 호출할 때 사용할 수 있는 새로 고친 사용자 Microsoft Store ID 키입니다.

응답 예제

HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: bfebe80c-ff89-4c4b-8897-67b45b916e47
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2019 07:31:12 GMT

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

오류 코드

코드	오류	내부 오류 코드	설명
401	Unauthorized	`AuthenticationTokenInvalid`	Microsoft Entra ID 액세스 토큰이 잘못되었습니다. 경우에 따라 `ServiceError`의 세부 정보에 토큰 만료 시기 또는 `appid` 클레임 누락과 같은 추가 정보가 포함됩니다.
401	Unauthorized	`InconsistentClientId`	`clientId` 사용자 저장소 ID 키의 클레임 및 `appid` Microsoft Entra ID 액세스 토큰의 클레임이 일치하지 않습니다.