IVS - Identification & Vulnerability Scanning

View IVS module KPIs, assets, and threats.

Commands

• ivs kpis - View IVS general KPIs
• ivs years - List available IVS data years
• ivs year-kpis - View IVS KPIs for a specific year
• ivs assets - List IVS assets
• ivs threats - List IVS threats

---

ivs kpis

Display IVS general KPIs including identified threats, severity breakdown, and asset counts.

mysecutec ivs kpis [flags]

Flags

Flag	Type	Default	Description
--last-n-days	int	30	Number of days for KPI calculation

API

GET /threat/v1/dashboard/ivs/general-kpis?last_n_days=30

Request Example

mysecutec ivs kpis --last-n-days 7

GET /threat/v1/dashboard/ivs/general-kpis?last_n_days=7
Authorization: Bearer <token>
Accept: application/json

Response

{
  "unsolved_identified_threats": 12,
  "total_identified_threats": 48,
  "critical_threats": 3,
  "high_threats": 9,
  "medium_threats": 20,
  "low_threats": 16,
  "identified_assets": 120,
  "ip_addresses": 80,
  "web_applications": 15,
  "software": 200,
  "operating_systems": 8
}

Model: IVSGeneralKPIs

Field	Type	Description
unsolved_identified_threats	number	Threats still open (number or string)
total_identified_threats	number	Total identified threats (number or string)
critical_threats	int	Critical severity count
high_threats	int	High severity count
medium_threats	int	Medium severity count
low_threats	int	Low severity count
identified_assets	int	Total identified assets
ip_addresses	int	IP address count
web_applications	int	Web application count
software	int	Software count
operating_systems	int	Operating system count

---

ivs years

List years that have IVS data.

mysecutec ivs years

API

GET /threat/v1/dashboard/ivs/years

Response

{
  "data": {
    "items": [2024, 2025]
  }
}

Model: IVSYearsResponse

Field	Type	Description
data.items	[]int	Available years

---

ivs year-kpis

View per-severity monthly KPI series for a specific year.

mysecutec ivs year-kpis --year <year>

Flags

Flag	Type	Required	Description
--year	int	Yes	Year for KPI data

API

GET /threat/v1/dashboard/ivs/year-kpis?year=2025

Request Example

mysecutec ivs year-kpis --year 2025

GET /threat/v1/dashboard/ivs/year-kpis?year=2025
Authorization: Bearer <token>
Accept: application/json

Response

{
  "critical": [1, 0, 2, 1, 3, 0, 0, 0, 0, 0, 0, 0],
  "high": [4, 3, 5, 6, 7, 2, 0, 0, 0, 0, 0, 0],
  "medium": [10, 8, 12, 11, 14, 6, 0, 0, 0, 0, 0, 0],
  "low": [8, 6, 9, 7, 10, 5, 0, 0, 0, 0, 0, 0]
}

Model: IVSYearKPIs

Field	Type	Description
critical	[]int	Monthly critical counts (Jan-Dec)
high	[]int	Monthly high counts (Jan-Dec)
medium	[]int	Monthly medium counts (Jan-Dec)
low	[]int	Monthly low counts (Jan-Dec)

---

ivs assets

List IVS assets with their threat counts.

mysecutec ivs assets [flags]

Flags

Flag	Type	Default	Description
--limit	int	20	Number of results
--offset	int	0	Result offset
--search	string		Search query

API

GET /threat/v1/dashboard/ivs/assets?limit=20&offset=0

Query Parameters:

Parameter	Type	Description
limit	int	Max results
offset	int	Skip results
search	string	Search query

Request Example

mysecutec ivs assets --limit 50 --search server

GET /threat/v1/dashboard/ivs/assets?limit=50&offset=0&search=server
Authorization: Bearer <token>
Accept: application/json

Response

{
  "data": {
    "items": [
      {
        "id": "asset-uuid-123",
        "name": "web-server-01",
        "type": "ip_address",
        "threats": {
          "solved": 4,
          "total": 7
        }
      }
    ]
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 120
  }
}

Model: IVSAssetEntry

Field	Type	Description
id	string	Asset ID
name	string	Asset name
type	string	Asset type
threats	IVSAssetThreat	Threat counts for the asset

Model: IVSAssetThreat

Field	Type	Description
solved	int	Solved threats
total	int	Total threats

---

ivs threats

List IVS threats with risk scoring.

mysecutec ivs threats [flags]

Flags

Flag	Type	Default	Description
--limit	int	20	Number of results
--offset	int	0	Result offset
--search	string		Search query

API

GET /threat/v1/dashboard/ivs/threats?limit=20&offset=0

Query Parameters:

Parameter	Type	Description
limit	int	Max results
offset	int	Skip results
search	string	Search query

Request Example

mysecutec ivs threats --limit 50

GET /threat/v1/dashboard/ivs/threats?limit=50&offset=0
Authorization: Bearer <token>
Accept: application/json

Response

{
  "data": {
    "items": [
      {
        "id": "threat-uuid-456",
        "name": "Outdated TLS configuration",
        "created_at": "2025-05-10T08:00:00Z",
        "updated_at": "2025-06-15T12:30:00Z",
        "status": "open",
        "risk": {
          "score": 7.5,
          "severity": "high"
        }
      }
    ]
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 48
  }
}

Model: IVSThreatEntry

Field	Type	Description
id	string	Threat ID
name	string	Threat name
created_at	timestamp	Creation timestamp
updated_at	timestamp	Last update timestamp
status	string	Threat status
risk	IVSThreatRisk	Risk scoring

Model: IVSThreatRisk

Field	Type	Description
score	number	Risk score
severity	string	Risk severity