From 8857a6cc3785d96847d463bf4793c068a458c679 Mon Sep 17 00:00:00 2001 From: Shreyas Zare Date: Sun, 4 Feb 2024 18:21:28 +0530 Subject: [PATCH] updated apidocs. --- APIDOCS.md | 1311 ++++++++++++++++++++++++++++------------------------ 1 file changed, 710 insertions(+), 601 deletions(-) diff --git a/APIDOCS.md b/APIDOCS.md index 01aab15e..1682dfcd 100644 --- a/APIDOCS.md +++ b/APIDOCS.md @@ -487,86 +487,87 @@ RESPONSE: { "response": { "stats": { - "totalQueries": 1857, - "totalNoError": 1820, - "totalServerFailure": 0, - "totalNxDomain": 37, + "totalQueries": 925, + "totalNoError": 834, + "totalServerFailure": 1, + "totalNxDomain": 90, "totalRefused": 0, - "totalAuthoritative": 1358, - "totalRecursive": 160, - "totalCached": 228, - "totalBlocked": 111, - "totalClients": 831, - "zones": 5, - "cachedEntries": 28, - "allowedZones": 6, - "blockedZones": 10, + "totalAuthoritative": 47, + "totalRecursive": 348, + "totalCached": 481, + "totalBlocked": 49, + "totalDropped": 0, + "totalClients": 6, + "zones": 19, + "cachedEntries": 6330, + "allowedZones": 10, + "blockedZones": 1, "allowListZones": 0, - "blockListZones": 1136182 + "blockListZones": 307447 }, "mainChartData": { - "labelFormat": "HH:mm", + "labelFormat": "HH:mm", "labels": [ - "2022-10-08T11:57:00.0000000Z", - "2022-10-08T11:58:00.0000000Z", - "2022-10-08T11:59:00.0000000Z", - "2022-10-08T12:00:00.0000000Z", - "2022-10-08T12:01:00.0000000Z", - "2022-10-08T12:02:00.0000000Z", - "2022-10-08T12:03:00.0000000Z", - "2022-10-08T12:04:00.0000000Z", - "2022-10-08T12:05:00.0000000Z", - "2022-10-08T12:06:00.0000000Z", - "2022-10-08T12:07:00.0000000Z", - "2022-10-08T12:08:00.0000000Z", - "2022-10-08T12:09:00.0000000Z", - "2022-10-08T12:10:00.0000000Z", - "2022-10-08T12:11:00.0000000Z", - "2022-10-08T12:12:00.0000000Z", - "2022-10-08T12:13:00.0000000Z", - "2022-10-08T12:14:00.0000000Z", - "2022-10-08T12:15:00.0000000Z", - "2022-10-08T12:16:00.0000000Z", - "2022-10-08T12:17:00.0000000Z", - "2022-10-08T12:18:00.0000000Z", - "2022-10-08T12:19:00.0000000Z", - "2022-10-08T12:20:00.0000000Z", - "2022-10-08T12:21:00.0000000Z", - "2022-10-08T12:22:00.0000000Z", - "2022-10-08T12:23:00.0000000Z", - "2022-10-08T12:24:00.0000000Z", - "2022-10-08T12:25:00.0000000Z", - "2022-10-08T12:26:00.0000000Z", - "2022-10-08T12:27:00.0000000Z", - "2022-10-08T12:28:00.0000000Z", - "2022-10-08T12:29:00.0000000Z", - "2022-10-08T12:30:00.0000000Z", - "2022-10-08T12:31:00.0000000Z", - "2022-10-08T12:32:00.0000000Z", - "2022-10-08T12:33:00.0000000Z", - "2022-10-08T12:34:00.0000000Z", - "2022-10-08T12:35:00.0000000Z", - "2022-10-08T12:36:00.0000000Z", - "2022-10-08T12:37:00.0000000Z", - "2022-10-08T12:38:00.0000000Z", - "2022-10-08T12:39:00.0000000Z", - "2022-10-08T12:40:00.0000000Z", - "2022-10-08T12:41:00.0000000Z", - "2022-10-08T12:42:00.0000000Z", - "2022-10-08T12:43:00.0000000Z", - "2022-10-08T12:44:00.0000000Z", - "2022-10-08T12:45:00.0000000Z", - "2022-10-08T12:46:00.0000000Z", - "2022-10-08T12:47:00.0000000Z", - "2022-10-08T12:48:00.0000000Z", - "2022-10-08T12:49:00.0000000Z", - "2022-10-08T12:50:00.0000000Z", - "2022-10-08T12:51:00.0000000Z", - "2022-10-08T12:52:00.0000000Z", - "2022-10-08T12:53:00.0000000Z", - "2022-10-08T12:54:00.0000000Z", - "2022-10-08T12:55:00.0000000Z", - "2022-10-08T12:56:00.0000000Z" + "2024-02-04T10:38:00.0000000Z", + "2024-02-04T10:39:00.0000000Z", + "2024-02-04T10:40:00.0000000Z", + "2024-02-04T10:41:00.0000000Z", + "2024-02-04T10:42:00.0000000Z", + "2024-02-04T10:43:00.0000000Z", + "2024-02-04T10:44:00.0000000Z", + "2024-02-04T10:45:00.0000000Z", + "2024-02-04T10:46:00.0000000Z", + "2024-02-04T10:47:00.0000000Z", + "2024-02-04T10:48:00.0000000Z", + "2024-02-04T10:49:00.0000000Z", + "2024-02-04T10:50:00.0000000Z", + "2024-02-04T10:51:00.0000000Z", + "2024-02-04T10:52:00.0000000Z", + "2024-02-04T10:53:00.0000000Z", + "2024-02-04T10:54:00.0000000Z", + "2024-02-04T10:55:00.0000000Z", + "2024-02-04T10:56:00.0000000Z", + "2024-02-04T10:57:00.0000000Z", + "2024-02-04T10:58:00.0000000Z", + "2024-02-04T10:59:00.0000000Z", + "2024-02-04T11:00:00.0000000Z", + "2024-02-04T11:01:00.0000000Z", + "2024-02-04T11:02:00.0000000Z", + "2024-02-04T11:03:00.0000000Z", + "2024-02-04T11:04:00.0000000Z", + "2024-02-04T11:05:00.0000000Z", + "2024-02-04T11:06:00.0000000Z", + "2024-02-04T11:07:00.0000000Z", + "2024-02-04T11:08:00.0000000Z", + "2024-02-04T11:09:00.0000000Z", + "2024-02-04T11:10:00.0000000Z", + "2024-02-04T11:11:00.0000000Z", + "2024-02-04T11:12:00.0000000Z", + "2024-02-04T11:13:00.0000000Z", + "2024-02-04T11:14:00.0000000Z", + "2024-02-04T11:15:00.0000000Z", + "2024-02-04T11:16:00.0000000Z", + "2024-02-04T11:17:00.0000000Z", + "2024-02-04T11:18:00.0000000Z", + "2024-02-04T11:19:00.0000000Z", + "2024-02-04T11:20:00.0000000Z", + "2024-02-04T11:21:00.0000000Z", + "2024-02-04T11:22:00.0000000Z", + "2024-02-04T11:23:00.0000000Z", + "2024-02-04T11:24:00.0000000Z", + "2024-02-04T11:25:00.0000000Z", + "2024-02-04T11:26:00.0000000Z", + "2024-02-04T11:27:00.0000000Z", + "2024-02-04T11:28:00.0000000Z", + "2024-02-04T11:29:00.0000000Z", + "2024-02-04T11:30:00.0000000Z", + "2024-02-04T11:31:00.0000000Z", + "2024-02-04T11:32:00.0000000Z", + "2024-02-04T11:33:00.0000000Z", + "2024-02-04T11:34:00.0000000Z", + "2024-02-04T11:35:00.0000000Z", + "2024-02-04T11:36:00.0000000Z", + "2024-02-04T11:37:00.0000000Z" ], "datasets": [ { @@ -576,66 +577,66 @@ RESPONSE: "borderWidth": 2, "fill": true, "data": [ - 38, - 55, - 26, - 54, - 38, - 19, - 31, - 19, - 36, - 40, - 18, - 37, - 23, - 30, - 31, - 23, - 17, - 9, - 34, - 55, - 18, + 4, 6, 13, - 38, - 30, - 47, - 31, - 33, - 52, - 44, - 22, - 30, + 9, + 27, + 9, + 11, + 15, + 9, + 10, + 5, + 9, + 5, + 17, + 6, + 9, + 61, 23, + 9, + 21, + 8, + 20, + 5, + 7, + 35, + 26, + 33, + 20, + 7, + 12, + 4, + 14, + 3, 19, 37, - 23, - 27, - 24, - 33, - 34, - 21, - 29, - 39, - 36, - 15, - 63, - 49, - 22, - 27, - 25, - 38, - 34, - 32, - 29, + 10, + 18, + 12, + 7, 30, - 39, + 47, + 16, + 10, + 3, + 12, + 11, + 37, + 3, + 18, 22, - 38, - 24, - 28 + 16, + 6, + 15, + 5, + 41, + 13, + 7, + 9, + 17, + 12 ] }, { @@ -645,66 +646,66 @@ RESPONSE: "borderWidth": 2, "fill": true, "data": [ - 37, - 53, - 24, - 52, - 37, + 4, + 6, + 11, + 9, + 22, + 6, + 11, + 13, + 9, + 7, + 5, + 7, + 4, + 13, + 5, + 7, + 59, + 22, + 8, + 21, + 8, 19, + 5, + 7, 31, + 25, + 24, + 16, + 6, + 12, + 4, + 12, + 3, 19, 36, - 38, - 15, - 35, - 23, - 29, - 31, - 23, - 17, - 9, + 8, + 18, + 12, + 7, + 28, + 46, + 16, + 10, + 3, + 11, + 10, 34, - 53, - 17, - 6, + 2, + 10, 13, - 37, - 30, - 47, - 31, - 33, - 52, - 42, - 21, - 30, - 23, - 19, - 37, - 23, - 27, - 24, - 33, - 32, - 20, - 29, - 39, - 35, + 11, + 6, 15, - 58, - 49, - 22, - 27, - 23, - 37, - 34, - 32, - 29, - 30, - 39, - 22, - 38, - 24, - 26 + 5, + 40, + 12, + 6, + 9, + 14, + 12 ] }, { @@ -754,7 +755,7 @@ RESPONSE: 0, 0, 0, - 0, + 1, 0, 0, 0, @@ -778,71 +779,71 @@ RESPONSE: }, { "label": "NX Domain", - "backgroundColor": "rgba(7, 7, 7, 0.1)", - "borderColor": "rgb(7, 7, 7)", + "backgroundColor": "rgba(120, 120, 120, 0.1)", + "borderColor": "rgb(120, 120, 120)", "borderWidth": 2, "fill": true, "data": [ - 1, - 2, - 2, - 2, - 1, - 0, - 0, 0, 0, 2, + 0, + 5, 3, + 0, 2, 0, + 3, + 0, + 2, + 1, + 4, + 1, + 2, + 2, + 1, + 1, + 0, + 0, 1, 0, 0, + 4, + 1, + 9, + 4, + 1, + 0, + 0, + 2, + 0, + 0, + 1, + 2, 0, 0, 0, 2, - 1, + 0, + 0, 0, 0, 1, - 0, - 0, - 0, - 0, - 0, - 2, 1, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 2, + 3, 1, - 0, - 0, - 1, - 0, + 8, + 9, 5, 0, 0, 0, - 2, + 1, + 1, 1, 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 2 + 3, + 0 ] }, { @@ -921,66 +922,66 @@ RESPONSE: "borderWidth": 2, "fill": true, "data": [ - 23, - 27, - 20, - 29, - 28, - 17, - 19, - 16, - 32, - 35, - 15, - 32, - 17, - 14, - 23, - 20, - 7, - 6, - 17, - 34, - 11, + 0, + 0, + 1, + 0, 3, - 11, - 28, - 12, - 38, - 23, - 29, - 35, - 41, - 18, - 20, - 16, - 10, - 21, - 21, - 22, - 20, - 20, - 24, - 17, - 26, - 28, - 22, - 10, - 46, - 44, - 22, - 15, - 21, - 33, - 28, - 26, - 19, - 24, - 32, - 18, - 34, - 18, - 21 + 1, + 0, + 2, + 1, + 1, + 0, + 1, + 0, + 2, + 1, + 1, + 1, + 1, + 2, + 0, + 0, + 1, + 0, + 0, + 2, + 1, + 3, + 2, + 0, + 0, + 0, + 1, + 0, + 0, + 1, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 1, + 1, + 0, + 4, + 4, + 2, + 0, + 2, + 0, + 1, + 1, + 0, + 0, + 0, + 0 ] }, { @@ -990,66 +991,66 @@ RESPONSE: "borderWidth": 2, "fill": true, "data": [ - 6, + 1, + 3, + 0, + 1, + 14, + 2, + 8, + 4, + 1, + 3, + 2, + 3, + 1, + 3, + 3, + 3, + 36, 8, 2, - 7, - 2, - 1, - 2, - 1, - 1, - 2, - 0, - 3, - 2, + 14, + 4, 6, - 2, - 0, - 3, - 2, - 9, - 3, - 2, 1, - 0, - 3, - 6, + 1, + 26, + 17, + 11, + 10, 2, 4, + 0, + 8, 1, 7, + 18, 0, + 3, 0, - 7, + 2, + 10, + 6, + 1, + 3, 1, 5, - 6, - 0, - 2, - 1, - 3, - 3, - 0, - 1, - 2, - 3, - 1, - 7, - 2, - 0, - 6, - 2, - 2, - 3, - 0, 4, - 2, - 1, + 20, + 0, + 5, + 7, + 0, + 3, + 7, + 0, + 21, + 7, 1, 3, - 0, - 4 + 6, + 5 ] }, { @@ -1059,66 +1060,66 @@ RESPONSE: "borderWidth": 2, "fill": true, "data": [ + 3, + 3, + 11, + 8, + 8, + 4, + 3, + 8, + 7, + 4, + 3, + 4, + 3, + 10, + 2, + 4, + 23, + 14, + 5, + 7, + 4, + 13, + 4, + 6, + 5, + 8, + 13, + 6, + 4, + 8, + 4, + 4, + 2, + 12, + 18, + 8, + 15, + 12, + 5, + 18, + 41, + 15, + 7, + 2, + 6, 6, 14, - 3, - 12, - 6, - 0, - 6, - 1, - 3, - 0, 2, - 1, - 3, - 6, - 3, - 2, - 6, - 1, - 6, - 6, - 2, - 1, - 0, 5, + 6, 10, - 5, 3, - 2, 6, - 1, - 2, - 2, - 4, - 3, + 5, + 19, + 5, + 5, + 6, 8, - 2, - 2, - 2, - 4, - 5, - 2, - 1, - 7, - 8, - 3, - 10, - 2, - 0, - 6, - 1, - 1, - 2, - 5, - 6, - 3, - 5, - 2, - 1, - 5, - 2 + 7 ] }, { @@ -1128,66 +1129,135 @@ RESPONSE: "borderWidth": 2, "fill": true, "data": [ - 3, - 6, + 0, + 0, 1, + 0, + 2, + 2, + 0, + 1, + 0, + 2, + 0, + 1, + 1, + 2, + 0, + 1, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 2, + 0, 6, 2, 1, - 4, + 0, + 0, 1, 0, - 3, - 1, + 0, + 0, 1, + 0, + 0, + 0, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 2, 1, 4, - 3, - 1, - 1, - 0, - 2, - 12, - 3, - 1, - 2, - 2, - 2, - 2, - 1, - 1, + 5, 4, - 2, - 2, - 1, - 2, - 1, - 2, + 0, + 0, + 0, + 0, 0, 1, - 1, - 6, - 2, - 2, - 1, - 2, + 0, 3, - 1, - 0, - 1, + 0 + ] + }, + { + "label": "Dropped", + "backgroundColor": "rgba(30, 30, 30, 0.1)", + "borderColor": "rgb(30, 30, 30)", + "borderWidth": 2, + "fill": true, + "data": [ 0, 0, - 1, - 2, - 1, - 1, 0, - 1, - 1, - 1, 0, - 1, - 1 + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 ] }, { @@ -1197,66 +1267,66 @@ RESPONSE: "borderWidth": 2, "fill": true, "data": [ - 15, - 21, - 13, - 21, - 17, - 15, - 14, - 15, - 22, - 29, - 13, - 21, - 17, - 12, - 18, - 12, - 9, - 6, - 16, - 29, - 11, - 5, - 10, - 26, - 13, - 28, - 20, - 24, - 24, - 31, - 14, - 15, - 12, - 13, - 18, - 15, - 14, - 18, - 15, - 22, - 13, - 18, - 21, - 14, - 11, - 28, - 32, - 18, - 14, - 13, - 22, - 18, - 16, - 15, - 18, - 20, - 13, - 26, - 15, - 17 + 3, + 4, + 3, + 2, + 3, + 4, + 2, + 3, + 3, + 2, + 2, + 3, + 3, + 3, + 2, + 4, + 3, + 2, + 2, + 2, + 2, + 2, + 2, + 2, + 3, + 2, + 3, + 3, + 2, + 2, + 2, + 3, + 2, + 2, + 3, + 3, + 1, + 3, + 3, + 3, + 3, + 3, + 3, + 2, + 3, + 3, + 4, + 2, + 3, + 4, + 4, + 2, + 4, + 3, + 3, + 3, + 3, + 2, + 2, + 3 ] } ] @@ -1266,21 +1336,24 @@ RESPONSE: "Authoritative", "Recursive", "Cached", - "Blocked" + "Blocked", + "Dropped" ], "datasets": [ { "data": [ - 1358, - 160, - 228, - 111 + 47, + 348, + 481, + 49, + 0 ], "backgroundColor": [ "rgba(150, 150, 0, 0.5)", "rgba(23, 162, 184, 0.5)", "rgba(111, 84, 153, 0.5)", - "rgba(255, 165, 0, 0.5)" + "rgba(255, 165, 0, 0.5)", + "rgba(7, 7, 7, 0.5)" ] } ] @@ -1288,26 +1361,50 @@ RESPONSE: "queryTypeChartData": { "labels": [ "A", + "HTTPS", "AAAA", - "NS", - "MX", - "Others" + "SOA", + "SRV" ], "datasets": [ { "data": [ - 1430, - 410, - 12, + 683, + 196, + 42, 2, 2 ], "backgroundColor": [ "rgba(102, 153, 255, 0.5)", "rgba(92, 184, 92, 0.5)", + "rgba(7, 7, 7, 0.5)", "rgba(91, 192, 222, 0.5)", + "rgba(150, 150, 0, 0.5)", + "rgba(23, 162, 184, 0.5)", + "rgba(111, 84, 153, 0.5)", "rgba(255, 165, 0, 0.5)", - "rgba(51, 122, 183, 0.5)" + "rgba(51, 122, 183, 0.5)", + "rgba(150, 150, 150, 0.5)" + ] + } + ] + }, + "protocolTypeChartData": { + "labels": [ + "Udp" + ], + "datasets": [ + { + "data": [ + 925 + ], + "backgroundColor": [ + "rgba(111, 84, 153, 0.5)", + "rgba(150, 150, 0, 0.5)", + "rgba(23, 162, 184, 0.5)", + "rgba(255, 165, 0, 0.5)", + "rgba(91, 192, 222, 0.5)" ] } ] @@ -1315,138 +1412,122 @@ RESPONSE: "topClients": [ { "name": "192.168.10.5", - "domain": "server1.local", + "domain": "server1.home", + "hits": 463, + "rateLimited": false + }, + { + "name": "192.168.10.12", + "domain": "vostro1.home", "hits": 236, "rateLimited": false }, { - "name": "192.168.10.4", - "domain": "nas1.local", - "hits": 16, + "name": "192.168.10.13", + "hits": 165, "rateLimited": false }, { - "name": "192.168.10.6", - "domain": "server2.local", - "hits": 14, + "name": "192.168.10.11", + "domain": "shreyas-zare.home", + "hits": 53, "rateLimited": false }, { - "name": "192.168.10.3", - "domain": "nas2.local", - "hits": 12, + "name": "192.168.10.15", + "domain": "android-9c3d70b130d99b94.home", + "hits": 6, "rateLimited": false }, { - "name": "217.31.193.175", - "domain": "condor175.knot-resolver.cz", - "hits": 10, - "rateLimited": false - }, - { - "name": "162.158.180.45", - "hits": 9, - "rateLimited": false - }, - { - "name": "217.31.193.163", - "domain": "gondor-resolver.labs.nic.cz", - "hits": 9, - "rateLimited": false - }, - { - "name": "210.245.24.68", - "hits": 8, - "rateLimited": false - }, - { - "name": "101.91.16.140", - "hits": 8, + "name": "192.168.10.2", + "domain": "pi1.home", + "hits": 2, "rateLimited": false } ], "topDomains": [ { - "name": "ns1.technitium.net", - "hits": 823 + "name": "hses7-vod-cf-ace.cdn.hotstar.com", + "hits": 114 }, { - "name": "download.technitium.com", - "hits": 179 + "name": "bifrost-api.hotstar.com", + "hits": 61 }, { - "name": "go.technitium.com", - "hits": 171 - }, - { - "name": "technitium.com", - "hits": 95 + "name": "edge.microsoft.com", + "hits": 52 }, { "name": "www.google.com", - "hits": 58 + "hits": 34 }, { - "name": "www.wd2go.com", - "hits": 28 + "name": "www.hotstar.com", + "hits": 24 + }, + { + "name": "safebrowsing.googleapis.com", + "hits": 15 + }, + { + "name": "www.bing.com", + "hits": 14 + }, + { + "name": "go.microsoft.com", + "hits": 14 }, { "name": "graph.facebook.com", - "hits": 20 - }, - { - "name": "dnsclient.net", - "hits": 17 - }, - { - "name": "blog.technitium.com", - "hits": 16 - }, - { - "name": "profile.accounts.firefox.com", "hits": 13 + }, + { + "name": "substrate.office.com", + "hits": 11 } ], "topBlockedDomains": [ - { - "name": "ssl.google-analytics.com", - "hits": 27 - }, - { - "name": "www.googleadservices.com", - "hits": 20 - }, - { - "name": "incoming.telemetry.mozilla.org", - "hits": 9 - }, - { - "name": "s.youtube.com", - "hits": 7 - }, { "name": "mobile.pipe.aria.microsoft.com", - "hits": 6 + "hits": 10 }, { "name": "in.api.glance.inmobi.com", + "hits": 9 + }, + { + "name": "in.analytics.glance.inmobi.com", "hits": 6 }, { "name": "app-measurement.com", - "hits": 5 + "hits": 4 }, { - "name": "dc.services.visualstudio.com", - "hits": 3 + "name": "googleads.g.doubleclick.net", + "hits": 4 }, { - "name": "settings.crashlytics.com", - "hits": 3 - }, - { - "name": "register.appsflyer.com", + "name": "analytics.swiggy.com", "hits": 2 + }, + { + "name": "firebase-settings.crashlytics.com", + "hits": 2 + }, + { + "name": "cdn.cookielaw.org", + "hits": 2 + }, + { + "name": "m.urbancompany.com", + "hits": 1 + }, + { + "name": "beacons.gvt2.com", + "hits": 1 } ] }, @@ -2590,9 +2671,10 @@ WHERE: - `type`: The DNS resource record type. Supported record types are [`A`, `AAAA`, `NS`, `CNAME`, `PTR`, `MX`, `TXT`, `SRV`, `DNAME`, `DS`, `SSHFP`, `TLSA`, `SVCB`, `HTTPS`, `URI`, `CAA`] and proprietary types [`ANAME`, `FWD`, `APP`]. Unknown record types are also supported since v11.2. - `ttl` (optional): The DNS resource record TTL value. This is the value in seconds that the DNS resolvers can cache the record for. When not specified the default TTL value from settings will be used. - `overwrite` (optional): This option when set to `true` will overwrite existing resource record set for the selected `type` with the new record. Default value of `false` will add the new record into existing resource record set. +- `comments` (optional): Sets comments for the added resource record. - `ipAddress` (optional): The IP address for adding `A` or `AAAA` record. A special value of `request-ip-address` can be used to set the record with the IP address of the API HTTP request to help with dynamic DNS update applications. This option is required and used only for `A` and `AAAA` records. -- `ptr` (optional): Add a reverse PTR record for the IP address in the `A` or `AAAA` record. This option is used only for `A` and `AAAA` records. -- `createPtrZone` (optional): Create a reverse zone for PTR record. This option is used for `A` and `AAAA` records. +- `ptr` (optional): Set this option to `true` to add a reverse PTR record for the IP address in the `A` or `AAAA` record. This option is used only for `A` and `AAAA` records. +- `createPtrZone` (optional): Set this option to `true` to create a reverse zone for PTR record. This option is used for `A` and `AAAA` records. - `nameServer` (optional): The name server domain name. This option is required for adding `NS` record. - `glue` (optional): This is the glue address for the name server in the `NS` record. This optional parameter is used for adding `NS` record. - `cname` (optional): The CNAME domain name. This option is required for adding `CNAME` record. @@ -3227,10 +3309,11 @@ WHERE: - `newDomain` (optional): The new domain name to be set for the record. To be used to rename sub domain name of the record. - `ttl` (optional): The TTL value of the resource record. Default value of `3600` is used when parameter is missing. - `disable` (optional): Specifies if the record should be disabled. The default value is `false` when this parameter is missing. +- `comments` (optional): Sets comments for the updated resource record. - `ipAddress` (optional): The current IP address in the `A` or `AAAA` record. This parameter is required when updating `A` or `AAAA` record. - `newIpAddress` (optional): The new IP address in the `A` or `AAAA` record. This parameter when missing will use the current value in the record. -- `ptr` (optional): Specifies if the PTR record associated with the `A` or `AAAA` record must also be updated. This option is used only for `A` and `AAAA` records. -- `createPtrZone` (optional): Create a reverse zone for PTR record. This option is used only for `A` and `AAAA` records. +- `ptr` (optional): Set this option to `true` to specify if the PTR record associated with the `A` or `AAAA` record must also be updated. This option is used only for `A` and `AAAA` records. +- `createPtrZone` (optional): Set this option to `true` to create a reverse zone for PTR record. This option is used only for `A` and `AAAA` records. - `nameServer` (optional): The current name server domain name. This option is required for updating `NS` record. - `newNameServer` (optional): The new server domain name. This option is used for updating `NS` record. - `glue` (optional): The comma separated list of IP addresses set as glue for the NS record. This parameter is used only when updating `NS` record. @@ -4341,16 +4424,23 @@ RESPONSE: ``` { "response": { - "version": "11.5", - "uptimestamp": "2023-07-29T08:01:31.1117463Z", - "dnsServerDomain": "server1", + "version": "12.0", + "uptimestamp": "2024-01-31T13:29:59.0830176Z", + "dnsServerDomain": "pi2.home", "dnsServerLocalEndPoints": [ "0.0.0.0:53", "[::]:53" ], + "dnsServerIPv4SourceAddresses": [ + "0.0.0.0" + ], + "dnsServerIPv6SourceAddresses": [ + "::" + ], "defaultRecordTtl": 3600, "useSoaSerialDateScheme": false, "zoneTransferAllowedNetworks": [], + "notifyAllowedNetworks": [], "dnsAppsEnableAutomaticUpdate": true, "preferIPv6": false, "udpPayloadSize": 1232, @@ -4363,7 +4453,8 @@ RESPONSE: "qpmLimitSampleMinutes": 5, "qpmLimitIPv4PrefixLength": 24, "qpmLimitIPv6PrefixLength": 56, - "clientTimeout": 4000, + "qpmLimitBypassList": [], + "clientTimeout": 2000, "tcpSendTimeout": 10000, "tcpReceiveTimeout": 10000, "quicIdleTimeout": 60000, @@ -4373,28 +4464,34 @@ RESPONSE: "[::]" ], "webServiceHttpPort": 5380, - "webServiceEnableTls": false, - "webServiceEnableHttp3": false, - "webServiceHttpToTlsRedirect": false, - "webServiceUseSelfSignedTlsCertificate": false, + "webServiceEnableTls": true, + "webServiceEnableHttp3": true, + "webServiceHttpToTlsRedirect": true, + "webServiceUseSelfSignedTlsCertificate": true, "webServiceTlsPort": 53443, "webServiceTlsCertificatePath": null, "webServiceTlsCertificatePassword": "************", "enableDnsOverUdpProxy": false, "enableDnsOverTcpProxy": false, "enableDnsOverHttp": true, - "enableDnsOverTls": true, - "enableDnsOverHttps": true, + "enableDnsOverTls": false, + "enableDnsOverHttps": false, "enableDnsOverQuic": false, "dnsOverUdpProxyPort": 538, "dnsOverTcpProxyPort": 538, - "dnsOverHttpPort": 8053, + "dnsOverHttpPort": 80, "dnsOverTlsPort": 853, "dnsOverHttpsPort": 443, "dnsOverQuicPort": 853, - "dnsTlsCertificatePath": "z:\\ns2.technitium.com.pfx", + "dnsTlsCertificatePath": null, "dnsTlsCertificatePassword": "************", - "tsigKeys": [], + "tsigKeys": [ + { + "keyName": "home", + "sharedSecret": "E9crgbHbzgEI+e+/pBmARRif70ScKf2sc/FjrgnCWyc=", + "algorithmName": "hmac-sha256" + } + ], "recursion": "AllowOnlyForPrivateNetworks", "recursionDeniedNetworks": [], "recursionAllowedNetworks": [], @@ -4404,14 +4501,14 @@ RESPONSE: "resolverRetries": 2, "resolverTimeout": 2000, "resolverMaxStackCount": 16, - "saveCache": false, + "saveCache": true, "serveStale": true, "serveStaleTtl": 259200, "cacheMaximumEntries": 10000, "cacheMinimumRecordTtl": 10, "cacheMaximumRecordTtl": 604800, "cacheNegativeRecordTtl": 300, - "cacheFailureRecordTtl": 60, + "cacheFailureRecordTtl": 10, "cachePrefetchEligibility": 2, "cachePrefetchTrigger": 9, "cachePrefetchSampleIntervalInMinutes": 5, @@ -4419,10 +4516,16 @@ RESPONSE: "enableBlocking": true, "allowTxtBlockingReport": true, "blockingBypassList": [], - "blockingType": "AnyAddress", - "customBlockingAddresses": [], - "blockListUrls": null, + "blockingType": "NxDomain", + "customBlockingAddresses": [ + "127.0.0.1" + ], + "blockListUrls": [ + "https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts", + "https://big.oisd.nl/" + ], "blockListUpdateIntervalHours": 24, + "blockListNextUpdatedOn": "2024-02-01T20:15:08.658124Z", "proxy": null, "forwarders": null, "forwarderProtocol": "Udp", @@ -4431,11 +4534,12 @@ RESPONSE: "forwarderConcurrency": 2, "enableLogging": true, "ignoreResolverLogs": false, - "logQueries": false, + "logQueries": true, "useLocalTime": false, "logFolder": "logs", - "maxLogFileDays": 0, - "maxStatFileDays": 0 + "maxLogFileDays": 30, + "enableInMemoryStats": false, + "maxStatFileDays": 365 }, "status": "ok" } @@ -4458,9 +4562,12 @@ WHERE: - `token`: The session token generated by the `login` or the `createToken` call. - `dnsServerDomain` (optional): The primary domain name used by this DNS Server to identify itself. - `dnsServerLocalEndPoints` (optional): Local end points are the network interface IP addresses and ports you want the DNS Server to listen for requests. +- `dnsServerIPv4SourceAddresses` (optional): A comma separated list of IPv4 source addresses that the DNS server must use for making all outbound DNS requests when the server is connected to two or more networks. Network addresses are also accepted. By default, the IPv4 address of the network with a default route will be used as the source address. +- `dnsServerIPv6SourceAddresses` (optional): A comma separated list of IPv6 source addresses that the DNS server must use for making all outbound DNS requests when the server is connected to two or more networks. Network addresses are also accepted. By default, the IPv6 address of the network with a default route will be used as the source address. Note that this option will be used only when `Prefer IPv6` option is enabled. - `defaultRecordTtl` (optional): The default TTL value to use if not specified when adding or updating records in a Zone. - `useSoaSerialDateScheme` (optional): The default SOA Serial option to use if not specified when adding a Primary Zone. - `zoneTransferAllowedNetworks` (optional): A comma separated list of IP addresses or network addresses that are allowed to perform zone transfer for all zones without any TSIG authentication. +- `notifyAllowedNetworks` (optional): A comma separated list of IP addresses or network addresses that are allowed to Notify all secondary zones. - `dnsAppsEnableAutomaticUpdate` (optional): Set to `true` to allow DNS server to automatically update the DNS Apps from the DNS App Store. The DNS Server will check for updates every 24 hrs when this option is enabled. - `preferIPv6` (optional): DNS Server will use IPv6 for querying whenever possible with this option enabled. Initial value is `false`. - `udpPayloadSize` (optional): The maximum EDNS UDP payload size that can be used to avoid IP fragmentation. Valid range is 512-4096 bytes. Initial value is `1232`. @@ -4473,6 +4580,7 @@ WHERE: - `qpmLimitSampleMinutes` (optional): Sets the client query stats sample size in minutes for QPM limit feature. Initial value is `5`. - `qpmLimitIPv4PrefixLength` (optional): Sets the client subnet IPv4 prefix length used to define the subnet. Initial value is `24`. - `qpmLimitIPv6PrefixLength` (optional): Sets the client subnet IPv6 prefix length used to define the subnet. Initial value is `56`. +- `qpmLimitBypassList` (optional): A comma separated list of IP addresses or network addresses that are allowed to bypass the QPM limit. - `clientTimeout` (optional): The amount of time the DNS server must wait in milliseconds before responding with a ServerFailure response to a client request when no answer is available. Valid range is `1000`-`10000`. Initial value is `4000`. - `tcpSendTimeout` (optional): The amount of time in milliseconds a TCP socket must wait for an ACK before closing the connection. This option will apply for DNS requests being received by the DNS Server over TCP, TLS, or HTTPS transports. Valid range is `1000`-`90000`. Initial value is `10000`. - `tcpReceiveTimeout` (optional): The amount of time in milliseconds a TCP socket must wait for data before closing the connection. This option will apply for DNS requests being received by the DNS Server over TCP, TLS, or HTTPS transports. Valid range is `1000`-`90000`. Initial value is `10000`. @@ -4547,6 +4655,7 @@ WHERE: - `useLocalTime` (optional): Enable this option to use local time instead of UTC for logging. Initial value is `false`. - `logFolder` (optional): The folder path on the server where the log files should be saved. The path can be relative to the DNS server config folder. Initial value is `logs`. - `maxLogFileDays` (optional): Max number of days to keep the log files. Log files older than the specified number of days will be deleted automatically. Recommended value is `365`. Set `0` to disable auto delete. +- `enableInMemoryStats` (optional): Set this option to `true` to enable in-memory stats. When enabled, only Last Hour data will be available on Dashboard and no stats data will be stored on disk. - `maxStatFileDays` (optional): Max number of days to keep the dashboard stats. Stat files older than the specified number of days will be deleted automatically. Recommended value is `365`. Set `0` to disable auto delete. RESPONSE: