Pular para o conteúdo principal
Data e Schema

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

ChamadorQuem é
ClientO seu jogo, conectado com uma client key (pk_…), como um Player anônimo ou com login feito.
ServerOs seus próprios servidores e ferramentas, com uma server key (sk_…).
BackendAs 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.

ChamadorReadWrite
ClientDesligadoDesligado
ServerLigadoLigado
BackendLigadoLigado

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.

Chamada + credencial→ sujeitoautoridadeChave Read / Writenão → 403 forbiddenescopoCliente em tabela com donosó as próprias linhasLinha alheia404 — invisível

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 OwnerRead access Public
LêSó os próprios Records. Sem um Player com login feito, a leitura é recusada.Todos os Records.
CriaUm Record cujo dono é o Player dele. Sem um Player com login feito, a criação é recusada.O mesmo.
Atualiza ou excluiSó 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

RespostaQuandoO que verificar
403 table_read_forbiddenO chamador não pode ler a Entity.A chave Read da Entity para esse chamador.
403 table_write_forbiddenO chamador não pode gravar na Entity.A chave Write da Entity para esse chamador.
403 owner_read_requires_playerUm cliente sem Player com login feito lê uma Entity cujo Read access é Owner.Faça o login do Player antes.
422 acting_player_requiredUm 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.
404Um 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_forbiddenO chamador não pode executar a Function.A configuração execute da Function.
401 player_auth_requiredUm 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_forbiddenUm 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

Atualizado em 16 de out. de 2026