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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
|
"""NextDNS constants."""
from aiohttp import ClientTimeout
from .model import (
ApiNames,
ParentalControlCategories,
ParentalControlCategoriesAttrs,
ParentalControlServices,
ParentalControlServicesAttrs,
SettingDescription,
)
API_ENDPOINT = "https://api.nextdns.io"
ATTR_ANALYTICS = "analytics"
ATTR_CLEAR_LOGS = "clear_logs"
ATTR_ENABLED = "enabled"
ATTR_GET_LOGS = "get_logs"
ATTR_PARENTAL_CONTROL = "parental_control"
ATTR_PARENTAL_CONTROL_CATEGORIES = "parental_control_categories"
ATTR_PARENTAL_CONTROL_CATEGORY = "parental_control_category"
ATTR_PARENTAL_CONTROL_SERVICE = "parental_control_service"
ATTR_PARENTAL_CONTROL_SERVICES = "parental_control_services"
ATTR_PERFORMANCE = "performance"
ATTR_PRIVACY = "privacy"
ATTR_PROFILE = "profile"
ATTR_PROFILES = "profiles"
ATTR_SECURITY = "security"
ATTR_SECURITY = "security"
ATTR_SETTINGS = "settings"
ATTR_TEST = "test"
ATTR_ANONYMIZED_ECS = "anonymized_ecs"
ATTR_BLOCK_PAGE = "block_page"
ATTR_CACHE_BOOST = "cache_boost"
ATTR_CNAME_FLATTENING = "cname_flattening"
ATTR_LOGS = "logs"
ATTR_LOGS_LOCATION = "logs_location"
ATTR_LOGS_RETENTION = "logs_retention"
ATTR_RETENTION = "retention"
ATTR_LOCATION = "location"
ATTR_WEB3 = "web3"
ATTR_ALLOW_AFFILIATE = "allow_affiliate"
ATTR_BLOCK_DISGUISED_TRACKERS = "block_disguised_trackers"
ATTR_AI_THREAT_DETECTION = "ai_threat_detection"
ATTR_BLOCK_CSAM = "block_csam"
ATTR_BLOCK_DDNS = "block_ddns"
ATTR_BLOCK_NRD = "block_nrd"
ATTR_BLOCK_PARKED_DOMAINS = "block_parked_domains"
ATTR_CRYPTOJACKING_PROTECTION = "cryptojacking_protection"
ATTR_DGA_PROTECTION = "dga_protection"
ATTR_DNS_REBINDING_PROTECTION = "dns_rebinding_protection"
ATTR_GOOGLE_SAFE_BROWSING = "google_safe_browsing"
ATTR_IDN_HOMOGRAPH_ATTACKS_PROTECTION = "idn_homograph_attacks_protection"
ATTR_THREAT_INTELLIGENCE_FEEDS = "threat_intelligence_feeds"
ATTR_TYPOSQUATTING_PROTECTION = "typosquatting_protection"
ATTR_BLOCK_BYPASS_METHODS = "block_bypass_methods"
ATTR_SAFESEARCH = "safesearch"
ATTR_YOUTUBE_RESTRICTED_MODE = "youtube_restricted_mode"
PARENTAL_CONTROL_CATEGORIES = tuple(item for item in ParentalControlCategoriesAttrs)
PARENTAL_CONTROL_SERVICES = tuple(item for item in ParentalControlServicesAttrs)
ENDPOINTS = {
ATTR_ANALYTICS: "https://api.nextdns.io/profiles/{profile_id}/analytics/{type}",
ATTR_CLEAR_LOGS: "https://api.nextdns.io/profiles/{profile_id}/logs",
ATTR_GET_LOGS: "https://api.nextdns.io/profiles/{profile_id}/logs/download",
ATTR_PROFILE: "https://api.nextdns.io/profiles/{profile_id}",
ATTR_PROFILES: "https://api.nextdns.io/profiles",
ATTR_TEST: "https://{profile_id}.test.nextdns.io",
ATTR_SECURITY: "https://api.nextdns.io/profiles/{profile_id}/security",
ATTR_SETTINGS: "https://api.nextdns.io/profiles/{profile_id}/settings",
ATTR_PERFORMANCE: "https://api.nextdns.io/profiles/{profile_id}/settings/performance",
ATTR_PRIVACY: "https://api.nextdns.io/profiles/{profile_id}/privacy",
ATTR_PARENTAL_CONTROL: "https://api.nextdns.io/profiles/{profile_id}/parentalControl",
ATTR_PARENTAL_CONTROL_CATEGORY: "https://api.nextdns.io/profiles/{profile_id}/parentalControl/categories/{category}",
ATTR_PARENTAL_CONTROL_CATEGORIES: "https://api.nextdns.io/profiles/{profile_id}/parentalControl/categories",
ATTR_PARENTAL_CONTROL_SERVICE: "https://api.nextdns.io/profiles/{profile_id}/parentalControl/services/{service}",
ATTR_PARENTAL_CONTROL_SERVICES: "https://api.nextdns.io/profiles/{profile_id}/parentalControl/services",
ATTR_LOGS: "https://api.nextdns.io/profiles/{profile_id}/settings/logs",
ATTR_LOGS_LOCATION: "https://api.nextdns.io/profiles/{profile_id}/settings/logs/location",
ATTR_LOGS_RETENTION: "https://api.nextdns.io/profiles/{profile_id}/settings/logs/retention",
ATTR_BLOCK_PAGE: "https://api.nextdns.io/profiles/{profile_id}/settings/blockPage",
}
MAP_DNSSEC = {False: "not_validated_queries", True: "validated_queries"}
MAP_ENCRYPTED = {False: "unencrypted_queries", True: "encrypted_queries"}
MAP_IP_VERSIONS = {4: "ipv4_queries", 6: "ipv6_queries"}
MAP_PROFILE = {"parentalControl": "parental_control"}
MAP_PROTOCOLS = {
"DNS-over-HTTPS": "doh_queries",
"DNS-over-HTTP/3": "doh3_queries",
"DNS-over-QUIC": "doq_queries",
"DNS-over-TLS": "dot_queries",
"TCP": "tcp_queries",
"UDP": "udp_queries",
}
MAP_STATUS = {
"allowed": "allowed_queries",
"blocked": "blocked_queries",
"default": "default_queries",
"relayed": "relayed_queries",
}
MAP_SETTING = {
ATTR_BLOCK_PAGE: SettingDescription(ENDPOINTS[ATTR_BLOCK_PAGE], ATTR_ENABLED),
ATTR_CACHE_BOOST: SettingDescription(
ENDPOINTS[ATTR_PERFORMANCE], ApiNames.CACHE_BOOST
),
ATTR_CNAME_FLATTENING: SettingDescription(
ENDPOINTS[ATTR_PERFORMANCE], ApiNames.CNAME_FLATTENING
),
ATTR_ANONYMIZED_ECS: SettingDescription(ENDPOINTS[ATTR_PERFORMANCE], ApiNames.ECS),
ATTR_WEB3: SettingDescription(ENDPOINTS[ATTR_SETTINGS], ATTR_WEB3),
ATTR_LOGS: SettingDescription(ENDPOINTS[ATTR_LOGS], ATTR_ENABLED),
ATTR_LOGS_LOCATION: SettingDescription(ENDPOINTS[ATTR_LOGS], ATTR_LOCATION),
ATTR_LOGS_RETENTION: SettingDescription(ENDPOINTS[ATTR_LOGS], ATTR_RETENTION),
ATTR_ALLOW_AFFILIATE: SettingDescription(
ENDPOINTS[ATTR_PRIVACY], ApiNames.ALLOW_AFFILIATE
),
ATTR_BLOCK_DISGUISED_TRACKERS: SettingDescription(
ENDPOINTS[ATTR_PRIVACY], ApiNames.DISGUISED_TRACKERS
),
ATTR_AI_THREAT_DETECTION: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.AI_THREAT_TETECTION
),
ATTR_BLOCK_CSAM: SettingDescription(ENDPOINTS[ATTR_SECURITY], ApiNames.CSAM),
ATTR_BLOCK_DDNS: SettingDescription(ENDPOINTS[ATTR_SECURITY], ApiNames.DDNS),
ATTR_BLOCK_NRD: SettingDescription(ENDPOINTS[ATTR_SECURITY], ApiNames.NRD),
ATTR_BLOCK_PARKED_DOMAINS: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.PARKING
),
ATTR_CRYPTOJACKING_PROTECTION: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.CRYPTOJACKING
),
ATTR_DGA_PROTECTION: SettingDescription(ENDPOINTS[ATTR_SECURITY], ApiNames.DGA),
ATTR_DNS_REBINDING_PROTECTION: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.DNS_REBINDING
),
ATTR_GOOGLE_SAFE_BROWSING: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.GOOGLE_SAFE_BROWSING
),
ATTR_IDN_HOMOGRAPH_ATTACKS_PROTECTION: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.IDN_HOMOGRAPHS
),
ATTR_THREAT_INTELLIGENCE_FEEDS: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.THREAT_INTELLIGENCE_FEEDS
),
ATTR_TYPOSQUATTING_PROTECTION: SettingDescription(
ENDPOINTS[ATTR_SECURITY], ApiNames.TYPOSQUATTING
),
ATTR_BLOCK_BYPASS_METHODS: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL], ApiNames.BLOCK_BYPASS
),
ATTR_SAFESEARCH: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL], ApiNames.SAFESEARCH
),
ATTR_YOUTUBE_RESTRICTED_MODE: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL], ApiNames.YOUTUBE_RESTRICTED_MODE
),
ParentalControlServicesAttrs.BLOCK_TIKTOK: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.TIKTOK
),
ParentalControlServicesAttrs.BLOCK_TINDER: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.TINDER
),
ParentalControlServicesAttrs.BLOCK_FACEBOOK: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.FACEBOOK
),
ParentalControlServicesAttrs.BLOCK_SNAPCHAT: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.SNAPCHAT
),
ParentalControlServicesAttrs.BLOCK_INSTAGRAM: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.INSTAGRAM
),
ParentalControlServicesAttrs.BLOCK_FORTNITE: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.FORTNITE
),
ParentalControlServicesAttrs.BLOCK_MESSENGER: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.MESSENGER
),
ParentalControlServicesAttrs.BLOCK_LEAGUEOFLEGENDS: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE],
ParentalControlServices.LEAGUEOFLEGENDS,
),
ParentalControlServicesAttrs.BLOCK_VK: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.VK
),
ParentalControlServicesAttrs.BLOCK_9GAG: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.NINEGAG
),
ParentalControlServicesAttrs.BLOCK_TUMBLR: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.TUMBLR
),
ParentalControlServicesAttrs.BLOCK_ROBLOX: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.ROBLOX
),
ParentalControlServicesAttrs.BLOCK_TWITCH: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.TWITCH
),
ParentalControlServicesAttrs.BLOCK_MINECRAFT: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.MINECRAFT
),
ParentalControlServicesAttrs.BLOCK_TWITTER: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.TWITTER
),
ParentalControlServicesAttrs.BLOCK_DISCORD: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.DISCORD
),
ParentalControlServicesAttrs.BLOCK_DAILYMOTION: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.DAILYMOTION
),
ParentalControlServicesAttrs.BLOCK_PINTEREST: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.PINTEREST
),
ParentalControlServicesAttrs.BLOCK_YOUTUBE: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.YOUTUBE
),
ParentalControlServicesAttrs.BLOCK_STEAM: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.STEAM
),
ParentalControlServicesAttrs.BLOCK_HULU: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.HULU
),
ParentalControlServicesAttrs.BLOCK_WHATSAPP: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.WHATSAPP
),
ParentalControlServicesAttrs.BLOCK_REDDIT: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.REDDIT
),
ParentalControlServicesAttrs.BLOCK_BLIZZARD: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.BLIZZARD
),
ParentalControlServicesAttrs.BLOCK_NETFLIX: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.NETFLIX
),
ParentalControlServicesAttrs.BLOCK_IMGUR: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.IMGUR
),
ParentalControlServicesAttrs.BLOCK_TELEGRAM: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.TELEGRAM
),
ParentalControlServicesAttrs.BLOCK_DISNEYPLUS: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.DISNEYPLUS
),
ParentalControlServicesAttrs.BLOCK_VIMEO: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.VIMEO
),
ParentalControlServicesAttrs.BLOCK_SKYPE: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE],
ParentalControlServices.SKYPE,
),
ParentalControlServicesAttrs.BLOCK_EBAY: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.EBAY
),
ParentalControlServicesAttrs.BLOCK_SPOTIFY: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.SPOTIFY
),
ParentalControlServicesAttrs.BLOCK_PRIMEVIDEO: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.PRIMEVIDEO
),
ParentalControlServicesAttrs.BLOCK_ZOOM: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.ZOOM
),
ParentalControlServicesAttrs.BLOCK_AMAZON: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.AMAZON
),
ParentalControlServicesAttrs.BLOCK_XBOXLIVE: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.XBOXLIVE
),
ParentalControlServicesAttrs.BLOCK_SIGNAL: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.SIGNAL
),
ParentalControlServicesAttrs.BLOCK_BEREAL: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.BEREAL
),
ParentalControlServicesAttrs.BLOCK_GOOGLE_CHAT: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.GOOGLE_CHAT
),
ParentalControlServicesAttrs.BLOCK_CHATGPT: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.CHATGPT
),
ParentalControlServicesAttrs.BLOCK_HBOMAX: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.HBOMAX
),
ParentalControlServicesAttrs.BLOCK_MASTODON: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE], ParentalControlServices.MASTODON
),
ParentalControlServicesAttrs.BLOCK_PLAYSTATION_NETWORK: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_SERVICE],
ParentalControlServices.PLAYSTATION_NETWORK,
),
ParentalControlCategoriesAttrs.BLOCK_DATING: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_CATEGORY], ParentalControlCategories.DATING
),
ParentalControlCategoriesAttrs.BLOCK_GAMBLING: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_CATEGORY], ParentalControlCategories.GAMBLING
),
ParentalControlCategoriesAttrs.BLOCK_PIRACY: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_CATEGORY], ParentalControlCategories.PIRACY
),
ParentalControlCategoriesAttrs.BLOCK_PORN: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_CATEGORY], ParentalControlCategories.PORN
),
ParentalControlCategoriesAttrs.BLOCK_SOCIAL_NETWORKS: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_CATEGORY],
ParentalControlCategories.SOCIAL_NETWORKS,
),
ParentalControlCategoriesAttrs.BLOCK_VIDEO_STREAMING: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_CATEGORY],
ParentalControlCategories.VIDEO_STREAMING,
),
ParentalControlCategoriesAttrs.BLOCK_ONLINE_GAMING: SettingDescription(
ENDPOINTS[ATTR_PARENTAL_CONTROL_CATEGORY],
ParentalControlCategories.ONLINE_GAMING,
),
}
ALLOWED_LOGS_LOCATION = ("ch", "eu", "gb", "us")
ALLOWED_LOGS_RETENTION = (1, 6, 24, 168, 720, 2160, 4320, 8760, 17520)
TIMEOUT = ClientTimeout(total=5)
STOP_AFTER_ATTEMPT = 3
WAIT_INCREMENT = 2
WAIT_START = 2
HTTP_STATUS_TIMEOUT = 524
|
