Przejdź do treści
Biblioteka skilli
Bezpieczeństwo · Przegląd i audyt

api-schema-security

/api-schema-security

Przegląda specyfikacje OpenAPI i GraphQL pod kątem bezpieczeństwa: uwierzytelnianie, ścisłe schematy, limity i pola wrażliwe, z lintowaniem w CI.

Repozytorium
Claude-Blue ↗
Licencja
MIT
Ostatnia zmiana repozytorium
01.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
6
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Przegląda specyfikacje OpenAPI i GraphQL pod kątem bezpieczeństwa: uwierzytelnianie, ścisłe schematy, limity i pola wrażliwe, z lintowaniem w CI.

Oryginalny opis (EN)

Review and lint API specifications (OpenAPI 3.x, GraphQL schemas) for security — authentication on every operation, strict schemas (additionalProperties false, formats, max lengths), rate-limit and pagination limits, sensitive fields, server URLs — with Spectral/OWASP rulesets, and enforce schema validation at the gateway. Use when reviewing an API design, adding API linting to CI, or hardening request validation.

Jak działa

  1. Lint
  2. Checklist
  3. Enforce at runtime
  4. Related skills
  5. References
Sekcje z nagłówków SKILL.md, w oryginale · 44 linii, 229 słów
Podgląd SKILL.md
---
name: api-schema-security
description: Review and lint API specifications (OpenAPI 3.x, GraphQL schemas) for security — authentication on every operation, strict schemas (additionalProperties false, formats, max lengths), rate-limit and pagination limits, sensitive fields, server URLs — with Spectral/OWASP rulesets, and enforce schema validation at the gateway. Use when reviewing an API design, adding API linting to CI, or hardening request validation.
license: MIT
metadata:
  category: api-security
  version: "2.0.0"
  verification: documented
---

# API Schema Security

## Lint

```sh
npx @stoplight/spectral-cli lint openapi.yaml --ruleset .spectral.yaml
```
`.spectral.yaml`:
```yaml
extends:
  - spectral:oas
  - https://unpkg.com/@stoplight/spectral-owasp-ruleset/dist/ruleset.mjs
```
The OWASP ruleset flags missing security schemes, HTTP servers, unbounded strings/arrays, missing rate-limit headers, numeric IDs, and more. 42Crunch and similar tools provide commercial audits.

## Checklist

| Area | Check |
|---|---|
| AuthN | Global `security` requirement; no operation with `security: []` unless intentionally public |
| Schemas | `additionalProperties: false` on request bodies (prevents mass assignment), `maxLength`/`pattern`/`format` on strings, `maxItems` on arrays, numeric `minimum/maximum` |
| Identifiers | Prefer non-sequential IDs; never rely on them for authorization |
| Responses | Explicit response schemas; no internal fields (hashes, internal IDs, tokens) |
| Pagination | Enforced max page size |
| Servers | `https://` only; no internal hostnames in public specs |
| Errors | Generic error schema without stack traces |
| GraphQL | Disable introspection in production (or restrict), query depth/complexity limits, per-field authorization, persisted queries for public clients |

## Enforce at runtime

Gateway request validation against the spec (Kong/Apigee/AWS API Gateway request validators, Envoy/OPA policies, framework validators like FastAPI/pydantic, express-openapi-validator) — reject unknown fields and invalid types before business logic.

## Related skills

`api-inventory`, `api-authorization-testing`, `release-gate`

## References

- OWASP API Security Top 10 2023: https://owasp.org/API-Security/editions/2023/en/0x11-t10/
- Spectral: https://github.com/stoplightio/spectral
- Spectral OWASP ruleset: https://github.com/stoplightio/spectral-owasp-ruleset
- OWASP GraphQL Cheat Sheet: https://cheatsheetseries.owasp.org/cheatsheets/GraphQL_Cheat_Sheet.html

Wersje

W bazie nie ma innych skilli o nazwie api-schema-security.

Migawka bazy z 13.11.2026 · wersja paczki c5af5d6c7395 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100api-security-review
    Przegląda specyfikacje OpenAPI, schematy GraphQL i kod endpointów pod kątem OWASP API Top 10: BOLA, uwierzytelnianie, nadmierne dane i limity.
  • 100validating-api-schemas
    Waliduje schematy API względem specyfikacji OpenAPI, JSON Schema i GraphQL.
  • 100validating-api-schemas
    Waliduje schematy API względem specyfikacji OpenAPI, JSON Schema i GraphQL.
  • 90api
    Ocenia bezpieczeństwo REST i GraphQL: specyfikacje OpenAPI, schematy, middleware uwierzytelniania i konfigurację bramki, tylko defensywnie.
  • 100owasp-api-security-top-10-hardening
    Utwardza REST i GraphQL API przeciwko podatnościom z listy OWASP API Security Top 10.
  • 100api-audit
    Sprawdza API REST, GraphQL i RPC pod kątem OWASP API Security Top 10 2023: uwierzytelnianie, autoryzację, limity i ekspozycję danych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.