Zum Hauptinhalt springen

Guide

Wiederkehrende ISMS-Reports: API-Integration statt Voll-Export planen

Wiederkehrende ISMS-Reports sinnvoll aufbauen: Datenstand, API-Zugriff, Aufbewahrung und Fehlerfälle. Vollständigen Space-Export und Reporting unterscheiden.

Wiederkehrende ISMS-Reports: API-Integration statt Voll-Export planen
Julian Köhn
|Lesezeit: 3 Minuten

Ein monatlicher Bericht braucht nicht automatisch jeden Anhang aus dem ISMS. Er braucht die Informationen, auf deren Grundlage jemand entscheidet. Trennt deshalb einen vollständigen Datenexport von einem wiederkehrenden Management-Report.

Plant zuerst Berichtszweck, Datenumfang und Abnahme. Dieser Guide beschreibt eine externe API-Integration; Kopexas vollständiger Space-Export wird derzeit manuell gestartet.

Was Kopexa bereits dokumentiert

Unter den Space-Einstellungen könnt ihr einen Datenexport als ZIP manuell starten. Pro Space läuft ein Export gleichzeitig. Ein fertiges Archiv ist sieben Tage verfügbar; ein neuer Export entfernt das vorherige Archiv.

Das ist ein anderer Zweck als ein dauerhaftes Berichtsarchiv. Benötigte Stände müssen rechtzeitig in einer dafür vorgesehenen Ablage gesichert und geschützt werden. Prüft die Datenmitnahme einschließlich Anhängen und Beziehungen.

Den Bericht vom Empfänger her definieren

Legt fest, welche Entscheidung unterstützt werden soll. Für ein Review können offene Risikoentscheidungen, überfällige Maßnahmen und Veränderungen an vereinbarten KPIs genügen. Ein Vollabzug aller Datensätze erschwert die Einordnung.

Definiert Zeitraum, Stichtag, Filter und Umgang mit fehlenden Werten. „Keine Daten“ darf nicht wie „keine offenen Risiken“ aussehen. Der Guide zu ISMS-Kennzahlen hilft bei der Auswahl.

Einen externen Ablauf belastbar entwerfen

Prüft im API Playground zuerst, ob die benötigten Felder und Beziehungen verfügbar sind. Erst danach entscheidet ihr, welche Abfrage ein externer Scheduler ausführen kann. Ein eigener lesender Space-Token eignet sich für reine Abfragen; er gehört in einen Secret-Speicher, nicht in den Bericht oder den Quellcode.

Der Ablauf sollte vier getrennte Ergebnisse erzeugen: bestätigter Abruf, geprüfte Vollständigkeit, erzeugter Bericht und bestätigte Ablage. Wiederholungen dürfen nicht versehentlich mehrere widersprüchliche Berichtsstände verteilen.

Fehler sichtbar machen

Fiktives Beispiel: Der API-Zugriff ist abgelaufen. Der Scheduler startet trotzdem pünktlich, erzeugt aber keine aktuellen Daten. In diesem Fall muss der Lauf fehlschlagen und eine zuständige Person informieren. Der Bericht des Vormonats darf nicht unter neuem Datum erscheinen.

Testet außerdem unvollständige Seiten einer paginierten Abfrage, fehlende Berechtigungen und einen nicht erreichbaren Ablageort. Dokumentiert die letzte erfolgreiche Datenübernahme getrennt von der letzten Ausführung.

Einen Berichtsvertrag festlegen

Bevor jemand einen Scheduler konfiguriert, vereinbart ihr das Ausgabeformat fachlich. Eine Berichtsdefinition enthält:

  • Berichtszweck und Empfängergruppe;
  • Stichtag mit Zeitzone und betrachteten Zeitraum;
  • betroffene Spaces und erlaubten Datenumfang;
  • Definition jeder Kennzahl einschließlich fehlender Werte;
  • verantwortliche Person für Datenfehler und Aufbewahrung.

Speichert mit jedem Ergebnis die Abrufzeit und den Status der Vollständigkeitsprüfung. Bei einer paginierten Quelle ist eine erfolgreich geladene erste Seite noch kein vollständiger Bericht. Falls ein Teilabruf zulässig sein soll, muss das Ergebnis diesen Umfang ausdrücklich nennen.

Den Monatsvergleich nicht durch neue Definitionen verfälschen

Ändert ihr eine Kennzahl, sollte der Bericht die verwendete Definition erkennen lassen. „Überfällige Maßnahmen“ kann beispielsweise nur aktive oder auch zurückgestellte Maßnahmen enthalten. Ein Rückgang nach einem Filterwechsel ist keine nachgewiesene Verbesserung.

Kopexas Ziele und KPIs können die fachliche Grundlage liefern. Für eine externe Zusammenstellung muss dennoch geprüft werden, welche Felder und Historienstände über die aktuelle API verfügbar sind. Fehlt eine benötigte Grundlage, verbessert ihr zuerst das Datenmodell oder begrenzt den Bericht. Ein plausibel aussehender Zahlenwert ersetzt keinen bestätigten Abruf.

Abnahme vor dem Dauerbetrieb

Vergleicht einen Bericht manuell mit dem Quellsystem. Prüft Rollen, Aufbewahrung und den Zugriff auf sensible Inhalte. Startet erst dann den wiederkehrenden Lauf. Das Management-Review sollte aus dem Ergebnis eine Entscheidung ableiten können, ohne den Integrationscode verstehen zu müssen.

Kurz beantwortet

Häufige Fragen

Noch eine Frage offen? Hier findest du die Antworten zum Nachlesen.

Wie plane ich wiederkehrende ISMS-Reports mit Kopexa?

Definiert Empfänger, Kennzahlen, Zeitraum und Vollständigkeitsprüfung. Prüft dann die benötigten Felder in der API und richtet einen externen Abruf mit Fehlerüberwachung ein. Der dokumentierte vollständige Space-Export wird manuell gestartet und ist kein wiederkehrender Reporting-Lauf.

Quellen

  1. Datenexport eines Space — Kopexa [Abgerufen am ]