dementor 1.0.0.dev6__tar.gz → 1.0.0.dev8__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of dementor might be problematic. Click here for more details.

Files changed (59) hide show
  1. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/PKG-INFO +1 -1
  2. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/__init__.py +1 -1
  3. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/assets/Dementor.toml +37 -7
  4. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/config/session.py +1 -0
  5. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/config/util.py +23 -1
  6. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/logger.py +56 -9
  7. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/imap.py +5 -5
  8. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/mdns.py +16 -16
  9. dementor-1.0.0.dev8/dementor/protocols/mysql.py +502 -0
  10. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/ntlm.py +5 -22
  11. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/pop3.py +4 -4
  12. dementor-1.0.0.dev8/dementor/protocols/smb.py +604 -0
  13. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/smtp.py +0 -1
  14. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/spnego.py +18 -9
  15. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/servers.py +19 -3
  16. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor.egg-info/PKG-INFO +1 -1
  17. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor.egg-info/SOURCES.txt +4 -1
  18. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/pyproject.toml +1 -1
  19. dementor-1.0.0.dev8/test/test_ssl_client.py +29 -0
  20. dementor-1.0.0.dev8/test/test_ssl_server.py +31 -0
  21. dementor-1.0.0.dev6/dementor/protocols/smb.py +0 -480
  22. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/LICENSE +0 -0
  23. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/README.md +0 -0
  24. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/__main__.py +0 -0
  25. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/assets/banner.txt +0 -0
  26. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/assets/www/error_page.html +0 -0
  27. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/assets/www/wpad.dat +0 -0
  28. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/config/__init__.py +0 -0
  29. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/config/attr.py +0 -0
  30. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/config/toml.py +0 -0
  31. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/database.py +0 -0
  32. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/filters.py +0 -0
  33. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/loader.py +0 -0
  34. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/paths.py +0 -0
  35. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/__init__.py +0 -0
  36. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/ftp.py +0 -0
  37. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/http.py +0 -0
  38. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/kerberos.py +0 -0
  39. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/ldap.py +0 -0
  40. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/llmnr.py +0 -0
  41. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/msrpc/__init__.py +0 -0
  42. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/msrpc/dcom.py +0 -0
  43. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/msrpc/epm.py +0 -0
  44. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/msrpc/rpc.py +0 -0
  45. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/msrpc.py +0 -0
  46. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/mssql.py +0 -0
  47. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/netbios.py +0 -0
  48. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/protocols/quic.py +0 -0
  49. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor/standalone.py +0 -0
  50. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor.egg-info/dependency_links.txt +0 -0
  51. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor.egg-info/entry_points.txt +0 -0
  52. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor.egg-info/requires.txt +0 -0
  53. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/dementor.egg-info/top_level.txt +0 -0
  54. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/docs/README.pypi.md +0 -0
  55. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/setup.cfg +0 -0
  56. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/test/test_dcerpc.py +0 -0
  57. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/test/test_dcom.py +0 -0
  58. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/test/test_epm.py +0 -0
  59. {dementor-1.0.0.dev6 → dementor-1.0.0.dev8}/test/test_mssql_auth.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: dementor
3
- Version: 1.0.0.dev6
3
+ Version: 1.0.0.dev8
4
4
  Summary: LLMNR/NBT-NS/mDNS Poisoner and rogue service provider
5
5
  Author: MatrixEditor
6
6
  Maintainer: MatrixEditor
@@ -18,5 +18,5 @@
18
18
  # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
19
19
  # SOFTWARE.
20
20
 
21
- __version__ = "1.0.0.dev6"
21
+ __version__ = "1.0.0.dev8"
22
22
  __author__ = "MatrixEditor"
@@ -117,6 +117,11 @@ WinRM = true
117
117
 
118
118
  MSSQL = true
119
119
 
120
+ # Enables a simple MySQL server on its configured port. This setting does not
121
+ # require root privileges by default.
122
+
123
+ MySQL = true
124
+
120
125
  # Enables POP3 servers. Requires root privileges by default (depends on port
121
126
  # configuration)
122
127
  # The default value is: true
@@ -227,19 +232,15 @@ AllowedQueryTypes = ["A", "AAAA", "ALL"]
227
232
  # The name that will be used to identify the SMB server when responding to client
228
233
  # queries.
229
234
 
230
- ServerName = "SPOOFED"
235
+ # FQDN = "name.domain.com"
231
236
 
232
237
  # The operating system reported by the SMB server. This helps identify the type
233
238
  # of server responding.
234
239
 
235
240
  # ServerOS = "UNIX"
236
241
 
237
- # The domain that the SMB server is identified as. In many cases, this is "WORKGROUP"
238
- # for local setups.
239
-
240
- ServerDomain = "WORKGROUP"
241
-
242
- # Enables SMB2 protocol support.
242
+ # Enables SMB2 protocol support. Requests made with SMB1 will be upgraded automatically
243
+ # to SMB2.
243
244
 
244
245
  SMB2Support = true
245
246
 
@@ -694,6 +695,35 @@ Port = 110
694
695
  # Key = "/path/to/key"
695
696
 
696
697
 
698
+ # =============================================================================
699
+ # MySQL
700
+ # =============================================================================
701
+ [MySQL]
702
+
703
+ # Port for the MySQL server.
704
+
705
+ Port = 3306
706
+
707
+ # Numeric error code returned to the client.
708
+
709
+ # ErrorCode = 1205
710
+
711
+ # Optional custom error message returned with the error code.
712
+
713
+ # ErrorMessage = "Access Denied"
714
+
715
+ # Specifies the reported version of the MySQL server. This version string is returned
716
+ # in responses and may influence client behavior.
717
+
718
+ ServerVersion = "8.0.42"
719
+
720
+ # TLS configuration is also available and will be applied if TLS is set to true.
721
+
722
+ # TLS = false
723
+ # Cert = /path/to/cert"
724
+ # Key = "/path/to/key"
725
+
726
+
697
727
  # =============================================================================
698
728
  # Logging
699
729
  # =============================================================================
@@ -53,6 +53,7 @@ class SessionConfig(TomlConfig):
53
53
  "SSRP",
54
54
  "IMAP",
55
55
  "POP3",
56
+ "MySQL",
56
57
  )
57
58
  ]
58
59
 
@@ -19,6 +19,7 @@
19
19
  # SOFTWARE.
20
20
  import random
21
21
  import string
22
+ import secrets
22
23
 
23
24
  from typing import Any
24
25
  from jinja2.sandbox import SandboxedEnvironment
@@ -50,6 +51,28 @@ def is_true(value: str) -> bool:
50
51
  return str(value).lower() in ("true", "1", "on", "yes")
51
52
 
52
53
 
54
+ class BytesValue:
55
+ def __init__(self, length=None) -> None:
56
+ self.length = length
57
+
58
+ def __call__(self, value) -> Any:
59
+ match value:
60
+ case None:
61
+ return secrets.token_bytes(self.length or 1)
62
+
63
+ case str():
64
+ try:
65
+ return bytes.fromhex(value)
66
+ except ValueError:
67
+ return value.encode()
68
+
69
+ case bytes():
70
+ return value
71
+
72
+ case _:
73
+ return str(value).encode()
74
+
75
+
53
76
  def random_value(size: int) -> str:
54
77
  return "".join(random.choice(string.ascii_letters) for _ in range(size))
55
78
 
@@ -61,5 +84,4 @@ def format_string(value: str) -> str:
61
84
  return template.render(config=config, random=random_value)
62
85
  except Exception as e:
63
86
  # TODO: log that
64
- print(e)
65
87
  return value
@@ -73,6 +73,7 @@ def init():
73
73
  markup=False,
74
74
  keywords=[],
75
75
  omit_repeated_times=False,
76
+ # show_path=False,
76
77
  )
77
78
  # should be disabled
78
79
  handler.highlighter = None
@@ -113,21 +114,67 @@ class ProtocolLogger(logging.LoggerAdapter):
113
114
  def __init__(self, extra=None) -> None:
114
115
  super().__init__(logging.getLogger("dementor"), extra or {})
115
116
 
117
+ def _get_extra(self, name: str, extra=None, default=None):
118
+ value = (self.extra or {}).get(name, default)
119
+ return extra.pop(name, value) if extra else value
120
+
121
+ def get_protocol_name(self, extra=None) -> str:
122
+ return str(self._get_extra("protocol", extra, ""))
123
+
124
+ def get_protocol_color(self, extra=None) -> str:
125
+ return str(self._get_extra("protocol_color", extra, "white"))
126
+
127
+ def get_host(self, extra=None) -> str:
128
+ return str(self._get_extra("host", extra, ""))
129
+
130
+ def get_port(self, extra=None) -> str:
131
+ return str(self._get_extra("port", extra, ""))
132
+
116
133
  def format(self, msg, *args, **kwargs):
117
134
  if self.extra is None:
118
135
  return f"{msg}", kwargs
119
136
 
120
- module_name = self.extra.get("protocol", self.extra.get("module_name", None))
121
- host = self.extra.get("host", kwargs.pop("host", "<no-host>"))
122
- port = self.extra.get("port", kwargs.pop("port", "<no-port>"))
123
- module_color = self.extra.get(
124
- "protocol_color", self.extra.get("module_color", "cyan")
125
- )
137
+ mod = self.get_protocol_name(kwargs)
138
+ host = self.get_host(kwargs) or "<no-host>"
139
+ port = self.get_port(kwargs) or "<no-port>"
140
+ color = self.get_protocol_color(kwargs)
126
141
  return (
127
- f"[bold {module_color}]{module_name:<10}[/] {host:<25} {port:<6} {msg}",
142
+ f"[bold {color}]{mod:<10}[/] {host:<25} {port:<6} {msg}",
128
143
  kwargs,
129
144
  )
130
145
 
146
+ def format_inline(self, msg, kwargs):
147
+ mod = self.get_protocol_name(kwargs)
148
+ host = self.get_host(kwargs)
149
+ port = self.get_port(kwargs) or "-"
150
+ is_server = kwargs.pop("is_server", False)
151
+ is_client = kwargs.pop("is_client", False)
152
+ line = msg
153
+
154
+ if is_client:
155
+ line = f"C: {line}"
156
+ elif is_server:
157
+ line = f"S: {line}"
158
+
159
+ if host:
160
+ line = f"({host}:{port}) {line}"
161
+
162
+ if mod:
163
+ line = f"({mod}) {line}"
164
+ return line, kwargs
165
+
166
+ def log(self, level, msg, *args, exc_info=None, stack_info=False, **kwargs) -> None:
167
+ msg, kwargs = self.format_inline(msg, kwargs)
168
+ return super().log(
169
+ level,
170
+ msg,
171
+ *args,
172
+ exc_info=exc_info,
173
+ stack_info=stack_info,
174
+ stacklevel=2,
175
+ **kwargs,
176
+ )
177
+
131
178
  def success(self, msg, color=None, *args, **kwargs):
132
179
  color = color or "green"
133
180
  prefix = r"[bold %s]\[+][/bold %s]" % (color, color)
@@ -166,8 +213,8 @@ class ProtocolLogger(logging.LoggerAdapter):
166
213
  lineno=caller.f_lineno,
167
214
  msg=text,
168
215
  args=args,
169
- kwargs=kwargs,
170
- exc_info=False,
216
+ # kwargs=kwargs,
217
+ exc_info=None,
171
218
  )
172
219
  )
173
220
 
@@ -133,7 +133,7 @@ class IMAPHandler(BaseProtoHandler):
133
133
  self._write_line(line)
134
134
 
135
135
  def _write_line(self, msg: str) -> None:
136
- self.logger.debug(f"(imap) S: {msg!r}")
136
+ self.logger.debug(repr(msg), is_server=True)
137
137
  self.send(f"{msg}\r\n".encode("utf-8", "strict"))
138
138
 
139
139
  # There are three possible server completion responses:
@@ -183,7 +183,7 @@ class IMAPHandler(BaseProtoHandler):
183
183
  # If the client wishes to cancel an authentication exchange, it issues a line consisting
184
184
  # of a single "*"
185
185
  resp = self.rfile.readline(1024).strip()
186
- self.logger.debug(f"(imap) C: {resp!r}")
186
+ self.logger.debug(repr(resp), is_client=True)
187
187
  if resp == b"*":
188
188
  self.bad("Authentication canceled")
189
189
  raise StopHandler
@@ -220,7 +220,7 @@ class IMAPHandler(BaseProtoHandler):
220
220
  tag, cmd, *args = shlex.split(line)
221
221
  self.seq_id = tag
222
222
  except ValueError:
223
- self.logger.debug(f"(imap) Unknown command: {line!r}")
223
+ self.logger.debug(f"Unknown command: {line!r}")
224
224
  self.bad("Invalid command")
225
225
  continue
226
226
 
@@ -231,7 +231,7 @@ class IMAPHandler(BaseProtoHandler):
231
231
  except StopHandler:
232
232
  break
233
233
  else:
234
- self.logger.debug(f"(imap) Unknown command: {line!r}")
234
+ self.logger.debug(f"Unknown command: {line!r}")
235
235
  # 7.1.5. BYE Response
236
236
  self._push("BYE Unknown command", seq=False)
237
237
  break
@@ -240,7 +240,7 @@ class IMAPHandler(BaseProtoHandler):
240
240
  data = self.rfile.readline(size)
241
241
  if data:
242
242
  text = data.decode("utf-8", errors="replace").strip()
243
- self.logger.debug(f"(imap) C: {text!r}")
243
+ self.logger.debug(repr(text), is_client=True)
244
244
  return text
245
245
 
246
246
  # implementation
@@ -55,16 +55,14 @@ def normalized_name(host: str | bytes) -> str:
55
55
 
56
56
  class MDNSConfig(TomlConfig):
57
57
  _section_ = "mDNS"
58
- _fields_ = (
59
- [
60
- A("enabled", "Dementor.mDNS", True),
61
- A("mdns_ttl", "TTL", 120),
62
- A("mdns_max_labels", "MaxLabels", 1),
63
- A("mdns_qtypes", "AllowedQueryTypes", [1, 28, 255]), # A, AAAA, ANY
64
- ATTR_WHITELIST,
65
- ATTR_BLACKLIST
66
- ]
67
- )
58
+ _fields_ = [
59
+ A("enabled", "Dementor.mDNS", True),
60
+ A("mdns_ttl", "TTL", 120),
61
+ A("mdns_max_labels", "MaxLabels", 1),
62
+ A("mdns_qtypes", "AllowedQueryTypes", [1, 28, 255]), # A, AAAA, ANY
63
+ ATTR_WHITELIST,
64
+ ATTR_BLACKLIST,
65
+ ]
68
66
 
69
67
  def set_mdns_qtypes(self, value: list):
70
68
  # REVISIT: maybe add error check here
@@ -115,7 +113,6 @@ class MDNSPoisoner(BaseProtoHandler):
115
113
  if normalized_qname.count(".") > self.config.mdns_config.mdns_max_labels:
116
114
  return False
117
115
 
118
-
119
116
  if question.qtype not in self.config.mdns_config.mdns_qtypes: # A, AAAA, ANY
120
117
  return False
121
118
 
@@ -140,13 +137,12 @@ class MDNSPoisoner(BaseProtoHandler):
140
137
  if self.should_answer_request(question):
141
138
  name = markup.escape(normalized_name(qname))
142
139
  self.logger.display(
143
- f"Request for [i]{name}[/i] (class: {qclass}, "
144
- f"type: {qtype})"
140
+ f"Request for [i]{name}[/i] (class: {qclass}, type: {qtype})"
145
141
  )
146
142
  if self.config.analysis:
147
143
  # Analyze-only mode
148
144
  continue
149
- self.send_poisoned_answer(packet, question, transport)
145
+ self.send_poisoned_answer(packet, question, transport, name)
150
146
  # REVISIT: maybe log ignored requests
151
147
  # else:
152
148
  # self.logger.display(
@@ -154,7 +150,9 @@ class MDNSPoisoner(BaseProtoHandler):
154
150
  # f"type: {qtype})"
155
151
  # )
156
152
 
157
- def send_poisoned_answer(self, req, question: dns.DNSQR, transport) -> None:
153
+ def send_poisoned_answer(
154
+ self, req, question: dns.DNSQR, transport, name: str
155
+ ) -> None:
158
156
  # check if we can send a response
159
157
  if question.qtype == 28 and not self.config.ipv6:
160
158
  self.logger.highlight(
@@ -173,7 +171,9 @@ class MDNSPoisoner(BaseProtoHandler):
173
171
  # build response packet with our IP in answer RR
174
172
  response = build_dns_answer(req.id, question, self.config)
175
173
  transport.sendto(response.build(), self.client_address)
176
- self.logger.success(f"Sent poisoned answer to {self.client_host}")
174
+ self.logger.success(
175
+ f"Sent poisoned answer to {self.client_host} for [i]{name}[/]"
176
+ )
177
177
 
178
178
 
179
179
  class MDNSServer(ThreadingUDPServer):