Solicitar uma ID da Store do Usuário para autenticação de serviço para serviço

1. ID de Coleções do Usuário para autenticar com o serviço de Coleções da Microsoft Store
2. ID de Compra do Usuário para autenticar com o serviço de Compra da Microsoft Store

1. Configure um aplicativo do Microsoft Entra ID.
2. Associe a ID do seu aplicativo do Microsoft Entra ao seu aplicativo cliente no Partner Center.
3. No seu serviço, crie tokens de acesso do Microsoft Entra ID que representem sua identidade de editor.
4. No seu jogo, crie uma chave de ID da Store do Usuário que represente a identidade do usuário e passe essa chave de volta para o seu serviço.
5. Autentique solicitações para as APIs da Microsoft Store.
6. Renove uma chave de ID da Store do Usuário quando ela expirar.

• Seu serviço: back-end seguro que cria tokens de acesso do Microsoft Entra e chama as APIs da Store.
• Seu jogo: cliente que cria chaves de ID da Store do Usuário para o usuário conectado e as passa para o seu serviço.

​

A biblioteca .NET Microsoft.StoreServices e o exemplo

• Biblioteca Microsoft.StoreServices
• Exemplo do Microsoft.StoreServices

​

Etapa 1: Configurar um aplicativo do Microsoft Entra ID

1. Se ainda não tiver feito isso, siga as instruções em Início Rápido: Registrar um aplicativo na plataforma de identidade da Microsoft para registrar um aplicativo Web app / API no Microsoft Entra ID.

   [!NOTE] Ao registrar seu aplicativo, escolha Web app / API como o tipo de aplicativo. Esse tipo permite recuperar uma chave (também chamada de segredo do cliente) para o seu aplicativo. Para chamar as APIs da Microsoft Store, você deve fornecer um segredo do cliente ao solicitar um token de acesso do Microsoft Entra ID em uma etapa posterior.

2. No Portal de Gerenciamento do Azure, acesse Microsoft Entra ID. Selecione seu diretório, App registrations no painel esquerdo e, em seguida, seu aplicativo.
3. Copie os valores de Application (client) ID e Directory (tenant) ID para usar mais tarde.
4. Crie e copie um novo segredo do cliente em Certificates & Secrets no painel esquerdo.

​

Etapa 2: Associar a ID do seu aplicativo do Microsoft Entra ao seu aplicativo cliente no Partner Center

1. Entre no Partner Center e selecione seu jogo.
2. Selecione Services > Product collections and purchases. Insira a ID do seu aplicativo do Microsoft Entra em um dos campos Client ID disponíveis.
3. Selecione Save.
4. Publique novamente o jogo e seus complementos na loja.

​

Etapa 3: Criar tokens de acesso do Microsoft Entra ID

​

Entendendo os diferentes tokens de acesso e URIs de público

​

Criando tokens de acesso

POST https://login.microsoftonline.com/<tenant_id>/oauth2/v2.0/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://onestore.microsoft.com/.default

• Defina client_id e client_secret com os valores do registro do seu aplicativo no Portal de Gerenciamento do Azure.
• Defina resource com o URI de público do tipo de token de que você precisa. Consulte Entendendo os diferentes tokens de acesso e URIs de público.

​

Etapa 4: Criar uma chave de ID da Store do Usuário

​

Para criar uma chave de ID de Coleções do Usuário para o serviço de Coleções da Microsoft Store

1. Passe para o jogo um token de acesso de Coleções que você criou na Etapa 3.
2. No jogo, chame XStoreGetUserCollectionsIdAsync para recuperar a chave de ID de Coleções do Usuário. Passe o token de acesso de Coleções como o parâmetro serviceTicket. Opcionalmente, passe seu identificador de usuário interno em publisherUserId.
3. Depois que seu aplicativo criar com êxito uma chave de ID de Coleções do Usuário, passe a chave de volta para o seu serviço.

​

Para criar uma chave de ID de Compra do Usuário para o serviço de Compra da Microsoft Store

1. Passe para o jogo um token de acesso de Compra que você criou na Etapa 3.
2. No jogo, chame XStoreGetUserPurchaseIdAsync para recuperar a chave de ID de Compra do Usuário. Passe o token de acesso de Compra como o parâmetro serviceTicket. Opcionalmente, passe seu identificador de usuário interno em publisherUserId.
3. Depois que seu aplicativo criar com êxito uma chave de ID de Compra do Usuário, passe a chave de volta para o seu serviço.

​

Etapa 5: Autenticar chamadas para as APIs da Microsoft Store

​

Etapa 6: Renovar uma chave de ID da Store do Usuário quando ela expirar

​

Informações adicionais

​

Diagrama da criação de uma chave de ID da Store do Usuário

​

Declarações em uma chave de ID da Store do Usuário

{
    "typ":"JWT",
    "alg":"RS256",
    "kid": "36D101AF67A9F61B8017FB96F91EDD4B22F05804",
    "x5t":"agA_pgJ7Twx_Ex2_rEeQ2o5fZ5g"
}

{
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/clientId": "1d577369placeholder7393beef1e13d",
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/payload": "placeholderytCRzCHSqnfczv3f0343wfSydx7hghfu0snWzMqyoAGy5DSJ5rMSsKoQFAccs1iNlwlGrX+/eIwh/VlUhLrncyP8c18mNAzAGK+lTAd2oiMQWRRAZxPwGrJrwiq2fTq5NOVDnQS9Za6/GdRjeiQrv6c0x+WNKxSQ7LV/uH1x+IEhYVtDu53GiXIwekltwaV6EkQGphYy7tbNsW2GqxgcoLLMUVOsQjI+FYBA3MdQpalV/aFN4UrJDkMWJBnmz3vrxBNGEApLWTS4Bd3cMswXsV9m+VhOEfnv+6PrL2jq8OZFoF3FUUpY8Fet2DfFr6xjZs3CBS1095J2yyNFWKBZxAXXNjn+zkvqqiVRjjkjNajhuaNKJk4MGHfk2rZiMy/aosyaEpCyncdisHVSx/S4JwIuxTnfnlY24vS0OXy7mFiZjjB8qL03cLsBXM4utCyXSIggb90GAx0+EFlVoJD7+ZKlm1M90xO/QSMDlrzFyuqcXXDBOnt7rPynPTrOZLVF+ODI5HhWEqArkVnc5MYnrZD06YEwClmTDkHQcxCvU+XUEvTbEk69qR2sfnuXV4cJRRWseUTfYoGyuxkQ2eWAAI1BXGxYECIaAnWF0W6ThweL5ZZDdadW9Ug5U3fZd4WxiDlB/EZ3aTy8kYXTW4Uo0adTkCmdLibw=",
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/userId": "infusQplaceholder/SZWoPB4FqLEwHXgZFuMJ6TuTY=",
    "http://schemas.microsoft.com/marketplace/2015/08/claims/key/refreshUri": "https://collections.mp.microsoft.com/v6.0/b2b/keys/renew",
    "iat": 1442395542,
    "iss": "https://collections.mp.microsoft.com/v6.0/keys",
    "aud": "https://collections.mp.microsoft.com/v6.0/keys",
    "exp": 1450171541,
    "nbf": 1442391941
}

​

Documentação de referência da API

• XStore (conteúdo da API)
  • Funções
    • XStoreGetUserCollectionsIdAsync
    • XStoreGetUserPurchaseIdAsync

​

Confira também