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:- 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-CALLEspecifique a API de cliente como oAPI-GROUP:Client,ServerouAdmin. SubstituaAPI-CALLpor um nome de API, comoConfirmPurchase,LoginWithTwitchouReportPlayer. 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
AllowouDenypara 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.
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.

