Acesso em nível de registro

Cada modelo declara quem é dono de seus registros, e cada registro é privado ou público. Compartilhar um registro privado com uma pessoa indicada é uma concessão, que você pode revogar.

Quem é dono de um registro

Os registros de um modelo pertencem ao projeto, ao usuário logado que os criou, ao membro da equipe que os criou ou a uma organização. A propriedade do projeto é o padrão e significa que não há dono individual. Você declara o dono nas configurações de acesso do modelo.

Privado ou público

Um registro privado pode ser lido pelo seu dono e por quem tiver uma concessão. Um registro público pode ser lido por qualquer pessoa, inclusive por uma requisição que carrega apenas uma chave pública. Privado é o padrão, exceto em um modelo pertencente ao projeto criado sem essa configuração, que começa público.

Um registro pode ser configurado de qualquer uma das duas formas na aba Acesso do editor de registros. Ele mantém essa configuração quando o padrão do modelo muda depois, e os registros que seguem o padrão mudam junto quando a alteração é publicada.

Compartilhando com uma pessoa indicada

Uma concessão indica uma pessoa, um registro e um nível: leitura, escrita ou exclusão. O registro continua privado, e a concessão pode ser revogada. A API gera chamadas de concessão e revogação para cada modelo pertencente a um usuário ou a um membro da equipe, e o SDK as expõe como grantAccess e revokeAccess. Apenas quem pode editar um registro pode alterar suas concessões.

O que um usuário logado lê

Uma consulta em um modelo pertencente a um usuário não aceita filtro. Com o token do usuário, ela retorna os registros desse usuário e os que foram concedidos a ele. Uma chave secreta é a visão de back-office e, com o escopo certo, lê os registros de todos os donos.

Registros que um chamador não pode ver

Um registro que o chamador não pode ver volta como null, a mesma resposta de um registro que não existe. As regras são impostas no banco de dados com row-level security. Os arquivos têm regras de acesso próprias e não assumem a visibilidade de um registro que aponta para eles.

Leia os detalhes

O guia de autorização cobre donos, visibilidade, concessões e leituras que seguem uma referência entre registros.