Platform Guide
Dashboard
The Dashboard is your central view of the security health of your infrastructure. It brings together scan status, vulnerability findings, agent health, asset discovery, GDPR compliance, and a snapshot of AI-generated insights into a single, customisable page that updates when you switch between account groups.
The Stats Row
A pinned row at the top of the Dashboard always shows three high-level metrics for the current account group:
| Metric | Description |
|---|---|
| Completed Scans | Number of tests currently in a completed state |
| Active Tests | Number of tests currently running or pending execution |
| Failed Tests | Number of tests currently in a failed state |
These are point-in-time counts, not cumulative historical totals.
Dashboard Widgets
Below the stats row, seven widgets are arranged in a grid. Each widget independently fetches its own data for the current account group.
Default Widget Layout
The default layout is a 12-column grid with one pinned full-width row, followed by resizable cards:
| Row | Default cards (left to right) |
|---|---|
| Pinned top row | Dashboard Stats (full width) |
| Row 1 | CyfroAI Insights (large), Vulnerability Summary (small) |
| Row 2 | GDPR Compliance (small), Top Vulnerabilities (large) |
| Row 3 | Scan Status (small), Agent Status (small), Asset Discovery (small) |
Small cards use one-third width, large cards use two-thirds width, and the pinned stats row is always full width.
CyfroAI Insights
A compact view of the most recent AI-generated scan analyses.
Lists up to 4 recent insights, each showing the source type (Port Scan, Asset Discovery, or Service Fingerprinting), a relative timestamp, and a plain-text preview of the executive summary.
A +N more indicator appears when an insight contains additional findings beyond the preview.
Click View All to open the full CyfroAI Insights page.
Empty state: "No AI insights yet — Run scans to generate AI analysis."
Vulnerability Summary
A breakdown of vulnerability findings from the most recent scan.
Quick stats: Targets scanned, total vulnerabilities, misconfiguration count, and secrets count.
Severity distribution: A proportional bar chart showing counts across Critical, High, Medium, Low, and Info severity levels.
Top findings: Up to 6 of the most significant vulnerability entries, each showing a severity badge, identifier or package name, and occurrence count.
The header shows the timestamp of the last scan the data is drawn from.
Empty state: "No vulnerabilities found."
Top Vulnerabilities
A detailed table of the highest-priority vulnerabilities across your infrastructure.
Shows up to 8 findings, prioritised by severity (Critical first, then High, then Medium).
Each row shows: vulnerability ID, package name, affected target, severity badge, description, and first-detected date.
Click any row to jump to the corresponding entry in the Report page, pre-filtered to that specific finding.
Click View All in the header to open the Report page filtered to the full vulnerabilities list.
Empty state: "No high or medium vulnerabilities found."
GDPR Compliance
A summary of your organisation's GDPR compliance posture based on the latest automated report.
Overall score: A donut chart displaying the compliance score (0–100), colour-coded green (≥ 80), amber (≥ 60), or red (< 60).
Trend indicator: An up or down arrow showing whether the score has improved or declined since the previous report.
Quick stats: Critical findings, High findings, and total findings counts.
Category breakdown: Each GDPR category listed with its finding count, a proportional fill bar, and individual score. Categories are sorted by finding count.
The refresh button (↺ icon in the header) manually triggers a new compliance report and reloads the data.
Pending state: If no report has been generated yet, a "GDPR report pending" message is shown with a refresh button to trigger the first run.
GDPR Compliance is a feature-flagged capability. Contact your administrator if this widget is not visible.
Scan Status
A live view of your configured tests and their current execution state.
Summary bar: Running, Done, Failed, and Pending counts across all tests.
Status normalisation: The status of scans are mapped into common labels:
- 1Completed
- 2Running
- 3Pending
- 4Failed
Test list: Up to 4 tests, each showing:
- 1Status indicator (colour coded dot)
- 2Test name and category
- 3Current status label (In Progress, Completed, Failed, Pending)
- 4Number of assigned agents
- 5Last run time (relative time)
- 6Inactive label is displayed if the test is currently paused
Click View All Scans to go to the Scans Setup page.
Empty state: "No active scans — Start a new scan to see status."
Agent Status
A health summary of all CyfroAgents registered to the current account group.
Health summary bar: Healthy, Warning, and Offline agent counts.
Agent list: One row per agent showing:
- 1Health status dot (green = healthy, amber = warning/degraded, red = offline/unhealthy)
- 2Agent name and location (if set during registration)
- 3Status label pill
- 4Last heartbeat time (relative)
- 5Test counts: running, failed, and total
Click View All Agents to go to the CyfroAgent management page.
Empty state: "No agents found — No agents registered for this group."
Asset Discovery
An overview of the most recent asset discovery scan results.
Quick stats: Total assets found, subnets observed, open ports detected, and IPv6 hosts.
Top discovered hosts: Up to 2 recently found hosts with hostname, IP address, and discovery timestamp.
Top open ports: Up to 5 most common open ports with the number of hosts they were found on. Common service names (for example, 22 SSH, 443 HTTPS, 3389 RDP) are shown inline.
Management protocols and storage services detected are listed as labelled badges.
Click View Asset Discovery to open the full asset report in the Report page.
Empty state: "No discovery data — Run a scan to discover network assets."
Customising the Layout
The dashboard layout is fully customisable. Your arrangement is saved per browser and persists across sessions.
Entering Customise Mode
Click Customize Layout (grid-edit icon in the top-right toolbar). A blue banner confirms you are in customise mode.
Moving Widgets
Click and drag any widget by its grip handle (the ⠿ icon that appears in customise mode) to reposition it. Widgets automatically pack upward to fill gaps.
Resizing Widgets
Each widget has a − and + button in customise mode:
- 1− shrinks the widget to a small size (one-third of the page width).
- 2+ expands the widget to a large size (two-thirds of the page width).
The stats row at the top is always full-width and cannot be moved or resized.
Saving, Resetting, and Cancelling
| Button | Behaviour |
|---|---|
| Save Layout | Saves your current arrangement to the browser. It will be restored the next time you open the Dashboard. |
| Reset | Reverts the layout to the factory default arrangement in the draft view, without saving. |
| Cancel | Discards all unsaved changes and exits customise mode. |
Layout is saved to your browser's local storage. If you clear your browser data or use a different browser, the layout will revert to the factory default. Each user's layout is independent.
Switching Account Groups
Use the account group selector in the sidebar to switch between groups. Every widget on the Dashboard automatically reloads its data for the newly selected group. The layout arrangement stays the same; only the data changes.
Refreshing Data
Most widgets load their data once when the page opens. To get the latest data:
- 1For all widgets: Reload the page.
- 2For GDPR Compliance only: Use the ↺ refresh button in the widget header to trigger a new report without reloading the page.
Frequently Asked Questions on Dashboards
Why are some widgets showing "No data" or empty states?
Each widget needs the relevant scans or agents to have run at least once. For example, Vulnerability Summary needs a completed vulnerability scan, and Asset Discovery needs a completed asset discovery scan. Set up tests in Scans Setup tab to start populating the dashboard.
My layout reset after I cleared my browser. Can I restore it?
Dashboard layouts are stored in local browser storage. Clearing browser data removes the saved layout and reverts to the factory default. Reconfigure the layout in Customise mode and save it again.
Can different users have different dashboard layouts?
Yes. Each user's layout is stored independently in their own browser. Changing your layout does not affect other users.
The stats numbers look different from what I expected. Why?
Dashboard stats reflect current states, not historical counts. For example, "Completed Scans" is the number of tests in a completed state right now. It is not a cumulative total of every scan that has ever finished.
Can I add or remove widgets entirely?
The current layout customisation allows repositioning and resizing. Hiding or removing individual widgets from the grid is not yet supported.