Pular para o conteúdo principal
Este tópico é somente para Managed Partners, e não para o Creators Program, devido às restrições impostas à configuração de serviços web. Ele só está disponível para desenvolvedores que receberam a permissão de nível de conta Relying Parties. Se você não tem controle sobre as permissões de nível de conta, entre em contato com seu gerente de conta de desenvolvedor (DAM) para obter ajuda.
Os publicadores podem criar serviços web se quiserem personalizar a forma como seus aplicativos/títulos interagem com os serviços do XBOX. Os serviços web são configurações no nível do publicador e podem ser chamados por qualquer título em uma área restrita de propriedade do publicador, configurando o logon único (SSO). Motivos para definir serviços web:
  1. Oferecer SSO aos usuários do XBOX: para que seu serviço web ofereça SSO aos usuários do XBOX, ele precisa ser configurado como uma terceira parte confiável dos serviços do XBOX. Quando configurado dessa forma, os usuários autenticados nos serviços do XBOX são autenticados automaticamente nos seus serviços, sem precisar inserir outro conjunto de credenciais.
  2. Fazer chamadas de serviço para serviço do seu serviço para os serviços do XBOX: se o seu título for usar um dos seus serviços web para fazer chamadas aos serviços do XBOX, diretamente ou em nome de usuários individuais, você precisará de um Business Partner Certificate.

​
Criando um serviço web

  1. Acesse o painel do Partner Center.
  2. Selecione a seção Apps and Games
  3. No painel de navegação esquerdo, selecione XBOX services > Web services.
  4. Na página Web Services, selecione New Web Service.
  5. Insira o Web Service Name e escolha o tipo de acesso conforme necessário.
    • Telemetry access permite que seu serviço recupere dados de telemetria de qualquer um dos seus jogos.
    • App Channel access dá ao provedor de mídia proprietário do serviço autoridade para publicar programaticamente canais de aplicativos para consumo no console.
  6. Selecione Save.
Neste ponto, você definiu o serviço, e os serviços do XBOX estão cientes da existência dele. Dependendo dos motivos da criação do serviço web, será necessário configurar terceiras partes confiáveis (SSO) ou Business Partner Certificates (chamadas de serviço para serviço).

​
Configurando a NSAL, as definições de token XSTS e as terceiras partes confiáveis no Partner Center

Antes que seu título possa se comunicar com seu serviço web usando tokens XSTS, você precisará definir seu serviço web no Partner Center, criar uma terceira parte confiável e publicar a Network Security Access List (NSAL) do seu título por meio da configuração dos serviços do XBOX na sua área restrita.

​
Definindo seu serviço web, a terceira parte confiável e as declarações do token XSTS

  1. No Partner Center, selecione a seção Apps and games
  2. No menu de navegação esquerdo, selecione XBOX services > Relying parties.
  3. Na página Relying Parties, selecione New Relying Party.
  4. Forneça um Audience URI*.
  5. Selecione o tipo de criptografia que você deseja que seus tokens usem**.
  6. Crie um certificado assimétrico de terceira parte confiável seguindo as instruções da próxima seção. Em seguida, exporte e carregue o arquivo .cer público. Dê ao arquivo .cer um nome relacionado à terceira parte confiável para que seja fácil identificá-lo.
  7. Insira por quanto tempo, em horas, você deseja que o tempo de vida do token dure (recomendamos quatro horas).
  8. Adicione as declarações de token necessárias à definição do token.
  9. Selecione Save.
*O Audience URI precisa estar na forma de um URI de host. No entanto, o nome pode ser diferente do URI do serviço real. Por exemplo, Example.com pode ser o Audience URI da terceira parte confiável, mas o ponto de extremidade do serviço é, na verdade, https://game.example.com/action/.
**Recomendamos usar a opção JWE RFC 7516 para a criptografia assimétrica. A opção herdada JWE Draft 7 existe para compatibilidade com títulos anteriores.

​
Criando um novo certificado de terceira parte confiável

  1. No seu computador, abra o Prompt de Comando do Desenvolvedor para Visual Studio.
  2. Execute o comando a seguir, substituindo o nome de exemplo “Contoso” pelo seu: makecert -sv RP_Private_Key.pvk -n "CN=Contoso Relying Party" RP_Cert.cer -b 01/01/2015 -e 12/31/2199 -sky exchange -ss My -a sha256 -len 2048 -r -pe
  3. Quando solicitado, insira uma senha para a chave privada.
  4. Execute o comando a seguir, substituindo a senha no final pela sua: PVK2PFX -pvk RP_Private_Key.pvk -spc RP_Cert.cer -pfx RP_Full_Cert.pfx -po PasswordForPFX!
  5. Quando solicitado, insira a senha que você definiu para a chave privada na etapa 3.
  6. Use o arquivo RP_Cert.cer para configurar a definição do token no Partner Center.
  7. Copie o arquivo RP_Full_Cert.pfx para o seu servidor e importe-o para o repositório de certificados do computador.
  8. Ao importar o certificado completo, selecione a opção Marcar esta chave como exportável para poder exportá-la para outros servidores, se necessário.
  9. Se você precisar exportar novamente o arquivo .cer da chave pública deste certificado, selecione a opção X.509 codificado na base 64 (.CER) no assistente de Exportação de Certificados.

​
Definindo o ponto de extremidade do seu serviço na NSAL do título

Agora que você definiu a terceira parte confiável e as declarações do token XSTS, precisa definir a URL que seu título chamará na NSAL da configuração dos serviços do XBOX. Isso informa à API GetTokenAndSignature no cliente qual definição de token XSTS ela deve fornecer ao chamar esse host de URL.
  1. Acesse a página de visão geral do seu título no Partner Center.
  2. Selecione XBOX services > Gameplay settings no menu de navegação esquerdo. A página Gameplay Setting é exibida.
  3. Revise a guia, próxima à parte superior da página, da área restrita em que você fará os testes.
  4. Selecione XBOX services > Single sign-on. A página XBOX Live single sign-on configuration é exibida.
  5. Selecione New endpoint.
  6. Insira o endereço de host da URL do serviço que seu título chamará.
  7. Selecione na lista suspensa a Relying Party que você configurou anteriormente.
  8. Selecione Save.
  9. Volte para a página Gameplay Setting.
  10. Selecione a guia da área restrita em que você deseja publicar a NSAL atualizada.
  11. Selecione Publish no canto superior direito.

​
Criando um Business Partner Certificate para chamadas de servidor para servidor (business-to-business (B2B)) aos serviços do XBOX

  1. No Partner Center, selecione a seção Apps and games
  2. No menu de navegação esquerdo, selecione XBOX services > Web services.
  3. Selecione New web service.
  4. Insira um nome para identificar seu serviço web. Esse nome pode ser a URL do host ou qualquer nome que ajude a identificar onde os certificados serão usados e a gerenciá-los.
  5. Selecione Save.
  6. Na página Web services, agora você verá seu novo serviço web listado.
  7. Selecione Generate Certificate para o novo serviço web.
  8. Selecione o link Show Options para ver um script do PowerShell que cria a chave necessária. Você pode executar esse script em qualquer computador e, em seguida, exportar o certificado para outros computadores.
  9. Na janela do console, remova as quebras de linha automáticas e copie a chave de cadeia de caracteres resultante para a caixa de texto em Download the CSP Certificate.
  10. Selecione Download.
  11. Siga as instruções em Binding the Certificate.
  12. Verifique se, depois de importado, o certificado tem a chave privada associada a ele (indicado pelo pequeno ícone de chave no canto superior esquerdo).
Especificar uma cadeia de certificados SSL para a conexão com o ponto de extremidade só é necessário ao usar um certificado autoassinado. Os certificados SSL públicos emitidos por autoridades de certificação conhecidas são válidos sem configuração.
Os certificados autoassinados só podem ser usados em cenários de desenvolvimento e são proibidos em serviços de produção.

​
Configurando um Business Partner Certificate

Se o seu título for usar um dos seus serviços web para fazer chamadas aos serviços do XBOX, diretamente ou em nome de usuários individuais, você precisará de um Business Partner Certificate.

​
Gerando um Business Partner Certificate

Use as etapas a seguir depois de criar um serviço web com sucesso.
  1. Na página Web Services, encontre o serviço web ao qual deseja associar um Business Partner Certificate.
  2. Selecione o link Generate Certificate do serviço web escolhido.
  3. Selecione Show Options ao lado de Generating a New Certificate. Isso exibe os comandos que devem ser executados no PowerShell com privilégios de Administrador.
  4. Executar todos os comandos, um após o outro, deve gerar com sucesso um blob codificado em Base64. Essa é a chave pública. Copie a chave pública do PowerShell e cole-a no espaço reservado para o blob do provedor de serviços de configuração (CSP).
  5. Selecione Download e siga as instruções da página para Binding the certificates.
    1. Use o mesmo computador que você usou para gerar a chave pública.
    2. Execute este comando no PowerShell: mmc.exe
    3. Selecione Arquivo e, em seguida, Adicionar/Remover Snap-in.
    4. Selecione Certificados e, em seguida, Adicionar. Selecione Conta de computador para o snap-in de certificados. Selecione Concluir e, em seguida, OK.
    5. Abra o repositório Pessoal\Certificados.
    6. Clique com o botão direito do mouse em Certificados e selecione Todas as Tarefas. Selecione Importar.
    7. Selecione o certificado que você baixou do Partner Center.
    8. Clique com o botão direito do mouse no certificado na interface depois que ele for importado. Selecione Todas as Tarefas e, em seguida, Exportar.
    9. Siga o assistente de Exportação. Selecione a opção para exportar a chave privada com o certificado.
    10. Conclua o assistente de Exportação.
Última modificação em 8 de outubro de 2026