Pular para o conteúdo principal
Com esse novo recurso, os desenvolvedores de jogos podem carregar, listar, atualizar e usar com segurança segredos, como chaves de instrumentação e chaves secretas, em servidores de jogo.

Como usar o recurso de gerenciamento de segredos

Para gerenciar e utilizar os segredos de forma eficaz, o fluxo de trabalho recomendado inclui:
  1. Adicionar segredos (esta etapa pode ser repetida para vários segredos)
  2. Referenciar os segredos pelo nome ao criar um novo build
  3. Acessar os segredos a partir do seu servidor de jogo
  4. Atualizar os segredos conforme necessário

Adicionando segredos

Os segredos podem ser adicionados por meio da API UploadSecret. Essa API permite carregar um novo segredo no serviço ou atualizar um segredo existente com o parâmetro ForceUpdate definido como true.

Implantando segredos

Para implantar segredos em VMs recém-criadas, incorpore o segredo a um build usando o parâmetro GameSecretReferences nas APIs CreateBuild (aplicável tanto a implantações baseadas em contêiner quanto em processo).
Depois que um build é criado, não é possível adicionar novos segredos a ele; no entanto, atualizar um segredo existente permitirá que o valor atualizado seja usado em novas VMs (as VMs existentes manterão os valores originais).
Veja um exemplo de como referenciar os segredos:

Acessando segredos

Depois que os segredos forem adicionados e referenciados em novos builds, os servidores de jogo poderão acessar esses valores secretos por meio de variáveis de ambiente em cada servidor de jogo, seja baseado em contêiner ou em processo. A convenção de nomenclatura das variáveis de ambiente é:

Excluindo segredos

Para remover um segredo antigo, utilize a API DeleteSecret. Verifique se o segredo não é usado em nenhum build antes de tentar excluí-lo; caso contrário, a exclusão não terá êxito.

Usar segredos em scripts de inicialização de VM

Os scripts de inicialização de VM podem utilizar os valores secretos referenciando as variáveis de ambiente conforme descrito. Isso permite, por exemplo, o uso de chaves de telemetria ou de outros valores necessários antes de iniciar qualquer servidor de jogo.

Confira também

Última modificação em 8 de outubro de 2026