필드 수준 액세스
필드는 어떤 종류의 호출자가 읽고 쓸 수 있는지 지정할 수 있습니다. 내부 노트는 팀에만 공개하고, 오퍼레이션이 설정하는 값은 사용자의 브라우저에 노출되지 않게 할 수 있습니다.
필드의 읽기 및 쓰기 목록
필드는 선택 사항인 access 객체를 가질 수 있으며, 읽기 목록과 쓰기 목록이 들어 있습니다. 항목이 있는 쓰기 목록은 허용 목록이며, 플랫폼은 모든 쓰기 경로에서 그 외의 호출자를 거부합니다. 읽기 목록은 클라이언트 API가 필드를 어떤 호출자에게 노출할지 결정합니다. access 객체가 없는 필드는 인증된 모든 호출자가 쓸 수 있습니다.
다섯 가지 호출자
모든 요청은 자격 증명에 따라 결정되는 다섯 가지 중 하나입니다. 로그인하지 않은 방문자는 public입니다. 공개 키로 자신의 토큰을 사용해 쓰는 로그인한 사용자는 self입니다. 오퍼레이션이 실행에 발급된 토큰으로 동작하면, 그 토큰에 실행을 트리거한 사용자가 담겨 있어도 scoped입니다. 시크릿 키는 service입니다. 콘솔이나 CLI에서 활동하는 팀원은 admin입니다.
오퍼레이션만 접근할 수 있는 필드
오퍼레이션을 실행하는 사용자는 소유권, 행 규칙, 감사 행위자, 할당량에서 여전히 그 사용자입니다. 오퍼레이션이 읽고 쓰는 것은 scoped로 취급되고, 결코 self로는 취급되지 않습니다. 그래서 scoped를 나열하고 self를 빼 둔 필드는 오퍼레이션이 읽고 설정하며, 사용자의 브라우저는 둘 다 할 수 없습니다.
읽기 판정 방식
데이터 API는 읽기도 같은 다섯 가지 종류로 판정합니다. 오퍼레이션은 scoped로, 로그인한 사용자 본인의 요청은 self로 읽습니다. 방문자와 시크릿 키는 둘 다 public으로 읽고, 콘솔에서 미리 보는 팀원은 모든 필드를 읽습니다. 한 종류의 호출자를 위해 계산된 캐시된 응답은 다른 종류의 호출자에게 제공되지 않습니다.
자세히 보기
모델 레퍼런스는 필드의 access 객체, 다섯 가지 호출자 종류, 오퍼레이션 예제를 보여 줍니다.