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

api-platform-security — скилл для Claude Code: установка и суть

Скилл api-platform-security настраивает правила доступа в Symfony API Platform через выражения security, воутеры и хуки жизненного цикла операций.

MIT ★ 234 обновлён 2026-10-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dev-toolings/superpowers-symfony --skill api-platform-security -a claude-code
Открыть на GitHub

Что делает api-platform-security

Скилл помогает ограничить доступ к операциям сущностей API Platform. Он выстраивает проверку прав на уровне отдельных ресурсов: связывает вызовы is_granted() с контекстом текущего пользователя и объекта, а сложные условия выносит в отдельные воутеры Symfony.

В работу включена цепочка проверок жизненного цикла запроса. Для проверки входящих данных применяются securityPostDenormalize и securityPostValidation, а видимость строк в коллекциях ограничивается через QueryCollectionExtensionInterface или стейт-провайдеры, а не через простые выражения security.

Хелпер access_decision() в Twig и метод getAccessDecision() требуют Symfony 8.1 или новее: на старых версиях фреймворка этот код вызовет сбой. Секретные поля вроде паролей по правилам скилла закрываются атрибутом #[Ignore].

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

  • Разграничить права на вызов операций API Platform для ролей и владельцев сущностей
  • Фильтровать строки в коллекциях через расширения Doctrine без блокировки всего эндпоинта
  • Скрыть конфиденциальные поля ресурса с помощью групп сериализации
  • Сгенерировать тесты разрешённого, запрещённого и анонимного доступа к API

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

  • Ограничь операцию PATCH ресурса Order так, чтобы её мог вызвать только владелец заказа
  • Настрой QueryCollectionExtensionInterface для сущности Invoice, чтобы менеджер видел только свои счета
  • Перенеси сложную логику проверки прав из аннотаций ресурса в отдельный Symfony Voter

Как установить api-platform-security

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill api-platform-security -a claude-code

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

~/.claude/skills/api-platform-security/SKILL.md

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

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

Вопросы об api-platform-security

Как установить api-platform-security в Claude Code?

Выполните команду npx skills add dev-toolings/superpowers-symfony --skill api-platform-security -a claude-code в терминале проекта.

Что делает скилл api-platform-security?

Он задаёт шаблоны и правила защиты ресурсов API Platform: настраивает воутеры, разграничивает операции и фильтрует выдачу коллекций.

Почему нельзя фильтровать коллекции через security-выражения?

Выражение security проверяет доступ ко всей коллекции разом. Чтобы скрыть отдельные строки для разных ролей, требуется использовать расширения запросов или стейт-провайдеры.

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

SKILL.md · MIT
---
name: api-platform-security
description: Secure API Platform resources with security expressions, voters, securityPostValidation, and operation-level access control
capabilities: [read, search, edit, shell]
tags: [api-platform, security]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Api Platform Security (Symfony)

## Use when
- Restricting who may call each operation of an API Platform resource.
- Authorization depends on the object (owner) or on the submitted data.
- Users must see only a subset of a collection.
- Fields must be hidden depending on role or ownership.

## Default workflow
1. Set `security` per operation with `is_granted()`, `object`, and `user`, plus a `securityMessage`.
2. Move complex rules into voters: `is_granted('POST_EDIT', object)`.
3. When the rule depends on input, use `securityPostDenormalize`, or `securityPostValidation` to run after the Validator.
4. Scope rows with a `QueryCollectionExtensionInterface` (and `QueryItemExtensionInterface`) or a state provider.
5. Hide fields with serializer groups and a decorated context builder, and guard the firewall with `access_control`.
6. Test both the grant and the deny case for every protected operation.

## Guardrails
- Never filter rows with a `security` expression on a collection: it gates the whole collection, it does not scope it.
- Order of checks: `security`, denormalization, `securityPostDenormalize`, validation, `securityPostValidation`.
- `previous_object` exists only in `securityPostDenormalize`, and `request` only at resource level.
- Deny by default and mark secrets such as `password` with `#[Ignore]`.
- `getAccessDecision()` and the Twig `access_decision()` helper need Symfony 8.1 or later: verify before using them.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- The security expression and message per operation, and the voters involved.
- How collections and fields are scoped per user.
- Tests covering allowed, forbidden, and anonymous access.

## References
- `reference.md`

© dev-toolings · MIT · dev-toolings/superpowers-symfony

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

Все скиллы по теме «Безопасность» →
symfony-security-auditor reason-machines Скилл symfony-security-auditor ищет логические уязвимости и сбои контроля доступа в проектах на Symfony. Запускает двух агентов для взаимной проверки находок перед выдачей отчёта. CX Codex +1 239установок symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо php-security-expert Giuseppe Trisciuoglio Субагент php-security-expert для Claude Code проверяет безопасность PHP-приложений. Подключается для аудита, настройки DevSecOps или внедрения требований безопасности в Laravel и Symfony. CX Codex ★ 372звёзд репо php-code-review-expert Giuseppe Trisciuoglio Субагент php-code-review-expert проверяет код на PHP 8.3+, Laravel и Symfony. Находит уязвимости, проблемы с типами и ошибки в ORM, отсеивая сомнительные замечания. CX Codex ★ 372звёзд репо laravel-owasp-security AsyrafHussin Скилл laravel-owasp-security проверяет код Laravel 13 и React/Inertia.js на уязвимости OWASP Top 10 или служит инструкцией при разработке авторизации, платежей и API. CX Codex +1 1 100установок drupal-security madsnorgaard Скилл drupal-security для ИИ-кодинга, который подсказывает безопасные приёмы Drupal: параметризованные запросы, экранирование вывода, проверка прав. Включается сам, когда вы пишете формы, контроллеры или работаете с вводом пользователя. CX Codex +1 933установок

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

Весь набор →
api-platform-versioning Скилл api-platform-versioning помогает менять API на API Platform без ломающих релизов: сначала депрекация с датой sunset, параллельные версии — в крайнем случае. CX Codex +1 ★ 234звёзд репо functional-tests Скилл functional-tests помогает писать функциональные тесты контроллеров и сервисов Symfony на базе WebTestCase, KernelTestCase и DAMA rollback. CX Codex +1 ★ 234звёзд репо doctrine-migrations Скилл doctrine-migrations помогает создавать и проверять миграции Doctrine, откатывать версии и готовить их к запуску в production. Пригодится при изменениях схемы Symfony-приложения. CX Codex +1 ★ 234звёзд репо symfony-messenger Скилл для работы с асинхронными сообщениями через Symfony Messenger: настройка транспортов, обработчиков и стратегий повтора. CX Codex +1 ★ 234звёзд репо e2e-panther-playwright Скилл e2e-panther-playwright для Claude Code помогает писать E2E-тесты Symfony: Panther запускает реальный браузер, Playwright берёт сложные сценарии. Тесты проверяют поведение JavaScript, невидимое WebTestCase. CX Codex +1 ★ 234звёзд репо doctrine-relations Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов. CX Codex +1 ★ 234звёзд репо doctrine-fetch-modes Скилл doctrine-fetch-modes помогает настроить выборку данных в Doctrine ORM и DBAL 4 для Symfony: устраняет проблему N+1, переводит чтение на DTO и конфигурирует отложенную загрузку. CX Codex +1 ★ 234звёзд репо api-platform-resources Скилл api-platform-resources для Claude Code настраивает ресурсы API Platform для REST и GraphQL. Подключается при создании ресурса или настройке операций, пагинации и OpenAPI. CX Codex +1 ★ 234звёзд репо

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

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