Autenticar seu serviço com as APIs da Microsoft Store

• User Store IDs e Microsoft Entra ID: vincula a autenticação e os resultados à conta de usuário conectada ao aplicativo Microsoft Store.
• X-tokens de autenticação delegada: vincula a autenticação e os resultados à conta dos XBOX services do usuário que está jogando o jogo no momento.

​

Autenticar com o Microsoft Entra ID e User Store IDs

Authorization: Bearer <Entra ID access token>  

  "sbx": "XDKS.1"

  "beneficiaries": [
    {
        "identitytype" : "b2b",
        "identityValue" : "eyJ0eXAiOiJ...",
        "localTicketReference" : "testReference"
    }
  ],

• Microsoft.StoreServices (GitHub): biblioteca e código-fonte para autenticar e chamar os serviços da Microsoft Store a partir do seu back-end.
• Microsoft.StoreServices Sample (GitHub): exemplo de serviço que demonstra padrões de autenticação, integração de comércio e reconciliação de reembolsos.
• Solicitar um User Store ID para autenticação serviço a serviço
• Renovar uma chave de User Store ID
• Gerenciar direitos de produtos a partir de um serviço

​

Diagrama de chamada de uma API da Microsoft Store

​

Configuração extra necessária para exibir e gerenciar produtos com um User Store ID e autenticação do Microsoft Entra ID

​

Configurar seus produtos para ficarem visíveis para o seu serviço por meio do Microsoft Entra ID e de User Store IDs

1. Na página do Partner Center do seu jogo, selecione Product collections and purchases no painel esquerdo.
2. Insira a ID do cliente do aplicativo do Microsoft Entra que você está usando para autenticar seu serviço.
3. Selecione o botão Save.
4. Publique novamente o produto de jogo e todos os complementos do produto na Microsoft Store na sua área restrita ou ambiente de desenvolvedor.

​

Autenticar com X-tokens de autenticação delegada

Authorization: XBL3.0 x=<user hash>;<X-token>

• Game Service Sample: um exemplo abrangente de serviço Web que demonstra a validação e o tratamento de X-tokens do cliente, autenticação servidor a servidor, serviços de comércio e muito mais. Baixe a versão mais recente no site de download do GDK. Baixe a versão mais recente de All Samples. O Game Service Samples está em samples\Live\GameService no arquivo .zip baixado.
• Xfest 2019 - XSTS Auth and Server to Server made Easy: visão geral e explicação dos X-tokens e de como o Game Service Sample pode ajudar a iniciar seu próprio trabalho de autenticação serviço a serviço. Para baixar as informações da apresentação, selecione GDK Track Downloads no site de arquivo.
• Autenticação dos XBOX services e chamadas serviço a serviço: documentação mais detalhada sobre autenticação, X-tokens e as etapas e chamadas necessárias para fazer chamadas serviço a serviço para os XBOX services.

​

Configuração extra necessária para exibir e gerenciar produtos com X-tokens de autenticação delegada

​

Para configurar seus produtos e serviços Web no Partner Center

1. Crie um Business Partner Certificate usando o link Generate Certificate do serviço Web. (Selecione Developer Settings > XBOX Live > Web Services.) Escolha o link na linha do serviço Web ao qual sua terceira parte confiável está vinculada.
2. Acesse a interface de gerenciamento de Business Partner (selecione Developer Settings > XBOX Live > Business Partner) e copie a Business Partner ID que corresponde à do serviço Web usado na etapa 1. (Exemplo de Business Partner ID: 12345678-9012-3456-7890-123456789012)
3. Na página Partner Center Overview dos seus produtos, selecione Create a new e depois selecione Product group.
4. Atribua esse grupo de produtos a um Dev Studio ou selecione Create a new developer studio se você ainda não tiver um.
5. Verifique se a ID do Dev Studio selecionado corresponde à Business Partner ID da etapa 2. Copie a Business Partner ID em Dev Studio ID (optional) se estiver em branco. Se esse campo já tiver um valor em uso, crie um novo Dev Studio em vez de substituí-lo, para evitar interromper os mapeamentos de produtos serviço a serviço existentes.
6. Depois que o Dev Studio estiver configurado com a ID correspondente do Business Partner, retorne ao Product Group que você criou. Adicione seu jogo e todos os produtos à lista Included in this product group.
7. Selecione Save para concluir a criação do grupo de produtos.
8. Acesse a interface XBOX Settings do seu jogo e verifique se o Business Partner vinculado é o mesmo usado na etapa 2.
9. Publique novamente todos os itens do grupo de produtos na Microsoft Store na sua área restrita ou ambiente de desenvolvedor.

​

Confira também