Dashboard

The Dashboard is the default landing page after login, providing a modular, widget-based overview of your mipo deployment. Unlike the Health Overview (which shows infrastructure topology), dashboards are fully customizable views tailored to your role. Add, remove, and rearrange widgets to build a personalized view. Multiple named dashboards can be created and shared with other users.

Fields & Columns

Name Description
Operations Widgets Scanner fleet status, active/recent scans, system health, alarms, single scanner/schedule status
Security Widgets Port state changes, attack surface summary, scanner coverage
Admin Widgets Ingest node health, database health, backup status, certificate expiry
GRC Widgets Recent audit activity, scan schedule compliance, scan coverage gaps

How To

Add a Widget

  1. Click the "+ Add Widget" button in the top-right corner.
  2. Browse widgets by category or search by name.
  3. Click a widget to add it to your dashboard.
  4. Configurable widgets (e.g., Single Scanner Status) will open a config modal first.

Remove a Widget

  1. Hover over the widget to reveal the action menu.
  2. Click the remove (X) button in the widget header.

Rearrange Widgets

  1. Drag a widget by its header to a new position.
  2. Drop it on another widget to swap their positions.

Create a New Dashboard

  1. Click the dashboard name/switcher in the top-left corner.
  2. Click "New Dashboard" and enter a name.
  3. The new dashboard starts empty — add widgets to customize it.

Share a Dashboard

  1. Open the dashboard switcher.
  2. Toggle the "Shared" option on the dashboard you want to share.
  3. Other users will see it in their "Shared Dashboards" section.

Configure a Widget

  1. Hover over a configurable widget to reveal the action menu.
  2. Click the settings icon in the widget header.
  3. Update the configuration (e.g., select a specific scanner) and save.

Gotchas

  1. Widgets respect RBAC scopes — if you lack permission for a widget's data source, it shows a lock icon instead of data.
  2. Dashboard layouts are saved per-user. Shared dashboards are read-only copies for other users.
  3. Each dashboard can hold up to 20 widgets.

API Calls (6)

Method Path Description
GET /api/profile/dashboards List all dashboards for the current user
POST /api/profile/dashboards Create a new dashboard
PUT /api/profile/dashboards/:id Update a dashboard
DELETE /api/profile/dashboards/:id Delete a dashboard
PUT /api/profile/dashboards/:id/activate Set a dashboard as the active default
POST /api/profile/dashboards/:id/import Import a shared dashboard configuration

Related Pages

  • Scanners — Scanner Fleet Status and Single Scanner widgets pull data from the scanners API
  • Scan Status — Active Scans and Recent Scans widgets show current scan data
  • Schedules — Schedule Compliance widget checks scan schedules are running on time
  • Health Overview — System Health widget provides a compact version of the full health overview
  • Audit Changes — Recent Audit Activity widget shows the latest configuration changes