Seminar OWASP Dependency-Track API-Automatisierung und Integration

Inhaltsübersicht

• API-Grundlagen und Authentifizierung
• Automatische Projekt- und Versionspflege
• SBOM-Upload und Verarbeitungsstatus
• Auswertung von Findings, Komponenten und Risiken

Seminarziel

Das Seminar vermittelt, wie wiederkehrende Aufgaben in Dependency-Track über API-Schnittstellen automatisiert werden. Der Fokus liegt auf robusten Skripten, klaren Parametern, Fehlerbehandlung und reproduzierbaren Integrationsmustern.

Zielgruppe

Geeignet für technische Teams, die Dependency-Track in interne Plattformen, Pipelines, Reporting-Strecken oder Ticketprozesse integrieren.

Voraussetzungen

Erforderlich sind sicherer Umgang mit REST-Grundlagen, JSON-Strukturen und Kommandozeile. Grundkenntnisse über SBOM und Projektversionierung werden vorausgesetzt.

Seminarinhalte

1. API-Zugriff vorbereiten

1. API-Schlüssel nach Aufgabe und Risiko einordnen
2. Basis-URL, Header und Authentifizierung prüfen
3. Berechtigungen für technische Benutzer begrenzen
4. Testabfragen für Verfügbarkeit und Rechte durchführen

2. Projekte automatisiert verwalten

1. Projektanlage über Name, Version und UUID unterscheiden
2. Automatische Erstellung bei BOM-Upload planen
3. Namenskonventionen für Projekte und Releases umsetzen
4. Fehlerfälle bei bestehenden Projekten behandeln

3. SBOM-Upload integrieren

1. Upload-Varianten für Datei und JSON-Payload vergleichen
2. BOM-Verarbeitung und Token-Prüfung nachvollziehen
3. Große Dateien und Pipeline-Artefakte sauber behandeln
4. Rückgabewerte und Fehlermeldungen auswerten

4. Findings und Komponenten auslesen

1. Abfragen für Schwachstellen und Komponenten strukturieren
2. Filterung nach Schweregrad, Status und Projekt aufbauen
3. Daten für Tickets, Dashboards und Reports vorbereiten
4. API-Antworten gegen leere oder unvollständige Daten absichern

5. Automatisierung stabilisieren

1. Idempotente Skripte und Wiederholbarkeit herstellen
2. Timeouts, Retry-Logik und Fehlerprotokollierung berücksichtigen
3. Geheimnisse und API-Schlüssel sicher übergeben
4. Wartbare Integrationsdokumentation erstellen

Praktische Übungen

• Aufbau einer API-Teststrecke mit technischem Schlüssel
• Automatisierte Projektanlage und BOM-Übergabe
• Abfrage kritischer Findings in strukturierter Form
• Erstellung eines einfachen Integrationsskripts mit Fehlerbehandlung

Praxisnutzen

Zwei Tage sind notwendig, weil neben den API-Aufrufen auch Rechte, Fehlerbehandlung, Projektmodell und robuste Automatisierung behandelt werden.