Pular para o conteúdo principal
A Política de Acesso à API controla o acesso aos recursos da API. Às vezes, é necessário que um título permita ou negue determinadas APIs do cliente do jogo, para fins de antitrapaça ou outros fins de segurança. Você pode controlar o acesso usando Declarações de Política para especificar um conjunto de regras de acesso que são aplicadas em situações específicas. Este tópico discute o uso de políticas de permissão de API para criar as regras apropriadas. Você também pode gerenciar a política de acesso à API do seu título diretamente no Game Manager. Para obter mais informações, confira Política de Acesso à API no Game Manager.
Este guia discute técnicas avançadas. Se aplicado incorretamente, é possível desabilitar completamente o acesso do cliente ao seu título usando este recurso.

Controle e estrutura da política

Os títulos usam as chamadas da API Admin do PlayFab para recuperar e atualizar as políticas de acesso. As duas chamadas específicas que você usa para definir a política de acesso à API são GetPolicy e UpdatePolicy. Para obter mais informações sobre as chamadas da API Admin, confira Referência da API do PlayFab. Para usar a API Admin, você deve fornecer a chave secreta do desenvolvedor associada ao seu título. A chave do desenvolvedor é usada para autorizar seu título a fazer chamadas da API Admin. Para obter informações sobre como recuperar sua chave secreta, confira Gerenciamento de chaves secretas. Cada política contém uma lista de declarações, que funcionam como regras para um ou mais recursos do PlayFab. O PlayFab define um conjunto padrão de declarações de política que permite todas as políticas. Se você excluir esse conjunto de declarações de política sem substituí-lo, seu título não poderá chamar as APIs de cliente. As declarações de política padrão do PlayFab:
Cada conjunto de Declarações de Permissão consiste nos seguintes itens, conforme definido em Authentication - Update Policy:
  • Resource - Uma cadeia de caracteres que identifica exclusivamente um ou mais recursos do PlayFab. Para descrever o recurso da API, use a convenção mostrada abaixo. pfrn:api--/API-GROUP/API-CALL Especifique a API de cliente como o API-GROUP: Client, Server ou Admin. Substitua API-CALL por um nome de API, como ConfirmPurchase, LoginWithTwitch ou ReportPlayer. Uma cadeia de caracteres de recurso dá suporte a curingas. A cadeia de caracteres de recurso a seguir corresponde a qualquer recurso. pfrn:api--*
  • Action - Uma cadeia de caracteres que descreve uma operação a ser executada no recurso. Use * para corresponder a qualquer operação.
  • Effect - Uma cadeia de caracteres que especifica uma definição de regra. Use Allow ou Deny para permitir ou negar operações sobre o recurso.
  • Principal - Uma cadeia de caracteres que identifica exclusivamente a classe do usuário. Use * para corresponder a qualquer usuário.
  • Comment - Uma cadeia de caracteres definida pelo usuário que fornece mais informações sobre a declaração de política.
  • ApiConditions - Um objeto opcional que define condições de regra avançadas, por exemplo, Criptografia e Cabeçalhos Assinados.
Você pode definir regras de segurança fortes para seu aplicativo modificando sua política para usar declarações de permissão mais detalhadas que permitem acesso somente pelas APIs que você usa no seu aplicativo. O exemplo a seguir mostra como restringir a chamada DeleteCharacterFromUser:

Exemplo de política de acesso à API

O exemplo de código a seguir mostra operações básicas com políticas. O código executa as seguintes ações:
  • Recupera e registra a Policy existente.
  • Atualiza a política.
  • Recupera e registra a Policy existente novamente.
A imagem abaixo mostra um exemplo da saída após o código ser executado pela primeira vez. Conforme mostrado, a política consiste em várias Declarações de Permissão. Game Manager - API Admin - Política Get-Update - Saída em C#
Última modificação em 6 de outubro de 2026