Skip to content

SDNS - Secure DNS

Monitor DNS security with query analytics, blocked domain tracking, and trend data.

Commands

sdns kpis

Display Secure DNS general KPIs including category breakdown of blocked queries.

1
mysecutec sdns kpis [flags]

Flags

Flag Type Default Description
--last-n-days int 30 Number of days to look back

API

1
GET /sdns/v1/dashboard/general-kpis?last_n_days=30

Request Example

1
mysecutec sdns kpis --last-n-days 7

1
2
3
GET /sdns/v1/dashboard/general-kpis?last_n_days=7
Authorization: Bearer <token>
Accept: application/json

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
  "data": {
    "last_n_days": 7,
    "date_from": "2025-06-08",
    "date_to": "2025-06-15",
    "total": 1250,
    "recent": 180,
    "items": [
      { "category": "Malware", "total": 450, "recent": 65 },
      { "category": "Phishing", "total": 320, "recent": 48 },
      { "category": "Botnet", "total": 200, "recent": 30 },
      { "category": "Cryptomining", "total": 150, "recent": 22 },
      { "category": "Spam", "total": 130, "recent": 15 }
    ]
  }
}

Model: SDNSGeneralKPIs

Field Type Description
data SDNSGeneralKPIsData KPI data

Model: SDNSGeneralKPIsData

Field Type Description
last_n_days int Lookback period
date_from string Start date
date_to string End date
total int Total blocked queries
recent int Recent blocked queries
items []SDNSKPICategory Category breakdown

Model: SDNSKPICategory

Field Type Description
category string Security category name
total int Total count
recent int Recent count

sdns top-queries

View the top blocked DNS queries/domains.

1
mysecutec sdns top-queries [flags]

Flags

Flag Type Default Description
--last-n-days int 30 Number of days to look back

API

1
GET /sdns/v1/dashboard/top-queries?last_n_days=30

Request Example

1
mysecutec sdns top-queries --last-n-days 14

1
2
3
GET /sdns/v1/dashboard/top-queries?last_n_days=14
Authorization: Bearer <token>
Accept: application/json

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "data": {
    "date_from": "2025-06-01",
    "date_to": "2025-06-15",
    "items": [
      {
        "fqdn": "malware.example.com",
        "total": 250,
        "sites": [
          { "site": "Office-Main", "total": 150 },
          { "site": "Office-Branch", "total": 100 }
        ]
      },
      {
        "fqdn": "phishing.example.net",
        "total": 120,
        "sites": [
          { "site": "Office-Main", "total": 120 }
        ]
      }
    ]
  }
}

Model: SDNSTopQueries

Field Type Description
data object Top queries data
data.date_from string Start date
data.date_to string End date
data.items []SDNSTopQuery Top query entries

Model: SDNSTopQuery

Field Type Description
fqdn string Fully qualified domain name
total int Total block count
sites []SDNSTopSite Site breakdown

Model: SDNSTopSite

Field Type Description
site string Site name
total int Count at this site

sdns queries

List individual blocked DNS queries with details.

1
mysecutec sdns queries [flags]

Flags

Flag Type Default Description
--limit int 20 Maximum number of results
--offset int 0 Number of results to skip
--search string Search filter
--last-n-days int 30 Number of days to look back

API

1
GET /sdns/v1/dashboard/queries?limit=20&offset=0&last_n_days=30

Request Example

1
mysecutec sdns queries --limit 5 --search "malware"

1
2
3
GET /sdns/v1/dashboard/queries?limit=5&offset=0&search=malware&last_n_days=30
Authorization: Bearer <token>
Accept: application/json

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 42,
    "unfiltered_total": 1250
  },
  "data": {
    "date_from": "2025-05-16",
    "date_to": "2025-06-15",
    "items": [
      {
        "id": "query-uuid-123",
        "blocked_at": "2025-06-15T14:30:00Z",
        "security_category": "Malware",
        "site": "Office-Main",
        "fqdn_info": {
          "fqdn": "malware.example.com",
          "categories": ["Malware", "Command and Control"],
          "reputation": -85
        },
        "source_device_names": ["DESKTOP-ABC123", "LAPTOP-XYZ789"],
        "public_ips": ["203.0.113.50"],
        "internal_ips": ["192.168.1.100"]
      }
    ]
  }
}

Model: SDNSQuery

Field Type Description
id string Query ID
blocked_at timestamp When the query was blocked
security_category string Security category
site string Site name
fqdn_info SDNSFqdnInfo FQDN details
source_device_names []string Source device names
public_ips []string Public IP addresses
internal_ips []string Internal IP addresses

Model: SDNSFqdnInfo

Field Type Description
fqdn string Fully qualified domain name
categories []string Security categories
reputation int Reputation score

sdns agents

List Secure DNS agents.

1
mysecutec sdns agents [flags]

Flags

Flag Type Default Description
--limit int 20 Maximum number of results
--offset int 0 Number of results to skip
--search string Search filter

API

1
GET /sdns/v1/dashboard/agents?limit=20&offset=0

Request Example

1
mysecutec sdns agents --limit 50 --search laptop

1
2
3
GET /sdns/v1/dashboard/agents?limit=50&offset=0&search=laptop
Authorization: Bearer <token>
Accept: application/json

sdns sites

List Secure DNS sites.

1
mysecutec sdns sites [flags]

Flags

Flag Type Default Description
--limit int 20 Maximum number of results
--offset int 0 Number of results to skip
--search string Search filter

API

1
GET /sdns/v1/dashboard/sites?limit=20&offset=0

Request Example

1
mysecutec sdns sites --limit 50

1
2
3
GET /sdns/v1/dashboard/sites?limit=50&offset=0
Authorization: Bearer <token>
Accept: application/json

sdns years

List years that have SDNS data.

1
mysecutec sdns years

API

1
GET /sdns/v1/dashboard/years

Response

1
2
3
4
5
{
  "data": {
    "items": [2024, 2025]
  }
}

sdns year-kpis

View monthly KPI breakdown for a specific year.

1
mysecutec sdns year-kpis --year <year>

Flags

Flag Type Required Description
--year int Yes Year to query

API

1
GET /sdns/v1/dashboard/year-kpis?year=2025

Request Example

1
mysecutec sdns year-kpis --year 2025

1
2
3
GET /sdns/v1/dashboard/year-kpis?year=2025
Authorization: Bearer <token>
Accept: application/json

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
  "data": {
    "year": 2025,
    "items": [
      {
        "category": "Malware",
        "data": [120, 95, 110, 130, 140, 150, 0, 0, 0, 0, 0, 0]
      },
      {
        "category": "Phishing",
        "data": [80, 60, 75, 90, 85, 100, 0, 0, 0, 0, 0, 0]
      }
    ]
  }
}

Model: SDNSYearKPIs

Field Type Description
data.year int The year
data.items []SDNSYearKPIItem Category data per month

Model: SDNSYearKPIItem

Field Type Description
category string Security category
data [12]int Monthly counts (Jan-Dec)