Port Catalog Form
The Port Catalog form creates a new catalog entry or edits an existing one. Catalog entries are the source library that Port Lists import from — group ports by service or use case (e.g. "Web", "Database") so operators can quickly compose port lists without re-typing port numbers.
Inputs
| Name | Description | Allowed values | Default |
|---|---|---|---|
Name | Service or use-case name for this catalog entry | Non-empty string, must be unique across catalog entries (e.g., "Web", "Database") | — |
Description | Optional free-text note describing what this entry represents | Any text, max 10,000 characters | Empty |
Ports | Comma-separated entries. Each entry is a port (1–65535) optionally suffixed with the protocol (e.g. 22/tcp, 53/udp). Bare numbers default to TCP. | e.g. 80, 443, 8080/tcp, 53/udp | Empty (form rejects submission) |
Gotchas
- Built-in catalog entries (those shipped with mipo) are read-only — the form renders them with a disabled banner and no Save button. Built-ins also display their `sources` provenance (where the curated port list came from).
- **When creating:** Names must be unique across all catalog entries. The API returns a 409 if you reuse a name. Pick names that describe a service or category, not a specific deployment ("Web" not "prod-web").
- **When editing:** Changes propagate to any Port List that imported from this catalog entry only at the next import — already-imported ports are NOT auto-updated. To refresh, re-import in the affected port lists.
- Catalog entries do not get scanned themselves — they are a reference library only. To use them in a scan, import their ports into a Port List, then reference the Port List from a Scan Template.
API calls (3)
| Method | Path | Description |
|---|---|---|
| GET | /api/config/port-catalog/:id | Load an existing catalog entry (Edit mode) |
| POST | /api/config/port-catalog | Create a new catalog entry (Create mode) |
| PUT | /api/config/port-catalog/:id | Update an existing catalog entry (Edit mode) |
Related
- Port Catalog — Parent list page — describes filtering, deletion, and provenance display
- Port Lists — Port lists import from catalog entries via the catalog picker