Port Catalog
The port catalog is a reference library of well-known service-to-port mappings (e.g., PostgreSQL = 5432). Use "Add from Catalog" in port list forms to copy ports into your scan configuration. Catalog entries are copied, not linked — changes to a catalog entry do not affect existing port lists. Built-in entries ship with mipo and cannot be modified.
Inputs
| Name | Description | Allowed values | Default |
|---|---|---|---|
Name | Human-readable label for this catalog entry | Non-empty string, must be unique across port catalog | — |
Description | Optional note about this service | Any text, max 10,000 characters | Empty |
Ports | Port numbers with optional protocol | Comma/space/newline separated, 1-65535, format: port or port/protocol | TCP if protocol omitted |
Fields & columns
| Name | Description |
|---|---|
Name | Editable inline (non-built-in) — the catalog entry label. Links to the edit form. |
Description | Editable inline (non-built-in) — optional note |
Total Ports | Count of ports defined in this entry |
Ports | Preview of the first few port numbers in this entry |
Sources | External reference links for where this mapping was sourced |
Built-in | Whether this entry ships with mipo and is read-only |
Gotchas
- Catalog ports are copied into port lists, not linked. Updating a catalog entry does not change existing port lists that imported from it.
- Built-in catalog entries cannot be modified — clone them to create customizable copies.
API calls (6)
| Method | Path | Description |
|---|---|---|
| GET | /api/config/port-catalog | List all port catalog entries |
| POST | /api/config/port-catalog | Create a new catalog entry |
| PUT | /api/config/port-catalog/:id | Update an existing catalog entry |
| DELETE | /api/config/port-catalog/:id | Delete a catalog entry (if unreferenced) |
| GET | /api/config/port-catalog/:id/details | Get port catalog entry details |
| GET | /api/config/port-catalog/filter-values | Get available filter values for the port catalog table |
Related
- Port Lists — Import ports from catalog entries via "Add from Catalog"
- Scan Templates — Consume port lists (populated from catalog) to define which ports to scan