Seminar Turbinia – API, Client und Weboberfläche

Das Seminar erschließt die drei zentralen Bedien- und Integrationswege von Turbinia: Kommandozeilenclient, REST-API und Weboberfläche. Der Schwerpunkt liegt auf reproduzierbarer Auftragserstellung, sauberer Statusauswertung, Ergebnisübernahme und einer konsistenten Konfiguration über mehrere Umgebungen.

Inhaltsübersicht

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Seminarinhalte
• Praxisübungen
• Methodik

Zielsetzung

• Client, REST-API und Weboberfläche funktionsbezogen voneinander abgrenzen
• Evidence und Jobs kontrolliert einreichen sowie Requests eindeutig nachverfolgen
• Status-, Task-, Ergebnis- und Protokolldaten sicher interpretieren
• Wiederholbare Bedien- und Integrationsabläufe mit Fehlerbehandlung aufbauen

Zielgruppe

DFIR-Analysten, SOC- und Incident-Response-Teams, technische Anwendungsbetreuung, Automatisierungsverantwortliche und Entwickler von angebundenen Werkzeugen.

Voraussetzungen

Grundverständnis von HTTP, JSON, Kommandozeilenwerkzeugen und digitalforensischen Beweismitteln. Programmierkenntnisse sind für den Client-Teil nicht erforderlich.

Seminarinhalte

1. Schritt 1: Zugriffswege einordnen

   Client, API und Weboberfläche werden nach Bedienkomfort, Automatisierbarkeit, Authentisierung und geeignetem Nutzungsszenario verglichen.

2. Schritt 2: Client installieren und konfigurieren

   Konfigurationsdatei, Serveradresse, Umgebungsprofile, Ausgabeformat und optionale Authentisierungsparameter werden reproduzierbar eingerichtet.

3. Schritt 3: Jobs und Evidence ermitteln

   Verfügbare Jobdefinitionen, unterstützte Evidence-Typen und notwendige Parameter werden abgefragt und für einen konkreten Untersuchungsfall ausgewählt.

4. Schritt 4: Auftrag über den Client einreichen

   Evidence, Jobauswahl, Recipe-Optionen, Beschreibung und eindeutige Metadaten werden zu einem nachvollziehbaren Request verbunden.

5. Schritt 5: Status systematisch auswerten

   Request-, Job- und Task-Status, Zeitstempel, Fehler, Warnungen und Worker-Zuordnung werden schrittweise geprüft.

6. Schritt 6: Ergebnisse und Logs übernehmen

   Ergebniszusammenfassungen, Detailausgaben, Logdateien und erzeugte Evidence werden gezielt geladen, verifiziert und revisionsfähig abgelegt.

7. Schritt 7: REST-API erkunden

   Endpunkte, Schemas, OpenAPI-Dokumentation, Parameter, Antwortcodes und grundlegende Fehlerbehandlung werden anhand typischer Abfragen untersucht.

8. Schritt 8: Weboberfläche produktiv nutzen

   Requests, Tasks, Laufzeiten und Downloads werden in der Oberfläche verfolgt; Zustandsinformationen werden mit Client- und API-Ausgaben abgeglichen.

9. Schritt 9: Authentisierung und Umgebungen trennen

   Test-, Abnahme- und Produktivzugriffe werden mit getrennten Profilen, Token- beziehungsweise OIDC-Verfahren und minimalen Berechtigungen organisiert.

10. Schritt 10: Bedienstandards definieren

    Namenskonventionen, Pflichtmetadaten, Fehlercodes, Ergebnisablage und Übergabe an nachgelagerte Systeme werden als Teamstandard festgelegt.

Praxisübungen

• Einen Request über den Client einreichen und bis zum Abschluss nachverfolgen
• Den gleichen Status über API und Weboberfläche abgleichen
• Fehlerhafte Parameter anhand von Antwortcode und Logausgabe korrigieren
• Eine standardisierte Ergebnisübergabe für einen Incident-Response-Fall erstellen

Methodik

Live-Demonstrationen werden durch kleinschrittige Bedienübungen ergänzt. Jede Aufgabe enthält einen Prüfpunkt, damit Client-, API- und Webausgabe miteinander verifiziert werden können.