Aracılığıyla paylaş

Microsoft Store Kimlik anahtarını yenileme

  • Makale

Microsoft Store anahtarını yenilemek için bu yöntemi kullanın. bir Microsoft Store kimlik anahtarı oluşturduğunuzda anahtar 30 gün boyunca geçerlidir. Anahtarın süresi dolmadan önce, bu yöntemi kullanarak yeni bir anahtarı yeniden anlaşmak için kullanabilirsiniz.

Microsoft.StoreServices kitaplığı UserStoreId.RefreshStoreId API'sini kullanarak bu yöntemin işlevselliğini sağlar.

Not

Daha önce Microsoft Store anahtarlarının ömrü daha uzundu ve bazı durumlarda anahtarın süresi dolduktan sonra yenilenebiliyordu. Şimdi geliştiriciler, anahtarların yalnızca kullanım ömrü boyunca yenilenebilir olmasını beklemeli ve süresi dolmadan önce anahtarları yenilemek için anahtarlardaki süre sonu tarihini not etmelidir.

Önemli

Microsoft Store anahtarlarının süresi dolmadan önce yenilenebilmesine rağmen, güvenlik endişelerine yanıt olarak anahtarların süresi dolmadan önce iptal edilebilir. Bu nedenle, hizmetlerinizin AuthenticationTokenInvalid ile yenileme girişiminin başarısız olması durumunu işlemesi gerekir. Bu durumda, istemcideki kullanıcı için yeni bir Microsoft Store anahtarı veya özgün Microsoft Store anahtarını oluşturmak için kullanılan yöntemi oluşturmanız gerekir.

Önkoşullar

Bu yöntemi kullanmak için şunları yapmanız gerekir:

  • https://onestore.microsoft.com/.defaulthedef kitle URI değerine sahip bir Entra Kimliği erişim belirteci.
  • uygulamanızdaki istemci tarafı kodundan oluşturulan süresi dolmuş bir Microsoft Store kimlik anahtarı.

Daha fazla bilgi için bkz. bir hizmetten ürün yetkilendirmelerini yönetme.

İstek

İstek söz dizimi

Anahtar türü Yöntem İstek URI'si
Koleksiyon GÖNDERİ https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Satın alma YAYINLA https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

İstek üst bilgisi

Üstbilgi Tür Açıklama
Ev sahibi dizgi collections.mp.microsoft.com veya purchase.mp.microsoft.comdeğerine ayarlanmalıdır.
İçerik Uzunluğu sayı İstek gövdesinin uzunluğu.
İçerik Türü dizgi İstek ve yanıt türünü belirtir. Şu anda desteklenen tek değer application/json.

İstek gövdesi

Parametre Tür Açıklama Gerekli
servis bileti dizgi Entra Id erişim belirteci. Evet
anahtar dizgi Süresi dolan Microsoft Store kimlik anahtarı. Evet

İstek örneği

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…."
}

Yanıt

Yanıt gövdesi

Parametre Tür Açıklama
anahtar dizgi Microsoft Store koleksiyonları API'sine veya satın alma API'sine gelecek çağrılarda kullanılabilecek yenilenen Microsoft Store anahtarı.

Yanıt örneği

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….."
}

Hata kodları

Kod Hata İç hata kodu Açıklama
401 Yetkisiz Kimlik Doğrulama Jetonu Geçersiz Entra Id erişim belirteci veya yenilenen Microsoft Store Anahtarı geçersiz. Bazı durumlarda ServiceError'ın ayrıntıları belirtecin süresinin dolması veya appid talebi eksik olması gibi daha fazla bilgi içerir.
401 Yetkisiz InconsistentClientId Microsoft Store Kimlik anahtarındaki clientId talebi ve Entra Id erişim belirtecindeki appid talebi eşleşmiyor.