Condividi tramite

Rinnovare una chiave ID di Microsoft Store

  • Articolo

Usa questo metodo per rinnovare una chiave di Microsoft Store. Quando si generare una chiave ID di Microsoft Store, la chiave è valida per 30 giorni. Prima della scadenza della chiave, è possibile usarla per rinegoziare una nuova chiave usando questo metodo.

La libreria Microsoft.StoreServices fornisce la funzionalità di questo metodo tramite l'API UserStoreId.RefreshStoreId.

Nota

In precedenza le chiavi di Microsoft Store avevano una durata più lunga e in alcuni casi erano in grado di essere rinnovate dopo la scadenza della chiave. Ora, gli sviluppatori devono aspettarsi che le chiavi siano rinnovabili solo durante la loro durata e devono annotare la data di scadenza delle chiavi per rinnovarle prima della scadenza.

Importante

Anche se le chiavi di Microsoft Store possono essere rinnovate prima della scadenza, le chiavi possono essere revocate prima delle date di scadenza in risposta ai problemi di sicurezza. Pertanto, i servizi devono gestire il caso in cui un tentativo di rinnovo non riesce con AuthenticationTokenInvalid. In questo caso, devi generare una nuova chiave di Microsoft Store per l'utente nel client o il metodo usato per generare la chiave originale di Microsoft Store.

Prerequisiti

Per usare questo metodo, è necessario:

Per ulteriori informazioni, vedere Gestire le autorizzazioni dei prodotti da un servizio.

Richiesta

Sintassi della richiesta

Tipo di chiave Metodo URI della richiesta
Collezioni INSERISCI https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
Acquista INSERISCI https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

Intestazione della richiesta

Intestazione Digitare Descrizione
Host corda Deve essere impostato al valore collections.mp.microsoft.com oppure purchase.mp.microsoft.com.
Lunghezza del contenuto numero Lunghezza del corpo della richiesta.
Tipo di contenuto corda Specifica il tipo di richiesta e risposta. Attualmente, l'unico valore supportato è application/json.

Corpo della richiesta

Parametro Digitare Descrizione Obbligatorio
ticket di servizio corda Token di accesso Entra ID. Sì
chiave corda Chiave ID di Microsoft Store scaduta. Sì

Esempio di richiesta

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

Risposta

Corpo della risposta

Parametro Digitare Descrizione
chiave corda Chiave di Microsoft Store aggiornata che può essere usata nelle chiamate future all'API delle raccolte di Microsoft Store o all'API di acquisto.

Esempio di risposta

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

Codici di errore

Codice Errore Codice di errore interno Descrizione
401 Non autorizzato Token di Autenticazione Non Valido Il token di accesso Entra ID o la chiave di Microsoft Store rinnovata non sono validi. In alcuni casi, i dettagli dell'errore di servizio conterranno ulteriori informazioni, ad esempio quando il token è scaduto o la dichiarazione dell'appid è mancante.
401 Non autorizzato InconsistentClientId L'attestazione clientId nella chiave ID di Microsoft Store e l'attestazione appid nel token di accesso Entra ID non corrispondono.