Esta página ainda não foi traduzida: mostrando a versão em inglês.
Controle de acesso
Cada Entity diz quem pode lê-la e quem pode gravá-la, e cada Function diz quem pode executá-la. O acesso é definido por chamador: o cliente do seu jogo, os seus servidores e as suas cloud functions. Em uma Entity com posse pelo Player, a posse ainda restringe o cliente aos próprios Records. O acesso das Entities é definido em Schema, no editor da Entity; o das Functions, no manifest da Function.
Quem está chamando
| Chamador | Quem é |
|---|---|
| Client | O seu jogo, conectado com uma client key (pk_…), como um Player anônimo ou com login feito. |
| Server | Os seus próprios servidores e ferramentas, com uma server key (sk_…). |
| Backend | As suas cloud functions, chamando de volta a plataforma com identidade própria. |
O próprio Backoffice não está sujeito a essas configurações.
Read e Write
Cada Entity tem uma chave Read e uma chave Write para cada chamador. Write cobre todas as mudanças: criar, atualizar e excluir Records. Não existe uma permissão separada de exclusão.
| Chamador | Read | Write |
|---|---|---|
| Client | Desligado | Desligado |
| Server | Ligado | Ligado |
| Backend | Ligado | Ligado |
Esses são os padrões de uma Entity nova: fechada para o cliente e aberta para os seus servidores e Functions. Um cliente não consegue ler nem gravar uma Entity nova até você permitir.
O acesso é decidido sempre na mesma ordem: primeiro, se o chamador pode ler ou gravar a Entity; depois, para um cliente em uma Entity com posse pelo Player, em quais Records ele pode mexer.
Definir o acesso no Backoffice
Abra o editor da Entity
Em Schema, selecione a Entity e clique no lápis ao lado do nome dela. Para uma Entity nova, as mesmas configurações estão em New ▾ → Entity.
Defina Read e Write
Em Access control, marque Read e Write para cada chamador.
Prepare e aplique
Clique em Apply changes para preparar a edição e depois revise e aplique a migração. As mudanças de acesso entram em vigor com a migração.
Client Write em uma Entity compartilhada deixa qualquer Player mudar qualquer Record
Em uma Entity sem posse pelo Player, o Write do cliente não é restrito a nada: todo Player pode alterar ou excluir todos os Records. Permita isso só para dados que devem ser compartilhados e use uma Entity com posse pelo Player para os dados de cada Player.
Definir o acesso pelo código
Uma Entity definida no seu projeto Unity define o acesso no atributo [PlayServSchema], e a ferramenta de Schema do SDK publica esse acesso junto com o Schema. Cada chave é Default, Allow ou Deny:
using Playserv.Schema;
[PlayServSchema("Pilots",
OwnedBy = PlayServSchemaOwner.Player,
Read = PlayServSchemaReadPolicy.Owner,
OnPlayerDelete = PlayServPlayerDeletePolicy.Anonymise,
ClientRead = PlayServSchemaAccess.Allow,
ClientWrite = PlayServSchemaAccess.Allow)]
public class Pilots
{
public string Callsign;
public int Level;
}
ServerRead, ServerWrite, BackendRead e BackendWrite definem os outros chamadores da mesma forma. O acesso definido pelo código e o definido no Backoffice são guardados e aplicados do mesmo jeito. Uma Entity publicada a partir do código fica somente leitura no Backoffice, acesso incluído: mude-o no código.
Entities com posse pelo Player
Em uma Entity com posse pelo Player, Read e Write continuam decidindo se um cliente pode mexer nela; a posse decide em quais Records.
| Um cliente… | Read access Owner | Read access Public |
|---|---|---|
| Lê | Só os próprios Records. Sem um Player com login feito, a leitura é recusada. | Todos os Records. |
| Cria | Um Record cujo dono é o Player dele. Sem um Player com login feito, a criação é recusada. | O mesmo. |
| Atualiza ou exclui | Só os próprios Records. | Só os próprios Records. |
As chamadas de server e backend não são restritas: elas leem, atualizam e excluem qualquer Record. Para criar um Record em uma Entity com posse pelo Player, elas agem em nome de um Player, que se torna o dono dele.
Um Record de outro Player é invisível para o cliente, e não proibido: ler, atualizar ou excluir esse Record responde 404, exatamente como um Record que não existe. O código do cliente não consegue distinguir os dois casos, e isso é intencional.
Verificações no cliente do jogo
Quem decide é sempre a plataforma. O SDK para Unity também verifica o acesso antes de enviar uma requisição: quando sabe que a Entity está fechada para o cliente, atualiza uma vez a sua cópia das configurações de acesso e, se a Entity continuar fechada, faz a chamada falhar localmente com um erro de acesso negado em vez de enviá-la.
Execute das Functions
Cada Function diz quais chamadores podem executá-la, na configuração execute do seu manifest: client, server e backend, cada um true ou false, todos permitidos por padrão. Um chamador sem Execute é recusado com 403.
O Execute é independente da configuração auth da Function, que decide se uma chamada do cliente precisa de um Player com login feito (player, o padrão) ou não (none). A aba Settings da Function no Backoffice mostra a configuração auth; as configurações de Execute existem só no manifest.
Quando uma chamada é recusada
| Resposta | Quando | O que verificar |
|---|---|---|
403 table_read_forbidden | O chamador não pode ler a Entity. | A chave Read da Entity para esse chamador. |
403 table_write_forbidden | O chamador não pode gravar na Entity. | A chave Write da Entity para esse chamador. |
403 owner_read_requires_player | Um cliente sem Player com login feito lê uma Entity cujo Read access é Owner. | Faça o login do Player antes. |
422 acting_player_required | Um Record é criado em uma Entity com posse pelo Player sem um Player para ser o dono. | Faça o login do Player ou crie o Record em nome de um Player. |
404 | Um cliente mexe no Record de outro Player ou em um Record que não existe. | Se o Record pertence ao Player com login feito. |
403 function_execute_forbidden | O chamador não pode executar a Function. | A configuração execute da Function. |
401 player_auth_required | Um cliente chama uma Function que exige um Player, sem nenhum Player com login feito. | A configuração auth da Function, ou faça o login do Player. |
403 player_read_forbidden | Um cliente lê a conta de um Player que não é a dele, ou não tem Player com login feito. | Leia só a conta do Player com login feito. |
A maioria das recusas se resume a duas configurações
Se uma gravação do cliente for recusada, confira primeiro a chave Write do cliente na Entity; depois, se a Entity tem posse pelo Player e se o Record pertence ao Player com login feito.
Próximos passos
- Schema Object Reference — todas as configurações da Entity, posse incluída
- Construir o Schema do jogo — aplique as mudanças de acesso com uma migração
- Escrita de Records — as gravações que essas regras decidem
Atualizado em 16 de out. de 2026