was Prüfer wirklich sehen wollen
Security-Prüfer öffnen ein OpenAPI-Dokument mit einer klaren Checkliste im Kopf: Sind alle Endpoints authentifiziert? Sind Fehlerresponses vollständig dokumentiert? Werden Eingaben validiert? Wer diese Perspektive kennt, baut API-Dokumentation, die Audits beschleunigt, Findings reduziert und Vertrauen schafft.
Inhaltsverzeichnis
- 1. Die Audit-Perspektive: Was Prüfer als erstes suchen
- 2. Security Schemes: das erste Prüffeld
- 3. Public Endpoints explizit dokumentieren
- 4. Fehlerresponses vollständig modellieren
- 5. Input-Validierung in OpenAPI abbilden
- 6. Sensitive Daten in Schemas kennzeichnen
- 7. OWASP API Security Top 10 und OpenAPI
- 8. Rate Limiting und Quota in der Dokumentation
- 9. Audit-Findings: vermeidbar vs. unvermeidbar
- 10. Zusammenfassung
- 11. FAQ