К основному содержанию
скилл CX Codex

zenstack-access-control — скилл для Claude Code: правила доступа

Скилл zenstack-access-control для Claude Code помогает задавать правила доступа в схеме ZenStack V3. Подключается при работе с @@allow, @@deny, auth() и проверками после обновления.

MIT 556 установок ★ 3 обновлён 2026-10-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add zenstackhq/skills --skill zenstack-access-control -a claude-code
Открыть на GitHub

Что делает zenstack-access-control

Скилл помогает описывать и проверять политики доступа в схемах ZenStack V3. Он охватывает правила для моделей и полей, привязку текущего пользователя через $setAuth() и настройку плагина политик.

Чтобы политики применялись во время запросов, добавьте @zenstackhq/plugin-policy в схему и установите пакет командой npm install @zenstackhq/plugin-policy. После правок запустите zen generate; команда также проверяет схему. Для одной проверки без генерации используйте zen check.

Политики не охватывают каскадные операции и триггеры базы данных; сырой SQL и query builder обходят их. Для разрешения сырого SQL с плагином нужна настройка dangerouslyAllowRawSql: true в версии v3.5.0+.

Какие задачи решает

  • задать доступ к записям через @@allow и @@deny
  • привязать текущего пользователя к клиенту через $setAuth()
  • ограничить чтение или изменение отдельных полей
  • описать условия, которые должны выполняться после обновления

Примеры запросов агенту

  • Добавь правила @@allow и @@deny для моделей в схеме ZenStack V3.
  • Настрой auth() и привяжи пользователя через $setAuth().
  • Ограничь чтение поля для анонимных пользователей и добавь правило post-update.

Как установить zenstack-access-control

1Через Skills CLI (Vercel)

npx skills add zenstackhq/skills --skill zenstack-access-control -a claude-code

2Вручную: положить файлы

~/.claude/skills/zenstack-access-control/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/zenstack-access-control/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о zenstack-access-control

Как установить zenstack-access-control в Claude Code?

Выполните npx skills add zenstackhq/skills --skill zenstack-access-control -a claude-code. Файл скилла находится по пути ~/.claude/skills/zenstack-access-control/SKILL.md.

Что делает zenstack-access-control?

Помогает описывать политики доступа ZenStack V3 для моделей и полей, связывать их с auth() и настраивать применение политик через runtime-плагин.

Что нужно для работы zenstack-access-control?

Нужны схема ZenStack V3 и пакет @zenstackhq/plugin-policy: его требуется объявить в схеме и установить командой npm install @zenstackhq/plugin-policy. После изменений политик клиент можно обновить командой zen generate.

Исходный текст

SKILL.md · MIT
---
name: zenstack-access-control
description: Add access control to a ZenStack V3 schema. Use when writing access policies (@@allow / @@deny), the auth() function, field-level rules, post-update rules, or setting up the policy plugin and $setAuth runtime. (For data validation — @email/@length/@@validate — see zenstack-querying.)
---

# ZenStack V3 — Access Control

ZenStack enforces access policies declared in ZModel at the ORM layer. Policies live next to your
models (see `zenstack-schema-modeling`); enforcement is opt-in via a runtime plugin. For client/query
basics — and for **data validation** — see `zenstack-querying`.

After editing policies, run `zen generate` to regenerate the client (it also validates the schema,
policy expressions included). If you only want to validate without regenerating, run `zen check`.

## Runtime setup (required for policies to apply)

Policies do nothing until you (1) declare the plugin in the schema and (2) install it on the client.

**Schema:**

```zmodel
plugin policy {
    provider = '@zenstackhq/plugin-policy'
}
```

Install the package: `npm install @zenstackhq/plugin-policy`.

**Client:**

```ts
import { ZenStackClient } from '@zenstackhq/orm';
import { PolicyPlugin } from '@zenstackhq/plugin-policy';

const db = new ZenStackClient(schema, { dialect });   // raw, unprotected
export const authDb = db.$use(new PolicyPlugin());     // access control enforced
```

`ZenStackClient` instances are **immutable** — `$use()` and `$setAuth()` return new (cheap, shallow-
clone) instances and never mutate the original. Query with `db` to bypass policies (e.g. trusted
server code) and with the policy-enforced client for user-facing access.

## The current user — `auth()` and `$setAuth()`

Bind the authenticated user per request; `auth()` in policies resolves to it.

```ts
const userDb = authDb.$setAuth(user);   // user-bound client
await userDb.post.findMany();           // policies evaluated against `user`
```

- No `$setAuth()` → anonymous mode → `auth()` is `null`. `$setAuth(undefined)` forces anonymous.
- Read the bound user back via `client.$auth`.

**Define what `auth()` returns**, by priority: a `model`/`type` annotated `@@auth`, otherwise a
model literally named `User`, otherwise a compile error. Using a `type` decouples the auth shape
from your tables:

```zmodel
type Auth {
    id   Int
    role String
    @@auth
}
```

## Policy rules — `@@allow` / `@@deny`

```
@@allow(operation, condition)
@@deny(operation, condition)
```

**Operations** (comma-separate to combine): `create`, `read`, `update`, `delete`, `post-update`,
and `all` (= create+read+update+delete, **not** post-update).

**Evaluation** (secure by default): any matching `@@deny` → denied; else any matching `@@allow` →
allowed; else denied. `read`/`update`/`delete` silently *filter out* rows that fail, rather than
erroring; `create` is checked before insert.

```zmodel
model User {
    id    Int    @id @default(autoincrement())
    email String @unique
    posts Post[]

    @@allow('create,read', true)        // anyone can sign up; profiles public
    @@allow('all', auth().id == id)     // the user has full access to themselves
}

model Post {
    id        Int     @id @default(autoincrement())
    title     String
    published Boolean @default(false)
    author    User    @relation(fields: [authorId], references: [id])
    authorId  Int

    @@deny('all', auth() == null)       // no anonymous access
    @@allow('read', published)          // published posts readable by anyone
    @@allow('all', auth().id == authorId) // author has full access
}
```

## Policy expressions

- Operators: `==` `!=` `>` `>=` `<` `<=`, `&&` `||` `!`, and field references.
- **To-one relations**: dot access — `auth().city == profile.address.city`.
- **To-many relations**: collection predicates
  - `relation?[cond]` — **some** match
  - `relation![cond]` — **all** match
  - `relation^[cond]` — **none** match

  ```zmodel
  @@deny('delete', posts?[published == true])   // can't delete a user with published posts
  ```
- Use `this` to escape the collection scope: `comments?[author.verified && this.published]`.
- **`create` rules** can only reference *owned* relations (those whose FK the model holds) — other
  relations don't exist yet at creation time.
- **`check(relation [, op])`** delegates the check to a to-one relation's policies, avoiding
  duplication: `@@allow('read', check(user))` / `@@allow('update', check(user, 'update'))`.
- Helper functions usable in expressions: `contains`, `startsWith`, `endsWith` (each takes an
  optional case-insensitive flag), `has`, `hasSome`, `hasEvery`, `isEmpty`, `currentModel()`,
  `currentOperation()`.

## Field-level policies (v3.2.0+, preview)

Single-`@` `@allow` / `@deny` on a field, operations `read` and `update` only.

```zmodel
model User {
    id    Int    @id
    email String @allow('update', auth() == this)  // only the owner can change it
    name  String @deny('read', auth() == null)     // hidden from anonymous readers
}
```

- Failing a **read** policy *nullifies* the field (returned as `null`, still usable in SQL
  computations) — you can't distinguish a real `null` from a denied one.
- Failing an **update** policy rejects the whole update (`ORMError`, reason `REJECTED_BY_POLICY`).

## Post-update rules

`post-update` expresses conditions that must hold *after* an update; field references see the
**new** values, and `before()` reads the **old** values. (This replaces V2's `future()`.)

```zmodel
model Post {
    published Boolean @default(false)
    authorId  Int

    @@deny('post-update', published == true && auth().id != authorId)  // only author can publish
    @@deny('post-update', before().authorId != authorId)               // authorId is immutable
}
```

If a model has no `post-update` rule, an update only needs to pass `update`. If it has any, at least
one `@@allow('post-update', ...)` must pass.

## Execution order & error reasons

Per mutation, policies are checked **before** the database is touched (after any input validation —
see `zenstack-querying`). Policy-related `ORMError.reason` values: `REJECTED_BY_POLICY` (policy) and
`NOT_FOUND` (missing or filtered out by a read policy). `REJECTED_BY_POLICY` further carries
`rejectedByPolicyReason`: `NO_ACCESS`, `CANNOT_READ_BACK` (mutation allowed but result not readable
back), or `OTHER`.

## Limitations

- Database-level cascade deletes/updates and triggers are **not** policed by ZenStack.
- Raw SQL (`$queryRaw`/`$executeRaw`) and query-builder access bypass policies. Allow raw SQL while
  the policy plugin is installed only via `new PolicyPlugin({ dangerouslyAllowRawSql: true })`
  (v3.5.0+).

## Reference docs

Full ZenStack documentation for this topic is bundled under [`references/`](references/):

- [access-control-overview.md](references/access-control-overview.md) — how access control works
- [write-policies.md](references/write-policies.md) — `@@allow`/`@@deny`, `auth()`, expressions
- [enforcing-policies.md](references/enforcing-policies.md) — policy plugin + `$setAuth` runtime
- [post-update.md](references/post-update.md) — `post-update` rules and `before()`
- [field-level.md](references/field-level.md) — field-level read/update policies
- [zmodel-expression-reference.md](references/zmodel-expression-reference.md) — policy expression reference
- [policy-plugin-reference.md](references/policy-plugin-reference.md) — policy plugin options

© zenstackhq · MIT · zenstackhq/skills

Похожие скиллы

Каталог скиллов SKILL.md →
tigris-security-access-control tigrisdata Скилл tigris-security-access-control настраивает доступ к объектному хранилищу Tigris: ключи, роли, CORS и подписанные URL. Нужен при защите бакетов и проверке настроек доступа. CX Codex +1 3 900установок netlify-access-control netlify Скилл netlify-access-control для Claude Code разбирает уровни защиты Netlify: пароль, приватный проект или SAML SSO. Помогает выбрать защиту для сайта и Deploy Preview. CX Codex +1 2 600установок access-control-rbac aj-geddes Скилл access-control-rbac, который помогает агенту проектировать ролевую модель доступа: роли, разрешения, политики и принцип наименьших привилегий. CX Codex +1 769установок testing-for-broken-access-control mahipal Скилл testing-for-broken-access-control помогает проверять веб-приложения и API на ошибки контроля доступа по OWASP A01:2021. Пригодится при аудите RBAC и анализе изоляции данных. CX Codex +1 595установок infisical-access-control Infisical Скилл infisical-access-control для Claude Code помогает разбираться в управлении доступом Infisical: ролях, правах на секреты, временном доступе, согласованиях и аудит-логах. CX Codex +1 267установок asset-access-control imagekit-developer Скилл asset-access-control для Claude Code управляет доступом к файлам, папкам и медиаколлекциям ImageKit через DAM MCP. Он подключается, когда нужно узнать, кто видит объект, выдать права или изменить ACL. CX Codex +1 114установок

Из того же набора9

zenstack-db-migration Скилл zenstack-db-migration для Claude Code управляет миграциями схемы базы данных в ZenStack V3. Вызывается при создании и применении миграций, синхронизации схемы или работе с существующей базой. CX Codex +1 551установок zenstack-crud-server Скилл zenstack-crud-server для Claude Code превращает модели ZenStack V3 в REST- или RPC CRUD API. Подключается при создании серверных маршрутов, настройке доступа к данным или вызове API из клиента. CX Codex +1 548установок zenstack-plugin-dev Скилл zenstack-plugin-dev для Claude Code помогает создавать плагины ZenStack V3. Включается при работе с ZModel, генерацией кода через CLI или расширением ORM-клиента. CX Codex +1 521установок zenstack-migrate-from-prisma Скилл zenstack-migrate-from-prisma для Claude Code переносит проект с Prisma на ZenStack V3. Он помогает заменить схему, клиент и команды миграции, сохранив рабочие вызовы ORM. CX Codex +1 520установок zenstack-migrate-from-v2 Скилл zenstack-migrate-from-v2 для Claude Code переводит проект ZenStack с V2 на V3. Помогает обновить схему, политики доступа, серверные адаптеры и клиентские хуки. CX Codex +1 515установок zenstack-project-setup Скилл zenstack-project-setup для Claude Code настраивает проекты ZenStack V3: устанавливает зависимости, создаёт каркас и запускает команды zen. Активируется при установке ZenStack, создании проекта или работе с CLI. CX Codex +1 510установок zenstack-querying Скилл zenstack-querying для Claude Code помогает работать с данными через клиент ZenStack V3. Он включается при создании запросов, изменении записей и настройке выборок со связями. CX Codex +1 494установок zenstack-schema-modeling Скилл zenstack-schema-modeling для Claude Code помогает создавать и менять схемы данных ZModel для ZenStack V3. Запускается при работе с моделями, полями, связями, перечислениями и типизированными JSON-полями. CX Codex +1 470установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой