Acesso por campo

Um campo pode indicar quais tipos de chamador podem lê-lo e quais podem gravá-lo. Uma nota interna pode ficar restrita à sua equipe, e um valor definido por uma operação pode ficar fora do navegador do usuário.

Listas de leitura e gravação em um campo

Um campo aceita um objeto opcional access com uma lista de leitura e uma lista de gravação. Uma lista de gravação com entradas é uma lista de permissão, e a plataforma rejeita qualquer outro chamador em todos os caminhos de gravação. A lista de leitura governa para quais chamadores a API de cliente expõe o campo. Um campo sem objeto access pode ser gravado por qualquer chamador autenticado.

Cinco tipos de chamador

Toda requisição é de um de cinco tipos, definido pela credencial que ela carrega. Um visitante que não está logado é public. Um usuário logado que grava com o próprio token, na sua chave pública, é self. Uma operação que age com o token emitido para a sua execução é scoped, mesmo quando esse token carrega o usuário que a disparou. Uma chave secreta é service. Uma pessoa da sua equipe, no console ou na CLI, é admin.

Um campo que só uma operação pode tocar

Um usuário que executa uma operação continua sendo esse usuário para propriedade, regras de linha, ator da auditoria e cotas. O que a operação lê e grava conta como scoped e nunca como self. Assim, um campo que lista scoped e deixa self de fora é lido e definido pela operação, e o navegador do usuário não pode fazer nenhuma das duas coisas.

Como uma leitura é avaliada

A API de dados avalia as leituras pelos mesmos cinco tipos. Uma operação lê como scoped, e a requisição do próprio usuário logado como self. Um visitante e uma chave secreta leem ambos como public, e um membro da equipe que visualiza no console lê todos os campos. Uma resposta em cache calculada para um tipo de chamador nunca é entregue a outro.

Leia os detalhes

A referência de modelos mostra o objeto access em um campo, os cinco tipos de chamador e um exemplo prático para uma operação.