Pular para o conteúdo principal
As chaves secretas de desenvolvedor do PlayFab permitem que seu título faça chamadas às APIs Admin e Server do PlayFab. Uma chave secreta, também chamada de chave de desenvolvedor, está associada a um título do PlayFab. Usando a página Secret Keys no Game Manager, você pode criar, excluir, desabilitar e definir a expiração das suas chaves. Isso permite alternar as chaves secretas dos seus títulos (algo que era difícil de fazer no passado). Também permite conceder acesso temporário aos seus títulos.
Nunca inclua sua chave secreta de desenvolvedor em um build de cliente que você envia aos seus clientes. Isso expõe seu título a abusos.
Para gerenciar as chaves secretas do seu título:
  1. Entre no Game Manager.
  2. Selecione seu título.
  3. No canto superior direito, selecione o ícone de engrenagem.
  4. Selecione Title settings e, em seguida, selecione a guia Secret Keys.
A página Secret Keys oferece opções para Delete (excluir) chaves e exibir o Status de cada chave, bem como seu Name, Value e horário de Expiration, se houver. Essa tabela permite auditar as chaves disponíveis. Você pode renomear, habilitar, desabilitar ou definir a expiração de chaves existentes pelo painel. Para ver as opções de uma chave, selecione-a. Cada título começa com uma chave padrão. Para alternar suas chaves:
  1. Selecione New Secret Key.
  2. Insira o Name da chave e uma data de expiração opcional.
  3. Atualize seu código para usar a nova chave.
  4. Desabilite a chave antiga. Selecione a chave antiga e, na página Edit Secret Key, marque a caixa de seleção Disable.
  5. Selecione SAVE SECRET KEY.
Game Manager - Configurações - Editar chave secreta
Se suas chaves antigas forem comprometidas, alterne as chaves para devolver seu título a um estado seguro.
Esse fluxo não tem tempo de inatividade, e você pode reverter cada etapa com segurança até excluir a chave antiga. Se houver problemas na primeira etapa, você pode excluir sua nova chave. Ninguém deve estar usando-a. Na etapa dois, as duas chaves estão ativas, então você pode avançar ou reverter seu código com segurança. Na etapa três, você pode reabilitar a chave enquanto corrige o que ainda dependia dela. Quando o processo estiver concluído, você não precisa excluir a chave antiga. Se você excluir essa chave, ela não poderá ser recuperada. A exclusão é permanente e irrevogável. Definir uma chave para expirar é útil quando você precisa dar a alguém acesso temporário ao seu título. Por exemplo, se você tiver um prestador de serviços trabalhando no seu jogo, poderá fornecer a ele chaves que só dão acesso pelo tempo que você espera que ele precise. Se ele precisar de acesso além da data de expiração originalmente prevista, você poderá redefinir a data de expiração para estender a vida útil da chave secreta.

​
Lista de permissões de IP

As listas de permissões de IP para chaves secretas de título são um recurso de segurança que garante que uma chave secreta de título não possa ser usada de fora dos IPs em que você confia. Cada chave secreta pode ter sua própria lista de endereços IPv4 ou IPv6 (ou intervalos CIDR) autorizados a usá-la. Quando uma lista de permissões de IP é configurada para uma chave secreta de título, chamadas privilegiadas (APIs Server e Admin) feitas com essa chave são aceitas somente de IPs de origem que correspondam a uma entrada da lista. Chamadas de qualquer outro IP são rejeitadas, mesmo que a chave em si seja válida. Toda alteração em uma chave, incluindo edições na lista de permissões, é registrada no evento existente de alteração de chave secreta do PlayStream. Formatos compatíveis:
  • Endereços IPv4 e IPv6 são compatíveis (por exemplo, 203.0.113.7 ou 2001:db8::1).
  • Intervalos CIDR são compatíveis em ambas as famílias (por exemplo, 203.0.113.0/24 ou 2001:db8::/32).
Como configurar uma lista de permissões de IP para a chave secreta do seu título:
  1. No Game Manager, navegue até Title Settings > Secret Keys.
  2. Edite (ou crie) uma chave secreta.
  3. Ative Enable IP allowlist.
  4. Adicione seus IPs de saída ou intervalos CIDR, um por linha (por exemplo, 203.0.113.7 ou 2001:db8::/32).
  5. Selecione Save.
Verifique a lista com atenção antes de salvar. Uma entrada incorreta bloqueia todos os IPs que não estão na lista, o que pode impedir que seus serviços acessem as APIs Server e Admin.

​
Lista de permissões de API

As listas de permissões de API restringem uma chave secreta de título a um conjunto específico de APIs do PlayFab. Solicitações a APIs fora da lista de permissões retornam HTTP 403 (NotAuthorized). Toda alteração em uma chave, incluindo edições na lista de permissões de API, é registrada no evento existente de alteração de chave secreta do PlayStream. Uma chave secreta sem lista de permissões de API permanece irrestrita. As chaves secretas existentes não são afetadas até que você habilite e configure uma lista de permissões de API.
Selecionar todas as APIs cria um instantâneo das APIs disponíveis naquele momento. Isso não é um curinga, e APIs adicionadas posteriormente não são permitidas automaticamente. Para manter uma chave irrestrita para APIs atuais e futuras, não habilite uma lista de permissões de API.
Permitir GetEntityToken pode fornecer um acesso mais amplo do que o esperado. O token de entidade retornado por essa API não é restrito pela lista de permissões de API da chave secreta do título.
Para configurar uma lista de permissões de API:
  1. No Game Manager, acesse Title Settings > Secret Keys.
  2. Edite ou crie uma chave secreta.
  3. Ative Enable API allowlist.
  4. Use Search APIs para localizar e selecionar cada API necessária, como /Server/GetUserData.
  5. Selecione Save e confirme a alteração.
As alterações na lista de permissões de API não são imediatas. Elas entram em vigor à medida que os caches de chaves secretas existentes expiram. Para revogar todo o acesso da chave, desabilite a chave em vez de depender de uma alteração na lista de permissões de API. Para remover uma restrição de API:
  1. Edite a chave secreta.
  2. Desative Enable API allowlist.
  3. Selecione Save e confirme a alteração.
A chave secreta passa então a ser irrestrita para APIs atuais e futuras.
Última modificação em 6 de outubro de 2026

Tópicos relacionados

Instalar o SDK do PlayFab sem as Editor Extensions no UnityDocumentação do gerenciamento de serviços ao vivo do PlayFabImplantar builds usando PowerShell/APIPasso a passo: implantar builds usando PowerShell/APIInício rápido do Unity