Anpassbare Dashboards (Pro)

Hinweis: Anpassbare Dashboards (Layouts, Widgets und der Widget-Katalog) sind eine DefectDojo-Pro-Funktion. Sie sind standardmäßig deaktiviert — ein Superuser kann sie unter Settings > Feature Flags sowohl auf Cloud- als auch auf On-Premise-Instanzen aktivieren.

Mit den anpassbaren Dashboards von DefectDojo Pro kann jeder Benutzer seine eigene Startseite aus Widgets zusammenstellen — Zählern, Diagrammen, Bestenlisten, Feeds und Notizen —, die per Drag-and-Drop auf einem Raster angeordnet werden. Anstelle eines einzigen festen Dashboards für alle erstellen Sie die Layouts, die für Sie relevant sind: eine Management-Übersicht, eine Triage-Warteschlange, ein Board zur Behebungsgeschwindigkeit, eine Ansicht zur Scanner-Effektivität. Sie können Layouts privat halten, sie für Ihr gesamtes Team veröffentlichen, eines als Standard-Startseite festlegen und jedes Layout (Ihr eigenes oder eine gemeinsame Vorlage) als Ausgangspunkt klonen.

Vergleich mit Open Source#

Open-Source-DefectDojo verfügt über ein einziges, integriertes Haupt-Dashboard mit einem festen Satz an Übersichtskarten und Diagrammen, die ein Superuser ein- oder ausblenden kann. Es ist für jeden Benutzer gleich.

DefectDojo Pro ersetzt diese feste Seite durch benutzerindividuelle, anpassbare Dashboards. Sie legen fest, welche Widgets angezeigt werden, wie sie gefiltert werden und wo sie im Raster platziert sind. Sie können beliebig viele benannte Layouts erstellen, zwischen ihnen wechseln, sie mit Ihrem Team teilen und das gesamte System über die REST-API oder ein LLM steuern.

💡 Tipp: In DefectDojo Pro wurden Assets früher Produkte und Organisationen früher Produkttypen genannt. Die Benutzeroberfläche verwendet die neue Terminologie, aber einige zugrunde liegende Widget-Einstellungen verwenden weiterhin die alten Namen — beispielsweise erwarten die meisten Widgets ein model mit dem Wert finding, product, engagement oder test. Wo dies relevant ist, wird es unten erläutert.

Anpassbare Dashboards aktivieren#

Anpassbare Dashboards sind standardmäßig deaktiviert. Ein Superuser kann sie unter Settings > Feature Flags aktivieren, sowohl auf Cloud- als auch auf On-Premise-Instanzen. Siehe Feature Flags.

Sobald die Funktion aktiviert ist, zeigt die Seite 🏠 Home Ihr anpassbares Dashboard an, und die Dashboards-REST-API wird verfügbar.

🔑 Wichtig: Solange die Funktion deaktiviert ist, behält die Startseite das bisherige Dashboard bei, und jeder /api/v2/dashboards/-Endpunkt gibt 403 Dashboard V2 is not enabled. zurück. Das Aktivieren ändert nicht den Datenzugriff eines Benutzers — jedes Widget respektiert weiterhin die rollenbasierte Zugriffskontrolle von DefectDojo, sodass jeder Benutzer stets nur die Befunde, Assets und anderen Datensätze sieht, für die er berechtigt ist.

Grundkonzepte#

Ein anpassbares Dashboard besteht aus wenigen einfachen Bausteinen.

Layouts#

Ein Layout ist ein benanntes Dashboard: eine Sammlung von Widgets und ihren Positionen im Raster. Jedes Layout gehört Ihnen, und Sie können beliebig viele davon anlegen — zum Beispiel ein Board »Daily Triage« und ein separates »Exec Overview«. Ein Layout speichert drei Dinge:

• widgets — die geordnete Liste der enthaltenen Widgets, jedes mit eigenem Typ, Titel und Konfiguration.
• layout — wo jedes Widget sitzt und wie groß es im Raster ist.
• settings — Anzeigeoptionen auf Layout-Ebene.

Wenn Sie die anpassbaren Dashboards zum ersten Mal öffnen, erhalten Sie von DefectDojo eine persönliche Kopie der Startvorlage Default Dashboard, damit Sie nie vor einer leeren Seite stehen.

Widgets#

Ein Widget ist ein einzelnes Panel im Dashboard. Jedes Widget ist eine Instanz eines Typs aus dem Katalog (ein Zähler, ein Diagramm, eine Top-N-Bestenliste usw.) und trägt seine eigene Konfiguration: welches Datenmodell es liest (finding, product, engagement oder test), welche Filter es eingrenzen, und typspezifische Anzeigeoptionen wie Diagrammtyp, Farben oder Gruppierung. Zwei Widgets desselben Typs mit unterschiedlichen Filtern sind vollständig unabhängig voneinander.

Jedes Widget verfügt außerdem über ein optionales Auto-Refresh-Intervall (aus, 30 Sekunden, 1 Minute, 5 Minuten oder 15 Minuten) und einen bearbeitbaren Titel.

Der Widget-Katalog#

Der Katalog ist das feste Menü der von der Plattform unterstützten Widget-Typen, gegliedert in vier Kategorien — Numbers, Charts, Lists & Feeds und Static & Utility. Wenn Sie ein Widget hinzufügen, wählen Sie dessen Typ aus dem Katalog. Der Katalog ist auch über die API verfügbar, sodass Skripte und LLMs die verfügbaren Widget-Typen und eine bewährte Startkonfiguration für jeden Typ ermitteln können. Die vollständige Liste finden Sie unten unter Der Widget-Katalog.

Das Raster#

Widgets werden auf einem 12-spaltigen Raster platziert. Im Bearbeitungsmodus ziehen Sie Widgets, um sie zu verschieben, und ziehen die untere rechte Ecke, um sie in der Größe zu ändern; das Raster verdichtet sich nach oben, um Lücken zu füllen. Jeder Widget-Typ hat sinnvolle Mindest- und Höchstgrößen, damit Diagramme und Tabellen lesbar bleiben.

Teilen, Klonen und Standardeinstellungen#

• Standard — eines Ihrer Layouts ist Ihr Standard: dasjenige, das beim Öffnen der Startseite geladen wird. Sie können jederzeit ändern, welches Layout Ihr Standard ist.
• Klonen — kopieren Sie ein beliebiges Layout (eines Ihrer eigenen oder eine gemeinsame Vorlage) als neuen, unabhängigen Ausgangspunkt in Ihren eigenen Bereich. Beim Klonen erhält die Kopie eigene Widgets, sodass das Bearbeiten des Klons das Original nie beeinflusst.
• Teilen — veröffentlichen Sie eines Ihrer Layouts als gemeinsames Layout für das gesamte Team. Andere Benutzer können es sehen und klonen, aber nur ein Maintainer des Teams kann ein gemeinsames Layout veröffentlichen, bearbeiten oder die Freigabe aufheben. Das Teilen eines Layouts teilt nur dessen Design — jeder Betrachter sieht weiterhin nur die Daten, die seine eigenen Berechtigungen zulassen.
• Start- und gemeinsame Vorlagen — DefectDojo liefert eine Reihe kuratierter gemeinsamer Vorlagen, die Sie als Ausgangspunkt klonen können (siehe Gemeinsame Vorlagen unten). Das Default Dashboard ist die spezielle »Start«-Vorlage, die neue Benutzer automatisch erhalten.

Ein Dashboard in der Benutzeroberfläche erstellen#

Die Dashboard-Symbolleiste#

Über die Symbolleiste am oberen Rand der Startseite wechseln und verwalten Sie Layouts. Sie enthält eine Layout-Auswahl (mit Badges, die Ihr Standardlayout und alle gemeinsamen Layouts/Vorlagen kennzeichnen) sowie Schaltflächen zum Erstellen eines New Layout, zum Öffnen von Manage Layouts, zum Refresh aller Widgets und zum Umschalten des Edit-Modus.

Schritt 1: Bearbeitungsmodus aufrufen#

Klicken Sie auf Edit, um das Dashboard zu entsperren. Das Raster wird zieh- und größenveränderbar, und eine Schaltfläche Add Widget erscheint. Klicken Sie auf Done, wenn Sie fertig sind — der Bearbeitungsmodus wird auch automatisch deaktiviert, wenn Sie das Layout wechseln.

Schritt 2: Ein Widget hinzufügen#

Klicken Sie im Bearbeitungsmodus auf Add Widget, um die Auswahl zu öffnen. Sie hat zwei Reiter:

• By Type — durchsuchen Sie den Katalog nach Kategorie (Numbers, Charts, Lists & Feeds, Static & Utility). Jede Karte zeigt den Namen des Widgets und eine kurze Beschreibung. Die Auswahl eines Widgets fügt es dem Raster hinzu und öffnet dessen Konfigurationsdialog.
• From Catalog — starten Sie mit einem vorkonfigurierten Widget aus einer der gemeinsamen Vorlagen (zum Beispiel dem Diagramm »Findings by Severity« aus dem Default Dashboard). Diese sind bereits fertig konfiguriert und werden direkt auf das Raster gelegt.

Schritt 3: Das Widget konfigurieren#

Jedes Widget öffnet einen auf seinen Typ zugeschnittenen Konfigurationsdialog. Zu den gängigen Einstellungen gehören:

• Title — die im Widget angezeigte Überschrift.
• Model — welche Datensätze das Widget liest (Finding, Asset, Engagement oder Test), sofern zutreffend.
• Filters — eine eingebettete Listenansicht-Filteroberfläche, die das Widget genau auf die gewünschten Datensätze eingrenzt (zum Beispiel aktive Befunde mit Schweregrad Kritisch). Die hier gewählten Filter sind dieselben, die Sie auch auf der Listenseite des jeweiligen Objekts verwenden würden.
• Refresh interval — wie oft sich das Widget selbstständig neu lädt.
• Type-specific options — zum Beispiel Diagrammtyp und Gruppierungsdimension für ein Graph-Widget, Schwellenwerte für ein Gauge-Widget oder die Kennzahl für eine Top-N-Bestenliste.

💡 Tipp: Die Daten eines Widgets respektieren stets Ihre Berechtigungen. Enthält ein gemeinsames Layout ein Widget »My Work«, sieht jeder Betrachter seine eigenen Zuweisungen und Erwähnungen — nicht die des Layout-Autors.

Schritt 4: Anordnen und speichern#

Ziehen Sie Widgets, um sie neu anzuordnen, und ziehen Sie eine Ecke, um die Größe zu ändern. Verwenden Sie das Zahnrad-Symbol an einem Widget, um es neu zu konfigurieren, und das Papierkorb-Symbol, um es zu entfernen. Positions- und Größenänderungen werden automatisch laufend gespeichert. Klicken Sie auf Done, um den Bearbeitungsmodus zu verlassen.

Layouts verwalten#

Der Dialog Manage Layouts (die Zahnrad-Schaltfläche in der Symbolleiste) ist die zentrale Anlaufstelle für alles auf Layout-Ebene:

• Your Layouts — jedes Layout, das Ihnen gehört, umbenennen, als Standard festlegen, teilen/Freigabe aufheben, klonen oder löschen.
• Create New — ein neues, leeres Layout beginnen, um von Grund auf zu erstellen.
• Shared Templates — kuratierte und vom Team veröffentlichte Layouts nach Kategorie gruppiert durchsuchen und auf Use Layout klicken, um eines in Ihren eigenen Bereich zu klonen.

Gemeinsame Vorlagen#

DefectDojo liefert vier einsatzbereite gemeinsame Vorlagen, die Sie als Ausgangspunkt klonen können:

💡 Tipp: Das Klonen einer Vorlage erstellt eine unabhängige Kopie. Passen Sie den Klon frei an — Sie beeinflussen weder die Vorlage noch andere Benutzer, die sie ebenfalls klonen.

Der Leerzustand#

Ein brandneues Layout ohne Widgets zeigt die Aufforderung »Build Your First Dashboard«. Klicken Sie auf Add Your First Widget, um direkt in den Bearbeitungsmodus zu gelangen und mit der Auswahl von Widgets zu beginnen.

Der Widget-Katalog#

Die anpassbaren Dashboards liefern die folgenden Widget-Typen, gegliedert in vier Kategorien. Die meisten Widgets lesen eines von vier Modellen — finding, product (Assets), engagement oder test — und werden durch von Ihnen gewählte Filter eingegrenzt. Die vollständig detaillierten Konfigurationsoptionen für jedes Widget sind im API-Leitfaden dokumentiert.

Numbers#

Kennzahlen auf einen Blick — Zähler, KPIs und Anzeigeinstrumente.

Charts#

Zeitreihen- und Verteilungsvisualisierungen.

Lists & Feeds#

Rangierte Listen, Feeds und eingebettete Tabellen.

Static & Utility#

Notizen, Verknüpfungen und Struktur.

Nächste Schritte#

• Dashboards mit der API automatisieren — entdecken Sie den Widget-Katalog, erstellen und aktualisieren Sie Layouts, und rendern Sie Widget-Daten über die REST-API, mit einem vollständigen Skript.
• Dashboards mit einem LLM erstellen — lassen Sie ein LLM Dashboards für Sie entwerfen und erstellen (die Dashboards-API wurde mit Blick auf KI-Agenten entwickelt).