# implementing-api-schema-validation-security

Скилл implementing-api-schema-validation-security настраивает проверку контрактов API через OpenAPI и JSON Schema на шлюзе и в коде. Защищает от инъекций, массового присвоения и утечек данных.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 280 установок · ★ 36511 у репозитория
- Автор: mahipal
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/HEAD/skills/implementing-api-schema-validation-security/SKILL.md
- Обновлён: 2026-08-31
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/implementing-api-schema-validation-security

## Что делает

Скилл генерирует и внедряет правила валидации запросов и ответов по спецификациям OpenAPI v3.0, v3.1 или JSON Schema draft-07. В схемы добавляются ограничения длины строк, регулярные выражения, перечисления, а также директива `additionalProperties: false`, которая блокирует передачу лишних полей в базу данных и предотвращает массовое присвоение.

На стороне приложения настраивается серверная валидация, например, через Pydantic-модели с параметром `extra='forbid'` для FastAPI. Для рабочей среды проверки переносятся на уровень API-шлюзов вроде AWS API Gateway, Kong или Cloudflare API Shield, чтобы отсекать некорректный трафик до выполнения серверного кода.

Для внедрения требуются готовые спецификации OpenAPI и поддержка проверки контрактов на шлюзе или в CI/CD. Без запрета скрытых полей схема не защитит от утечки внутренних идентификаторов в ответах.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mukul975/Anthropic-Cybersecurity-Skills --skill implementing-api-schema-validation-security -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/implementing-api-schema-validation-security/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/implementing-api-schema-validation-security/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mukul975/Anthropic-Cybersecurity-Skills --skill implementing-api-schema-validation-security -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/implementing-api-schema-validation-security/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mukul975/Anthropic-Cybersecurity-Skills --skill implementing-api-schema-validation-security -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/implementing-api-schema-validation-security/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mukul975/Anthropic-Cybersecurity-Skills skills/implementing-api-schema-validation-security
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/implementing-api-schema-validation-security/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mukul975/Anthropic-Cybersecurity-Skills --skill implementing-api-schema-validation-security -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/mukul975/Anthropic-Cybersecurity-Skills --path skills/implementing-api-schema-validation-security
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/implementing-api-schema-validation-security/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add mukul975/Anthropic-Cybersecurity-Skills --skill implementing-api-schema-validation-security -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/HEAD/skills/implementing-api-schema-validation-security/SKILL.md

## Когда брать
- заблокировать атаки типа SQLi, XSS и XXE на уровне схемы
- запретить массовое присвоение с помощью директивы `additionalProperties: false`
- предотвратить утечку внутренних полей сервиса через схемы ответов
- настроить валидацию моделей FastAPI через Pydantic с `extra='forbid'`

## Примеры запросов агенту
- Добавь строгую схему OpenAPI 3.1 для эндпоинта создания заказа с запретом лишних полей
- Настрой Pydantic-модели в FastAPI, чтобы отклонять неизвестные параметры в запросах
- Сгенерируй спецификацию ответа API для защиты от утечки внутренних данных

## Похожие
- [api-security-hardening](https://affpapa.org/nevibecode/skills/secondsky-api-security-hardening.md) — скилл · 519 установок
- [backend-api-security](https://affpapa.org/nevibecode/plugins/backend-api-security.md) — плагин · ★ 42780 у репозитория
- [42crunch-api-security-testing](https://affpapa.org/nevibecode/plugins/42crunch-api-security-testing.md) — плагин · ★ 1 у репозитория
- [api-security-testing](https://affpapa.org/nevibecode/skills/usestrix-api-security-testing.md) — скилл · 17500 установок
- [api-security-best-practices](https://affpapa.org/nevibecode/skills/api-security-best-practices.md) — скилл · 1739 установок
- [api-security](https://affpapa.org/nevibecode/skills/api-security.md) — скилл · 220 установок

Из того же набора: [mukul975/anthropic-cybersecurity-skills](https://affpapa.org/nevibecode/by/mukul975/anthropic-cybersecurity-skills.md) — 152 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
