Debian Codegraph @

tests/_ntlm_raw/test_messages.py

raw
1 # -*- coding: utf-8 -*-
2 # Copyright: (c) 2020, Jordan Borean (@jborean93) <[email protected]>
3 # MIT License (see LICENSE or https://opensource.org/licenses/MIT)
4
5 import datetime
6 import struct
7
8 import pytest
9
10 import spnego._ntlm_raw.messages as messages
11
12 from .._ntlm_raw import (
13 TEST_NTLMV1_FLAGS,
14 TEST_NTLMV2_FLAGS,
15 TEST_SERVER_CHALLENGE,
16 TEST_SERVER_NAME,
17 TEST_USER,
18 TEST_USER_DOM,
19 TEST_WORKSTATION_NAME,
20 )
21
22
23 class UTC10(datetime.tzinfo):
24 """Test UTC+10 timezone class."""
25
26 def utcoffset(self, dt):
27 return datetime.timedelta(hours=10)
28
29 def tzname(self, dt):
30 return "UTC+10"
31
32 def dst(self, dt):
33 return datetime.timedelta(hours=10)
34
35
36 def test_negotiate_flags_native_labels():
37 actual = messages.NegotiateFlags.native_labels()
38
39 assert isinstance(actual, dict)
40 assert actual[messages.NegotiateFlags.key_56] == "NTLMSSP_NEGOTIATE_56"
41
42
43 def test_av_id_native_labels():
44 actual = messages.AvId.native_labels()
45
46 assert isinstance(actual, dict)
47 assert actual[messages.AvId.channel_bindings] == "MSV_AV_CHANNEL_BINDINGS"
48
49
50 def test_av_flags_native_labels():
51 actual = messages.AvFlags.native_labels()
52
53 assert isinstance(actual, dict)
54 assert actual[messages.AvFlags.mic] == "MIC_PROVIDED"
55
56
57 def test_message_type_native_labels():
58 actual = messages.MessageType.native_labels()
59
60 assert isinstance(actual, dict)
61 assert actual[messages.MessageType.challenge] == "CHALLENGE_MESSAGE"
62
63
64 def test_negotiate_pack_defaults():
65 negotiate = messages.Negotiate()
66
67 assert negotiate.flags == 0
68 assert negotiate.domain_name is None
69 assert negotiate.workstation is None
70 assert negotiate.version is None
71
72 actual = negotiate.pack()
73
74 assert (
75 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
76 b"\x01\x00\x00\x00"
77 b"\x00\x00\x00\x00"
78 b"\x00\x00"
79 b"\x00\x00"
80 b"\x20\x00\x00\x00"
81 b"\x00\x00"
82 b"\x00\x00"
83 b"\x20\x00\x00\x00"
84 )
85
86 negotiate.flags = 1
87
88 actual = negotiate.pack()
89
90 assert (
91 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
92 b"\x01\x00\x00\x00"
93 b"\x01\x00\x00\x00"
94 b"\x00\x00"
95 b"\x00\x00"
96 b"\x20\x00\x00\x00"
97 b"\x00\x00"
98 b"\x00\x00"
99 b"\x20\x00\x00\x00"
100 )
101
102
103 def test_negotiate_pack_with_domain():
104 negotiate = messages.Negotiate(domain_name="café", workstation="café")
105
106 assert (
107 negotiate.flags
108 == messages.NegotiateFlags.oem_workstation_supplied | messages.NegotiateFlags.oem_domain_name_supplied
109 )
110 assert negotiate.domain_name == "café"
111 assert negotiate.workstation == "café"
112 assert negotiate.version is None
113
114 actual = negotiate.pack()
115
116 assert (
117 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
118 b"\x01\x00\x00\x00"
119 b"\x00\x30\x00\x00"
120 b"\x04\x00"
121 b"\x04\x00"
122 b"\x20\x00\x00\x00"
123 b"\x04\x00"
124 b"\x04\x00"
125 b"\x24\x00\x00\x00"
126 b"\x63\x61\x66\xE9"
127 b"\x63\x61\x66\xE9"
128 )
129
130
131 def test_negotiate_pack_with_all_fields():
132 negotiate = messages.Negotiate(domain_name="café", workstation="café", version=messages.Version(1, 1, 1))
133
134 assert (
135 negotiate.flags
136 == messages.NegotiateFlags.oem_workstation_supplied
137 | messages.NegotiateFlags.oem_domain_name_supplied
138 | messages.NegotiateFlags.version
139 )
140 assert negotiate.domain_name == "café"
141 assert negotiate.workstation == "café"
142 assert negotiate.version == messages.Version(1, 1, 1)
143
144 actual = negotiate.pack()
145
146 assert (
147 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
148 b"\x01\x00\x00\x00"
149 b"\x00\x30\x00\x02"
150 b"\x04\x00"
151 b"\x04\x00"
152 b"\x28\x00\x00\x00"
153 b"\x04\x00"
154 b"\x04\x00"
155 b"\x2C\x00\x00\x00"
156 b"\x01\x01\x01\x00\x00\x00\x00\x0F"
157 b"\x63\x61\x66\xE9"
158 b"\x63\x61\x66\xE9"
159 )
160
161
162 def test_negotiate_pack_encoding():
163 negotiate = messages.Negotiate(domain_name="café", workstation="café", encoding="utf-8")
164
165 assert (
166 negotiate.flags
167 == messages.NegotiateFlags.oem_workstation_supplied | messages.NegotiateFlags.oem_domain_name_supplied
168 )
169 assert negotiate.domain_name == "café"
170 assert negotiate.workstation == "café"
171 assert negotiate.version is None
172
173 actual = negotiate.pack()
174
175 assert (
176 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
177 b"\x01\x00\x00\x00"
178 b"\x00\x30\x00\x00"
179 b"\x05\x00"
180 b"\x05\x00"
181 b"\x20\x00\x00\x00"
182 b"\x05\x00"
183 b"\x05\x00"
184 b"\x25\x00\x00\x00"
185 b"\x63\x61\x66\xC3\xA9"
186 b"\x63\x61\x66\xC3\xA9"
187 )
188
189
190 def test_negotiate_unpack():
191 actual = messages.Negotiate.unpack(
192 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
193 b"\x01\x00\x00\x00"
194 b"\x00\x00\x00\x00"
195 b"\x00\x00"
196 b"\x00\x00"
197 b"\x20\x00\x00\x00"
198 b"\x00\x00"
199 b"\x00\x00"
200 b"\x20\x00\x00\x00"
201 )
202
203 assert actual.flags == 0
204 assert actual.domain_name is None
205 assert actual.workstation is None
206 assert actual.version is None
207
208
209 def test_negotiate_unpack_with_domain():
210 actual = messages.Negotiate.unpack(
211 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
212 b"\x01\x00\x00\x00"
213 b"\x00\x30\x00\x00"
214 b"\x04\x00"
215 b"\x04\x00"
216 b"\x20\x00\x00\x00"
217 b"\x04\x00"
218 b"\x04\x00"
219 b"\x24\x00\x00\x00"
220 b"\x63\x61\x66\xE9"
221 b"\x63\x61\x66\xE9"
222 )
223
224 assert (
225 actual.flags
226 == messages.NegotiateFlags.oem_workstation_supplied | messages.NegotiateFlags.oem_domain_name_supplied
227 )
228 assert actual.domain_name == "café"
229 assert actual.workstation == "café"
230 assert actual.version is None
231
232
233 def test_negotiate_unpack_with_all_fields():
234 actual = messages.Negotiate.unpack(
235 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
236 b"\x01\x00\x00\x00"
237 b"\x00\x30\x00\x02"
238 b"\x04\x00"
239 b"\x04\x00"
240 b"\x28\x00\x00\x00"
241 b"\x04\x00"
242 b"\x04\x00"
243 b"\x2C\x00\x00\x00"
244 b"\x01\x01\x01\x00\x00\x00\x00\x0F"
245 b"\x63\x61\x66\xE9"
246 b"\x63\x61\x66\xE9"
247 )
248
249 assert (
250 actual.flags
251 == messages.NegotiateFlags.oem_workstation_supplied
252 | messages.NegotiateFlags.oem_domain_name_supplied
253 | messages.NegotiateFlags.version
254 )
255
256 assert actual.domain_name == "café"
257 assert actual.workstation == "café"
258 assert actual.version == messages.Version(1, 1, 1)
259
260
261 def test_negotiate_unpack_encoding():
262 actual = messages.Negotiate.unpack(
263 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
264 b"\x01\x00\x00\x00"
265 b"\x00\x30\x00\x00"
266 b"\x05\x00"
267 b"\x05\x00"
268 b"\x20\x00\x00\x00"
269 b"\x05\x00"
270 b"\x05\x00"
271 b"\x25\x00\x00\x00"
272 b"\x63\x61\x66\xC3\xA9"
273 b"\x63\x61\x66\xC3\xA9",
274 encoding="utf-8",
275 )
276
277 assert (
278 actual.flags
279 == messages.NegotiateFlags.oem_workstation_supplied | messages.NegotiateFlags.oem_domain_name_supplied
280 )
281 assert actual.domain_name == "café"
282 assert actual.workstation == "café"
283 assert actual.version is None
284
285
286 def test_negotiate_unpack_invalid_encoding():
287 # While the cars are invalid UTF-8 chars we don't want that to raise an exception for the Negotiate msg.
288 actual = messages.Negotiate.unpack(
289 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
290 b"\x01\x00\x00\x00"
291 b"\x00\x30\x00\x00"
292 b"\x04\x00"
293 b"\x04\x00"
294 b"\x20\x00\x00\x00"
295 b"\x04\x00"
296 b"\x04\x00"
297 b"\x24\x00\x00\x00"
298 b"\x63\x61\x66\xE9"
299 b"\x63\x61\x66\xE9",
300 encoding="utf-8",
301 )
302
303 assert (
304 actual.flags
305 == messages.NegotiateFlags.oem_workstation_supplied | messages.NegotiateFlags.oem_domain_name_supplied
306 )
307 assert actual.domain_name == "caf�"
308 assert actual.workstation == "caf�"
309 assert actual.version is None
310
311
312 def test_negotiate_invalid_size():
313 with pytest.raises(ValueError, match="Invalid NTLM Negotiate raw byte length"):
314 messages.Negotiate.unpack(b"NTLMSSP\x00\x01\x00\x00\x00")
315
316
317 def test_negotiate_unpack_invalid_msg():
318 with pytest.raises(ValueError, match="Input message was not a NTLM Negotiate message"):
319 messages.Negotiate.unpack(
320 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
321 b"\x02\x00\x00\x00"
322 b"\x0C\x00"
323 b"\x0C\x00"
324 b"\x38\x00\x00\x00"
325 b"\x33\x82\x02\xE2"
326 b"\x01\x23\x45\x67\x89\xAB\xCD\xEF"
327 b"\x00\x00\x00\x00\x00\x00\x00\x00"
328 b"\x00\x00"
329 b"\x00\x00"
330 b"\x00\x00\x00\x00"
331 b"\x06\x00\x70\x17\x00\x00\x00\x0F"
332 b"\x53\x00\x65\x00\x72\x00\x76\x00\x65\x00\x72\x00"
333 )
334
335
336 def test_challenge_pack():
337 challenge = messages.Challenge()
338
339 assert challenge.flags == 0
340 assert challenge.server_challenge == b"\x00" * 8
341 assert challenge.target_info is None
342 assert challenge.target_name is None
343 assert challenge.version is None
344
345 actual = challenge.pack()
346
347 assert (
348 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
349 b"\x02\x00\x00\x00"
350 b"\x00\x00"
351 b"\x00\x00"
352 b"\x30\x00\x00\x00"
353 b"\x00\x00\x00\x00"
354 b"\x00\x00\x00\x00\x00\x00\x00\x00"
355 b"\x00\x00\x00\x00\x00\x00\x00\x00"
356 b"\x00\x00"
357 b"\x00\x00"
358 b"\x30\x00\x00\x00"
359 )
360
361
362 def test_challenge_pack_target_name():
363 challenge = messages.Challenge(
364 flags=messages.NegotiateFlags.unicode, server_challenge=b"\x11" * 8, target_name="café"
365 )
366
367 assert challenge.flags == messages.NegotiateFlags.unicode | messages.NegotiateFlags.request_target
368 assert challenge.server_challenge == b"\x11" * 8
369 assert challenge.target_name == "café"
370
371 actual = challenge.pack()
372
373 assert (
374 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
375 b"\x02\x00\x00\x00"
376 b"\x08\x00"
377 b"\x08\x00"
378 b"\x30\x00\x00\x00"
379 b"\x05\x00\x00\x00"
380 b"\x11\x11\x11\x11\x11\x11\x11\x11"
381 b"\x00\x00\x00\x00\x00\x00\x00\x00"
382 b"\x00\x00"
383 b"\x00\x00"
384 b"\x38\x00\x00\x00"
385 b"\x63\x00\x61\x00\x66\x00\xE9\x00"
386 )
387
388
389 def test_challenge_pack_target_name_oem():
390 challenge = messages.Challenge(flags=messages.NegotiateFlags.oem, server_challenge=b"\x11" * 8, target_name="café")
391
392 assert challenge.flags == messages.NegotiateFlags.oem | messages.NegotiateFlags.request_target
393 assert challenge.server_challenge == b"\x11" * 8
394 assert challenge.target_name == "café"
395
396 actual = challenge.pack()
397
398 assert (
399 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
400 b"\x02\x00\x00\x00"
401 b"\x04\x00"
402 b"\x04\x00"
403 b"\x30\x00\x00\x00"
404 b"\x06\x00\x00\x00"
405 b"\x11\x11\x11\x11\x11\x11\x11\x11"
406 b"\x00\x00\x00\x00\x00\x00\x00\x00"
407 b"\x00\x00"
408 b"\x00\x00"
409 b"\x34\x00\x00\x00"
410 b"\x63\x61\x66\xE9"
411 )
412
413
414 def test_challenge_pack_target_info():
415 ti = messages.TargetInfo()
416 ti[messages.AvId.dns_computer_name] = "café"
417 # Even with the OEM encoding flag, the target info should still be utf-16-le.
418 challenge = messages.Challenge(flags=messages.NegotiateFlags.oem, server_challenge=b"\x11" * 8, target_info=ti)
419
420 assert challenge.flags == messages.NegotiateFlags.oem | messages.NegotiateFlags.target_info
421 assert challenge.server_challenge == b"\x11" * 8
422 assert challenge.target_name is None
423 assert challenge.target_info is not None
424 assert len(challenge.target_info) == 2
425 assert challenge.target_info[messages.AvId.dns_computer_name] == "café"
426 assert challenge.target_info[messages.AvId.eol] == b""
427 assert challenge.version is None
428
429 actual = challenge.pack()
430
431 assert (
432 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
433 b"\x02\x00\x00\x00"
434 b"\x00\x00"
435 b"\x00\x00"
436 b"\x30\x00\x00\x00"
437 b"\x02\x00\x80\x00"
438 b"\x11\x11\x11\x11\x11\x11\x11\x11"
439 b"\x00\x00\x00\x00\x00\x00\x00\x00"
440 b"\x10\x00"
441 b"\x10\x00"
442 b"\x30\x00\x00\x00"
443 b"\x03\x00\x08\x00\x63\x00\x61\x00\x66\x00\xE9\x00"
444 b"\x00\x00\x00\x00"
445 )
446
447
448 def test_challenge_pack_all_fields():
449 ti = messages.TargetInfo()
450 ti[messages.AvId.dns_computer_name] = "café"
451 challenge = messages.Challenge(
452 flags=messages.NegotiateFlags.unicode,
453 server_challenge=b"\x11" * 8,
454 target_name="café",
455 target_info=ti,
456 version=messages.Version(2, 2, 2),
457 )
458
459 assert (
460 challenge.flags
461 == messages.NegotiateFlags.target_info
462 | messages.NegotiateFlags.request_target
463 | messages.NegotiateFlags.version
464 | messages.NegotiateFlags.unicode
465 )
466 assert challenge.server_challenge == b"\x11" * 8
467 assert challenge.target_name == "café"
468 assert challenge.target_info is not None
469 assert len(challenge.target_info) == 2
470 assert challenge.target_info[messages.AvId.dns_computer_name] == "café"
471 assert challenge.target_info[messages.AvId.eol] == b""
472 assert challenge.version == messages.Version(2, 2, 2)
473
474 actual = challenge.pack()
475
476 assert (
477 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
478 b"\x02\x00\x00\x00"
479 b"\x08\x00"
480 b"\x08\x00"
481 b"\x38\x00\x00\x00"
482 b"\x05\x00\x80\x02"
483 b"\x11\x11\x11\x11\x11\x11\x11\x11"
484 b"\x00\x00\x00\x00\x00\x00\x00\x00"
485 b"\x10\x00"
486 b"\x10\x00"
487 b"\x40\x00\x00\x00"
488 b"\x02\x02\x02\x00\x00\x00\x00\x0F"
489 b"\x63\x00\x61\x00\x66\x00\xE9"
490 b"\x00\x03\x00\x08\x00\x63\x00\x61\x00\x66\x00\xE9\x00"
491 b"\x00\x00\x00\x00"
492 )
493
494
495 def test_challenge_set_fields():
496 challenge = messages.Challenge()
497
498 challenge.flags = 10
499 challenge.server_challenge = b"\xFF" * 8
500
501 actual = challenge.pack()
502
503 assert (
504 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
505 b"\x02\x00\x00\x00"
506 b"\x00\x00"
507 b"\x00\x00"
508 b"\x30\x00\x00\x00"
509 b"\x0A\x00\x00\x00"
510 b"\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF"
511 b"\x00\x00\x00\x00\x00\x00\x00\x00"
512 b"\x00\x00"
513 b"\x00\x00"
514 b"\x30\x00\x00\x00"
515 )
516
517
518 def test_challenge_invalid_server_challenge_length():
519 expected = "NTLM Challenge ServerChallenge must be 8 bytes long"
520 with pytest.raises(ValueError, match=expected):
521 messages.Challenge(server_challenge=b"\x00")
522
523 challenge = messages.Challenge()
524 with pytest.raises(ValueError, match=expected):
525 challenge.server_challenge = b"\x08"
526
527
528 def test_challenge_invalid_size():
529 with pytest.raises(ValueError, match="Invalid NTLM Challenge raw byte length"):
530 messages.Challenge.unpack(b"NTLMSSP\x00\x02\x00\x00\x00")
531
532
533 def test_challenge_unpack_ntlmv1():
534 # https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-nlmp/ee78f3ad-ae29-4de1-96a0-fe46e64b6e31
535 actual = messages.Challenge.unpack(
536 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
537 b"\x02\x00\x00\x00"
538 b"\x0C\x00"
539 b"\x0C\x00"
540 b"\x38\x00\x00\x00"
541 b"\x33\x82\x02\xE2"
542 b"\x01\x23\x45\x67\x89\xAB\xCD\xEF"
543 b"\x00\x00\x00\x00\x00\x00\x00\x00"
544 b"\x00\x00"
545 b"\x00\x00"
546 b"\x00\x00\x00\x00"
547 b"\x06\x00\x70\x17\x00\x00\x00\x0F"
548 b"\x53\x00\x65\x00\x72\x00\x76\x00\x65\x00\x72\x00"
549 )
550
551 assert actual.target_name == TEST_SERVER_NAME
552 assert actual.flags == TEST_NTLMV1_FLAGS
553 assert actual.server_challenge == TEST_SERVER_CHALLENGE
554 assert actual.target_info is None
555 assert actual.version == messages.Version(6, 0, 6000)
556
557
558 def test_challenge_unpack_ntlmv2():
559 # https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-nlmp/bc612491-fb0b-4829-91bc-7c6b95ff67fe
560 actual = messages.Challenge.unpack(
561 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
562 b"\x02\x00\x00\x00"
563 b"\x0C\x00"
564 b"\x0C\x00"
565 b"\x38\x00\x00\x00"
566 b"\x33\x82\x8A\xE2"
567 b"\x01\x23\x45\x67\x89\xAB\xCD\xEF"
568 b"\x00\x00\x00\x00\x00\x00\x00\x00"
569 b"\x24\x00"
570 b"\x24\x00"
571 b"\x44\x00\x00\x00"
572 b"\x06\x00\x70\x17\x00\x00\x00\x0F"
573 b"\x53\x00\x65\x00\x72\x00\x76\x00\x65\x00\x72\x00"
574 b"\x02\x00\x0C\x00\x44\x00\x6F\x00\x6D\x00\x61\x00\x69\x00\x6E\x00"
575 b"\x01\x00\x0C\x00\x53\x00\x65\x00\x72\x00\x76\x00\x65\x00\x72\x00"
576 b"\x00\x00\x00\x00"
577 )
578
579 assert actual.target_name == TEST_SERVER_NAME
580 assert actual.flags == TEST_NTLMV2_FLAGS
581 assert actual.server_challenge == TEST_SERVER_CHALLENGE
582 assert actual.target_info is not None
583 assert len(actual.target_info) == 3
584 assert actual.target_info[messages.AvId.nb_domain_name] == TEST_USER_DOM
585 assert actual.target_info[messages.AvId.nb_computer_name] == TEST_SERVER_NAME
586 assert actual.target_info[messages.AvId.eol] == b""
587 assert actual.version == messages.Version(6, 0, 6000)
588
589
590 def test_challenge_unpack_encoding():
591 actual = messages.Challenge.unpack(
592 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
593 b"\x02\x00\x00\x00"
594 b"\x04\x00"
595 b"\x04\x00"
596 b"\x30\x00\x00\x00"
597 b"\x06\x00\x00\x00"
598 b"\x11\x11\x11\x11\x11\x11\x11\x11"
599 b"\x00\x00\x00\x00\x00\x00\x00\x00"
600 b"\x00\x00"
601 b"\x00\x00"
602 b"\x34\x00\x00\x00"
603 b"\x63\x61\x66\xE9"
604 )
605
606 assert actual.target_name == "café"
607 assert actual.flags == messages.NegotiateFlags.oem | messages.NegotiateFlags.request_target
608 assert actual.server_challenge == b"\x11" * 8
609 assert actual.target_info is None
610 assert actual.version is None
611
612
613 def test_challenge_unpack_invalid_msg():
614 with pytest.raises(ValueError, match="Input message was not a NTLM Challenge message"):
615 messages.Challenge.unpack(
616 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
617 b"\x01\x00\x00\x00"
618 b"\x00\x00\x00\x00"
619 b"\x00\x00"
620 b"\x00\x00"
621 b"\x20\x00\x00\x00"
622 b"\x00\x00"
623 b"\x00\x00"
624 b"\x20\x00\x00\x00"
625 )
626
627
628 def test_authenticate_pack():
629 authenticate = messages.Authenticate()
630
631 assert authenticate.lm_challenge_response is None
632 assert authenticate.nt_challenge_response is None
633 assert authenticate.domain_name is None
634 assert authenticate.user_name is None
635 assert authenticate.workstation is None
636 assert authenticate.encrypted_random_session_key is None
637 assert authenticate.flags == 0
638 assert authenticate.version is None
639 assert authenticate.mic == b"\x00" * 16
640
641 actual = authenticate.pack()
642
643 assert (
644 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
645 b"\x03\x00\x00\x00"
646 b"\x00\x00"
647 b"\x00\x00"
648 b"\x50\x00\x00\x00"
649 b"\x00\x00"
650 b"\x00\x00"
651 b"\x50\x00\x00\x00"
652 b"\x00\x00"
653 b"\x00\x00"
654 b"\x50\x00\x00\x00"
655 b"\x00\x00"
656 b"\x00\x00"
657 b"\x50\x00\x00\x00"
658 b"\x00\x00"
659 b"\x00\x00"
660 b"\x50\x00\x00\x00"
661 b"\x00\x00"
662 b"\x00\x00"
663 b"\x50\x00\x00\x00"
664 b"\x00\x00\x00\x00"
665 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
666 )
667
668
669 def test_authenticate_pack_domain_version():
670 authenticate = messages.Authenticate(
671 flags=messages.NegotiateFlags.unicode, domain_name="café", version=messages.Version(1, 1, 1)
672 )
673
674 assert authenticate.lm_challenge_response is None
675 assert authenticate.nt_challenge_response is None
676 assert authenticate.domain_name == "café"
677 assert authenticate.user_name is None
678 assert authenticate.workstation is None
679 assert authenticate.encrypted_random_session_key is None
680 assert authenticate.flags == messages.NegotiateFlags.version | messages.NegotiateFlags.unicode
681 assert authenticate.mic == b"\x00" * 16
682 assert authenticate.version == messages.Version(1, 1, 1)
683
684 actual = authenticate.pack()
685
686 assert (
687 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
688 b"\x03\x00\x00\x00"
689 b"\x00\x00"
690 b"\x00\x00"
691 b"\x58\x00\x00\x00"
692 b"\x00\x00"
693 b"\x00\x00"
694 b"\x58\x00\x00\x00"
695 b"\x08\x00"
696 b"\x08\x00"
697 b"\x58\x00\x00\x00"
698 b"\x00\x00"
699 b"\x00\x00"
700 b"\x60\x00\x00\x00"
701 b"\x00\x00"
702 b"\x00\x00"
703 b"\x60\x00\x00\x00"
704 b"\x00\x00"
705 b"\x00\x00"
706 b"\x60\x00\x00\x00"
707 b"\x01\x00\x00\x02"
708 b"\x01\x01\x01\x00\x00\x00\x00\x0F"
709 b"\x00\x00\x00\x00\x00\x00\x00\x00"
710 b"\x00\x00\x00\x00\x00\x00\x00\x00"
711 b"\x63\x00\x61\x00\x66\x00\xE9\x00"
712 )
713
714
715 def test_authenticate_pack_oem_encoding():
716 authenticate = messages.Authenticate(
717 flags=messages.NegotiateFlags.oem, domain_name="café", version=messages.Version(1, 1, 1)
718 )
719
720 assert authenticate.lm_challenge_response is None
721 assert authenticate.nt_challenge_response is None
722 assert authenticate.domain_name == "café"
723 assert authenticate.user_name is None
724 assert authenticate.workstation is None
725 assert authenticate.encrypted_random_session_key is None
726 assert authenticate.flags == messages.NegotiateFlags.version | messages.NegotiateFlags.oem
727 assert authenticate.mic == b"\x00" * 16
728 assert authenticate.version == messages.Version(1, 1, 1)
729
730 actual = authenticate.pack()
731
732 assert (
733 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
734 b"\x03\x00\x00\x00"
735 b"\x00\x00"
736 b"\x00\x00"
737 b"\x58\x00\x00\x00"
738 b"\x00\x00"
739 b"\x00\x00"
740 b"\x58\x00\x00\x00"
741 b"\x04\x00"
742 b"\x04\x00"
743 b"\x58\x00\x00\x00"
744 b"\x00\x00"
745 b"\x00\x00"
746 b"\x5C\x00\x00\x00"
747 b"\x00\x00"
748 b"\x00\x00"
749 b"\x5C\x00\x00\x00"
750 b"\x00\x00"
751 b"\x00\x00"
752 b"\x5C\x00\x00\x00"
753 b"\x02\x00\x00\x02"
754 b"\x01\x01\x01\x00\x00\x00\x00\x0F"
755 b"\x00\x00\x00\x00\x00\x00\x00\x00"
756 b"\x00\x00\x00\x00\x00\x00\x00\x00"
757 b"\x63\x61\x66\xE9"
758 )
759
760
761 def test_authenticate_set_flags():
762 authenticate = messages.Authenticate()
763 authenticate.flags = 1
764
765 actual = authenticate.pack()
766
767 assert (
768 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
769 b"\x03\x00\x00\x00"
770 b"\x00\x00"
771 b"\x00\x00"
772 b"\x50\x00\x00\x00"
773 b"\x00\x00"
774 b"\x00\x00"
775 b"\x50\x00\x00\x00"
776 b"\x00\x00"
777 b"\x00\x00"
778 b"\x50\x00\x00\x00"
779 b"\x00\x00"
780 b"\x00\x00"
781 b"\x50\x00\x00\x00"
782 b"\x00\x00"
783 b"\x00\x00"
784 b"\x50\x00\x00\x00"
785 b"\x00\x00"
786 b"\x00\x00"
787 b"\x50\x00\x00\x00"
788 b"\x01\x00\x00\x00"
789 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
790 )
791
792
793 def test_authenticate_set_mic():
794 authenticate = messages.Authenticate()
795 authenticate.mic = b"\xFF" * 16
796
797 actual = authenticate.pack()
798
799 assert (
800 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
801 b"\x03\x00\x00\x00"
802 b"\x00\x00"
803 b"\x00\x00"
804 b"\x50\x00\x00\x00"
805 b"\x00\x00"
806 b"\x00\x00"
807 b"\x50\x00\x00\x00"
808 b"\x00\x00"
809 b"\x00\x00"
810 b"\x50\x00\x00\x00"
811 b"\x00\x00"
812 b"\x00\x00"
813 b"\x50\x00\x00\x00"
814 b"\x00\x00"
815 b"\x00\x00"
816 b"\x50\x00\x00\x00"
817 b"\x00\x00"
818 b"\x00\x00"
819 b"\x50\x00\x00\x00"
820 b"\x00\x00\x00\x00"
821 b"\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF"
822 )
823
824
825 def test_authenticate_set_encrypted_session_key():
826 authenticate = messages.Authenticate(encrypted_session_key=b"\x01")
827
828 actual = authenticate.pack()
829
830 assert (
831 actual == b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
832 b"\x03\x00\x00\x00"
833 b"\x00\x00"
834 b"\x00\x00"
835 b"\x50\x00\x00\x00"
836 b"\x00\x00"
837 b"\x00\x00"
838 b"\x50\x00\x00\x00"
839 b"\x00\x00"
840 b"\x00\x00"
841 b"\x50\x00\x00\x00"
842 b"\x00\x00"
843 b"\x00\x00"
844 b"\x50\x00\x00\x00"
845 b"\x00\x00"
846 b"\x00\x00"
847 b"\x50\x00\x00\x00"
848 b"\x01\x00"
849 b"\x01\x00"
850 b"\x50\x00\x00\x00"
851 b"\x00\x00\x00\x40"
852 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
853 b"\x01"
854 )
855
856
857 def test_authenticate_invalid_mic_length():
858 expected = "NTLM Authenticate MIC must be 16 bytes long"
859
860 with pytest.raises(ValueError, match=expected):
861 messages.Authenticate(mic=b"\x00")
862
863 authenticate = messages.Authenticate()
864 with pytest.raises(ValueError, match=expected):
865 authenticate.mic = b"\x00"
866
867
868 def test_authenticate_set_mic_not_present():
869 authenticate = messages.Authenticate.unpack(b"NTLMSSP\x00\x03\x00\x00\x00" + (b"\x00" * 52))
870
871 assert authenticate.mic is None
872
873 with pytest.raises(ValueError, match="Cannot set MIC on an Authenticate message with no MIC present"):
874 authenticate.mic = b"\x11" * 16
875
876
877 def test_authenticate_unpack_empty():
878 actual = messages.Authenticate.unpack(
879 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
880 b"\x03\x00\x00\x00"
881 b"\x00\x00"
882 b"\x00\x00"
883 b"\x50\x00\x00\x00"
884 b"\x00\x00"
885 b"\x00\x00"
886 b"\x50\x00\x00\x00"
887 b"\x00\x00"
888 b"\x00\x00"
889 b"\x50\x00\x00\x00"
890 b"\x00\x00"
891 b"\x00\x00"
892 b"\x50\x00\x00\x00"
893 b"\x00\x00"
894 b"\x00\x00"
895 b"\x50\x00\x00\x00"
896 b"\x00\x00"
897 b"\x00\x00"
898 b"\x50\x00\x00\x00"
899 b"\x00\x00\x00\x00"
900 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
901 )
902
903 assert actual.lm_challenge_response is None
904 assert actual.nt_challenge_response is None
905 assert actual.domain_name is None
906 assert actual.user_name is None
907 assert actual.workstation is None
908 assert actual.encrypted_random_session_key is None
909 assert actual.flags == 0
910 assert actual.version is None
911 assert actual.mic == b"\x00" * 16
912
913
914 def test_authenticate_unpack_ntlmv1():
915 # https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-nlmp/ee78f3ad-ae29-4de1-96a0-fe46e64b6e31
916 actual = messages.Authenticate.unpack(
917 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
918 b"\x03\x00\x00\x00"
919 b"\x18\x00"
920 b"\x18\x00"
921 b"\x6C\x00\x00\x00"
922 b"\x18\x00"
923 b"\x18\x00"
924 b"\x84\x00\x00\x00"
925 b"\x0C\x00"
926 b"\x0C\x00"
927 b"\x48\x00\x00\x00"
928 b"\x08\x00"
929 b"\x08\x00"
930 b"\x54\x00\x00\x00"
931 b"\x10\x00"
932 b"\x10\x00"
933 b"\x5C\x00\x00\x00"
934 b"\x10\x00"
935 b"\x10\x00"
936 b"\x9C\x00\x00\x00"
937 b"\x35\x82\x80\xE2"
938 b"\x05\x01\x28\x0A\x00\x00\x00\x0F"
939 b"\x44\x00\x6F\x00\x6D\x00\x61\x00\x69\x00\x6E\x00"
940 b"\x55\x00\x73\x00\x65\x00\x72\x00"
941 b"\x43\x00\x4F\x00\x4D\x00\x50\x00\x55\x00\x54\x00\x45\x00\x52\x00"
942 b"\x98\xDE\xF7\xB8\x7F\x88\xAA\x5D\xAF\xE2\xDF\x77\x96\x88\xA1\x72"
943 b"\xDE\xF1\x1C\x7D\x5C\xCD\xEF\x13"
944 b"\x67\xC4\x30\x11\xF3\x02\x98\xA2\xAD\x35\xEC\xE6\x4F\x16\x33\x1C"
945 b"\x44\xBD\xBE\xD9\x27\x84\x1F\x94"
946 b"\x51\x88\x22\xB1\xB3\xF3\x50\xC8\x95\x86\x82\xEC\xBB\x3E\x3C\xB7"
947 )
948
949 assert (
950 actual.lm_challenge_response == b"\x98\xDE\xF7\xB8\x7F\x88\xAA\x5D"
951 b"\xAF\xE2\xDF\x77\x96\x88\xA1\x72"
952 b"\xDE\xF1\x1C\x7D\x5C\xCD\xEF\x13"
953 )
954 assert (
955 actual.nt_challenge_response == b"\x67\xC4\x30\x11\xF3\x02\x98\xA2"
956 b"\xAD\x35\xEC\xE6\x4F\x16\x33\x1C"
957 b"\x44\xBD\xBE\xD9\x27\x84\x1F\x94"
958 )
959 assert actual.domain_name == TEST_USER_DOM
960 assert actual.user_name == TEST_USER
961 assert actual.workstation == TEST_WORKSTATION_NAME
962 assert (
963 actual.encrypted_random_session_key == b"\x51\x88\x22\xB1\xB3\xF3\x50\xC8" b"\x95\x86\x82\xEC\xBB\x3E\x3C\xB7"
964 )
965 assert actual.flags == 3800072757
966 assert actual.mic is None
967 assert actual.version == messages.Version(5, 1, 2600)
968
969
970 def test_authenticate_unpack_ntlmv2():
971 # https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-nlmp/bc612491-fb0b-4829-91bc-7c6b95ff67fe
972 actual = messages.Authenticate.unpack(
973 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
974 b"\x03\x00\x00\x00"
975 b"\x18\x00"
976 b"\x18\x00"
977 b"\x6C\x00\x00\x00"
978 b"\x54\x00"
979 b"\x54\x00"
980 b"\x84\x00\x00\x00"
981 b"\x0C\x00"
982 b"\x0C\x00"
983 b"\x48\x00\x00\x00"
984 b"\x08\x00"
985 b"\x08\x00"
986 b"\x54\x00\x00\x00"
987 b"\x10\x00"
988 b"\x10\x00"
989 b"\x5C\x00\x00\x00"
990 b"\x10\x00"
991 b"\x10\x00"
992 b"\xD8\x00\x00\x00"
993 b"\x35\x82\x88\xE2"
994 b"\x05\x01\x28\x0A\x00\x00\x00\x0F"
995 b"\x44\x00\x6F\x00\x6D\x00\x61\x00\x69\x00\x6E\x00"
996 b"\x55\x00\x73\x00\x65\x00\x72\x00"
997 b"\x43\x00\x4F\x00\x4D\x00\x50\x00\x55\x00\x54\x00\x45\x00\x52\x00"
998 b"\x86\xC3\x50\x97\xAC\x9C\xEC\x10\x25\x54\x76\x4A\x57\xCC\xCC\x19"
999 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1000 b"\x68\xCD\x0A\xB8\x51\xE5\x1C\x96\xAA\xBC\x92\x7B\xEB\xEF\x6A\x1C"
1001 b"\x01"
1002 b"\x01"
1003 b"\x00\x00"
1004 b"\x00\x00\x00\x00"
1005 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1006 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1007 b"\x00\x00\x00\x00"
1008 b"\x02\x00\x0C\x00\x44\x00\x6F\x00\x6D\x00\x61\x00\x69\x00\x6E\x00"
1009 b"\x01\x00\x0C\x00\x53\x00\x65\x00\x72\x00\x76\x00\x65\x00\x72\x00"
1010 b"\x00\x00\x00\x00"
1011 b"\x00\x00\x00\x00"
1012 b"\xC5\xDA\xD2\x54\x4F\xC9\x79\x90\x94\xCE\x1C\xE9\x0B\xC9\xD0\x3E"
1013 )
1014
1015 assert (
1016 actual.lm_challenge_response == b"\x86\xC3\x50\x97\xAC\x9C\xEC\x10"
1017 b"\x25\x54\x76\x4A\x57\xCC\xCC\x19"
1018 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1019 )
1020 assert (
1021 actual.nt_challenge_response == b"\x68\xCD\x0A\xB8\x51\xE5\x1C\x96"
1022 b"\xAA\xBC\x92\x7B\xEB\xEF\x6A\x1C"
1023 b"\x01"
1024 b"\x01"
1025 b"\x00\x00"
1026 b"\x00\x00\x00\x00"
1027 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1028 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1029 b"\x00\x00\x00\x00"
1030 b"\x02\x00\x0C\x00\x44\x00\x6F\x00\x6D\x00\x61\x00\x69\x00\x6E\x00"
1031 b"\x01\x00\x0C\x00\x53\x00\x65\x00\x72\x00\x76\x00\x65\x00\x72\x00"
1032 b"\x00\x00\x00\x00"
1033 b"\x00\x00\x00\x00"
1034 )
1035 assert actual.domain_name == TEST_USER_DOM
1036 assert actual.user_name == TEST_USER
1037 assert actual.workstation == TEST_WORKSTATION_NAME
1038 assert (
1039 actual.encrypted_random_session_key == b"\xC5\xDA\xD2\x54\x4F\xC9\x79\x90" b"\x94\xCE\x1C\xE9\x0B\xC9\xD0\x3E"
1040 )
1041 assert actual.flags == 3800597045
1042 assert actual.mic is None
1043 assert actual.version == messages.Version(5, 1, 2600)
1044
1045
1046 def test_authenticate_unpack_mic_no_version():
1047 actual = messages.Authenticate.unpack(
1048 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
1049 b"\x03\x00\x00\x00"
1050 b"\x18\x00"
1051 b"\x18\x00"
1052 b"\x50\x00\x00\x00"
1053 b"\x54\x00"
1054 b"\x54\x00"
1055 b"\x68\x00\x00\x00"
1056 b"\x08\x00"
1057 b"\x08\x00"
1058 b"\xBC\x00\x00\x00"
1059 b"\x08\x00"
1060 b"\x08\x00"
1061 b"\xC4\x00\x00\x00"
1062 b"\x08\x00"
1063 b"\x08\x00"
1064 b"\xCC\x00\x00\x00"
1065 b"\x00\x00"
1066 b"\x00\x00"
1067 b"\xD4\x00\x00\x00"
1068 b"\x31\x82\x8A\xE2"
1069 b"\x11\x11\x11\x11\x11\x11\x11\x11"
1070 b"\x11\x11\x11\x11\x11\x11\x11\x11"
1071 b"\x86\xC3\x50\x97\xAC\x9C\xEC\x10"
1072 b"\x25\x54\x76\x4A\x57\xCC\xCC\x19"
1073 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1074 b"\x68\xCD\x0A\xB8\x51\xE5\x1C\x96"
1075 b"\xAA\xBC\x92\x7B\xEB\xEF\x6A\x1C"
1076 b"\x01"
1077 b"\x01"
1078 b"\x00\x00"
1079 b"\x00\x00\x00\x00"
1080 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1081 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1082 b"\x00\x00\x00\x00"
1083 b"\x02\x00\x0C\x00\x44\x00\x6F\x00"
1084 b"\x6D\x00\x61\x00\x69\x00\x6E\x00"
1085 b"\x01\x00\x0C\x00\x53\x00\x65\x00"
1086 b"\x72\x00\x76\x00\x65\x00\x72\x00"
1087 b"\x00\x00\x00\x00"
1088 b"\x00\x00\x00\x00"
1089 b"\x63\x00\x61\x00\x66\x00\xE9\x00"
1090 b"\x63\x00\x61\x00\x66\x00\xE9\x00"
1091 b"\x63\x00\x61\x00\x66\x00\xE9\x00"
1092 )
1093
1094 assert (
1095 actual.lm_challenge_response == b"\x86\xC3\x50\x97\xAC\x9C\xEC\x10"
1096 b"\x25\x54\x76\x4A\x57\xCC\xCC\x19"
1097 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1098 )
1099 assert (
1100 actual.nt_challenge_response == b"\x68\xCD\x0A\xB8\x51\xE5\x1C\x96"
1101 b"\xAA\xBC\x92\x7B\xEB\xEF\x6A\x1C"
1102 b"\x01"
1103 b"\x01"
1104 b"\x00\x00"
1105 b"\x00\x00\x00\x00"
1106 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1107 b"\xAA\xAA\xAA\xAA\xAA\xAA\xAA\xAA"
1108 b"\x00\x00\x00\x00"
1109 b"\x02\x00\x0C\x00\x44\x00\x6F\x00\x6D\x00\x61\x00\x69\x00\x6E\x00"
1110 b"\x01\x00\x0C\x00\x53\x00\x65\x00\x72\x00\x76\x00\x65\x00\x72\x00"
1111 b"\x00\x00\x00\x00"
1112 b"\x00\x00\x00\x00"
1113 )
1114 assert actual.domain_name == "café"
1115 assert actual.user_name == "café"
1116 assert actual.workstation == "café"
1117 assert actual.encrypted_random_session_key is None
1118 assert actual.flags == 3800728113
1119 assert actual.mic == b"\x11" * 16
1120 assert actual.version is None
1121
1122
1123 def test_authenticate_invalid_size():
1124 with pytest.raises(ValueError, match="Invalid NTLM Authenticate raw byte length"):
1125 messages.Authenticate.unpack(b"NTLMSSP\x00\x03\x00\x00\x00")
1126
1127
1128 def test_authenticate_unpack_invalid_msg():
1129 with pytest.raises(ValueError, match="Input message was not a NTLM Authenticate message"):
1130 messages.Authenticate.unpack(
1131 b"\x4E\x54\x4C\x4D\x53\x53\x50\x00"
1132 b"\x01\x00\x00\x00"
1133 b"\x00\x00\x00\x00"
1134 b"\x00\x00"
1135 b"\x00\x00"
1136 b"\x20\x00\x00\x00"
1137 b"\x00\x00"
1138 b"\x00\x00"
1139 b"\x20\x00\x00\x00"
1140 )
1141
1142
1143 def test_filetime_pack():
1144 filetime = messages.FileTime(1970, 1, 1, 0, 0, 0)
1145 actual = filetime.pack()
1146
1147 assert actual == b"\x00\x80\x3E\xD5\xDE\xB1\x9D\x01"
1148
1149
1150 def test_filetime_unpack():
1151 actual = messages.FileTime.unpack(b"\x00\x80\x3E\xD5\xDE\xB1\x9D\x01")
1152
1153 assert isinstance(actual, messages.FileTime)
1154 assert str(actual) == "1970-01-01T00:00:00Z"
1155 assert actual.year == 1970
1156 assert actual.month == 1
1157 assert actual.day == 1
1158 assert actual.hour == 0
1159 assert actual.minute == 0
1160 assert actual.second == 0
1161 assert actual.microsecond == 0
1162 assert actual.nanosecond == 0
1163
1164
1165 def test_filetime_from_datetime_nanoseconds():
1166 filetime = messages.FileTime.from_datetime(datetime.datetime(1970, 1, 1, 0, 0, 0), ns=500)
1167 actual = filetime.pack()
1168
1169 assert str(filetime) == "1970-01-01T00:00:00.0000005Z"
1170 assert filetime.nanosecond == 500
1171
1172 assert actual == b"\x05\x80\x3E\xD5\xDE\xB1\x9D\x01"
1173
1174
1175 def test_filetime_now():
1176 current = messages.FileTime.from_datetime(datetime.datetime.now())
1177 now = messages.FileTime.now()
1178
1179 current_int = struct.unpack("<Q", current.pack())[0]
1180 now_int = struct.unpack("<Q", now.pack())[0]
1181
1182 assert now_int >= current_int
1183
1184
1185 def test_filetime_with_timezone():
1186 filetime = messages.FileTime(1970, 1, 1, 10, 0, 0, tzinfo=UTC10())
1187
1188 assert str(filetime) == "1970-01-01T10:00:00+10:00"
1189
1190 actual = filetime.pack() # Should be the same as EPOCH in UTC as FILETIME.
1191 assert actual == b"\x00\x80\x3E\xD5\xDE\xB1\x9D\x01"
1192
1193
1194 def test_nt_challenge_pack():
1195 challenge = messages.NTClientChallengeV2()
1196 assert challenge.resp_type == 1
1197 assert challenge.hi_resp_type == 1
1198 assert isinstance(challenge.time_stamp, messages.FileTime)
1199 assert challenge.challenge_from_client == b"\x00" * 8
1200 assert len(challenge.av_pairs) == 1
1201
1202 challenge.time_stamp = messages.FileTime.unpack(b"\x00\x00\x00\x00\x00\x00\x00\x00")
1203
1204 actual = challenge.pack()
1205
1206 assert (
1207 actual == b"\x01"
1208 b"\x01"
1209 b"\x00\x00"
1210 b"\x00\x00\x00\x00"
1211 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1212 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1213 b"\x00\x00\x00\x00"
1214 b"\x00\x00\x00\x00"
1215 )
1216
1217
1218 def test_nt_challenge_create():
1219 ft = messages.FileTime.unpack(b"\x11" * 8)
1220 av = messages.TargetInfo()
1221 av[messages.AvId.dns_domain_name] = "test"
1222
1223 actual = messages.NTClientChallengeV2(time_stamp=ft, client_challenge=b"\x11" * 8, av_pairs=av)
1224
1225 assert actual.resp_type == 1
1226 assert actual.hi_resp_type == 1
1227 assert actual.time_stamp.pack() == b"\x11" * 8
1228 assert actual.challenge_from_client == b"\x11" * 8
1229 assert len(actual.av_pairs) == 2
1230 assert actual.av_pairs[messages.AvId.dns_domain_name] == "test"
1231
1232 assert (
1233 actual.pack() == b"\x01"
1234 b"\x01"
1235 b"\x00\x00"
1236 b"\x00\x00\x00\x00"
1237 b"\x11\x11\x11\x11\x11\x11\x11\x11"
1238 b"\x11\x11\x11\x11\x11\x11\x11\x11"
1239 b"\x00\x00\x00\x00"
1240 b"\x04\x00\x08\x00"
1241 b"\x74\x00\x65\x00\x73\x00\x74\x00"
1242 b"\x00\x00\x00\x00"
1243 )
1244
1245
1246 def test_nt_challenge_unpack():
1247 challenge = messages.NTClientChallengeV2.unpack(
1248 b"\x01"
1249 b"\x01"
1250 b"\x00\x00"
1251 b"\x00\x00\x00\x00"
1252 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1253 b"\x00\x00\x00\x00\x00\x00\x00\x00"
1254 b"\x00\x00\x00\x00"
1255 b"\x00\x00\x00\x00"
1256 )
1257
1258 assert challenge.resp_type == 1
1259 assert challenge.hi_resp_type == 1
1260 assert isinstance(challenge.time_stamp, messages.FileTime)
1261 assert challenge.time_stamp.pack() == b"\x00\x00\x00\x00\x00\x00\x00\x00"
1262 assert challenge.challenge_from_client == b"\x00\x00\x00\x00\x00\x00\x00\x00"
1263 assert isinstance(challenge.av_pairs, messages.TargetInfo)
1264 assert challenge.av_pairs.pack() == b"\x00\x00\x00\x00"
1265
1266
1267 def test_nt_challenge_unpack_invalid_size():
1268 with pytest.raises(ValueError, match="Invalid NTClientChallengeV2 raw byte length"):
1269 messages.NTClientChallengeV2.unpack(b"\x00")
1270
1271
1272 def test_nt_challenge_resp_type():
1273 challenge = messages.NTClientChallengeV2()
1274 assert challenge.resp_type == 1
1275 challenge.resp_type = 2
1276 assert challenge.resp_type == 2
1277 assert challenge.pack()[:1] == b"\x02"
1278
1279
1280 def test_nt_challenge_hi_resp_type():
1281 challenge = messages.NTClientChallengeV2()
1282 assert challenge.hi_resp_type == 1
1283 challenge.hi_resp_type = 2
1284 assert challenge.hi_resp_type == 2
1285 assert challenge.pack()[1:2] == b"\x02"
1286
1287
1288 def test_nt_challenge_client_challenge():
1289 challenge = messages.NTClientChallengeV2()
1290 assert challenge.challenge_from_client == b"\x00\x00\x00\x00\x00\x00\x00\x00"
1291 challenge.challenge_from_client = b"\xFF" * 8
1292 assert challenge.challenge_from_client == b"\xFF" * 8
1293 assert challenge.pack()[16:24] == b"\xFF" * 8
1294
1295
1296 def test_nt_challenge_client_challenge_bad_length():
1297 expected = "NTClientChallengeV2 ChallengeFromClient must be 8 bytes long"
1298
1299 with pytest.raises(ValueError, match=expected):
1300 messages.NTClientChallengeV2(client_challenge=b"\x00")
1301
1302 challenge = messages.NTClientChallengeV2()
1303 with pytest.raises(ValueError, match=expected):
1304 challenge.challenge_from_client = b"\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1305
1306
1307 def test_target_info_pack():
1308 target_info = messages.TargetInfo()
1309 target_info[messages.AvId.timestamp] = b"\x00\x00\x00\x00\x00\x00\x00\x00"
1310 target_info[messages.AvId.single_host] = b"\x00" * 48
1311 target_info[messages.AvId.dns_computer_name] = "caf\u00e9-host"
1312 target_info[messages.AvId.eol] = b""
1313 target_info[messages.AvId.channel_bindings] = b"\xFF" * 16
1314 target_info[messages.AvId.flags] = messages.AvFlags.constrained
1315
1316 actual = target_info.pack()
1317
1318 assert (
1319 actual == b"\x07\x00\x08\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1320 b"\x08\x00\x30\x00"
1321 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1322 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1323 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1324 b"\x03\x00\x12\x00"
1325 b"\x63\x00\x61\x00\x66\x00\xE9\x00\x2D\x00\x68\x00\x6F\x00\x73\x00"
1326 b"\x74\x00"
1327 b"\x0A\x00\x10\x00"
1328 b"\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF"
1329 b"\x06\x00\x04\x00"
1330 b"\x01\x00\x00\x00"
1331 b"\x00\x00\x00\x00"
1332 )
1333
1334
1335 def test_target_info_unpack():
1336 actual = messages.TargetInfo.unpack(
1337 b"\x07\x00\x08\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1338 b"\x08\x00\x30\x00"
1339 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1340 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1341 b"\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
1342 b"\x03\x00\x12\x00"
1343 b"\x63\x00\x61\x00\x66\x00\xE9\x00\x2D\x00\x68\x00\x6F\x00\x73\x00"
1344 b"\x74\x00"
1345 b"\x0A\x00\x10\x00"
1346 b"\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF"
1347 b"\x06\x00\x04\x00"
1348 b"\x01\x00\x00\x00"
1349 b"\x00\x00\x00\x00"
1350 )
1351
1352 assert isinstance(actual, messages.TargetInfo)
1353 assert len(actual) == 6
1354 assert actual[messages.AvId.timestamp] == messages.FileTime.unpack(b"\x00" * 8)
1355 assert actual[messages.AvId.single_host] == messages.SingleHost.unpack(b"\x00" * 48)
1356 assert actual[messages.AvId.dns_computer_name] == "caf\u00e9-host"
1357 assert actual[messages.AvId.channel_bindings] == b"\xFF" * 16
1358 assert actual[messages.AvId.flags] == messages.AvFlags.constrained
1359 assert actual[messages.AvId.eol] == b""
1360
1361
1362 def test_single_host_pack():
1363 single_host = messages.SingleHost(size=4, z4=0, custom_data=b"\x01" * 8, machine_id=b"\x02" * 32)
1364 actual = single_host.pack()
1365
1366 assert (
1367 actual == b"\x04\x00\x00\x00\x00\x00\x00\x00\x01\x01\x01\x01\x01\x01\x01\x01"
1368 b"\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02"
1369 b"\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02"
1370 )
1371
1372
1373 def test_single_host_defaults():
1374 actual = messages.SingleHost()
1375
1376 assert actual.size == 0
1377 assert actual.z4 == 0
1378 assert actual.custom_data == b"\x00" * 8
1379 assert actual.machine_id == b"\x00" * 32
1380
1381
1382 def test_single_host_invalid_size():
1383 with pytest.raises(ValueError, match="SingleHost bytes must have a length of 48"):
1384 messages.SingleHost.unpack(b_data=b"\x00")
1385
1386
1387 def test_single_host_invalid_custom_data_size():
1388 single_host = messages.SingleHost()
1389
1390 with pytest.raises(ValueError, match="custom_data length must be 8 bytes long"):
1391 single_host.custom_data = b"\x00"
1392
1393
1394 def test_single_host_invalid_machine_id_size():
1395 single_host = messages.SingleHost()
1396
1397 with pytest.raises(ValueError, match="machine_id length must be 32 bytes long"):
1398 single_host.machine_id = b"\x00"
1399
1400
1401 def test_single_host_unpack():
1402 actual = messages.SingleHost.unpack(
1403 b"\x04\x00\x00\x00\x00\x00\x00\x00\x01\x01\x01\x01\x01\x01\x01\x01"
1404 b"\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02"
1405 b"\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02\x02"
1406 )
1407
1408 assert isinstance(actual, messages.SingleHost)
1409 assert actual.size == 4
1410 assert actual.z4 == 0
1411 assert actual.custom_data == b"\x01" * 8
1412 assert actual.machine_id == b"\x02" * 32
1413
1414
1415 def test_single_host_eq():
1416 assert messages.SingleHost.unpack(b"\x00" * 48) == b"\x00" * 48
1417 assert messages.SingleHost.unpack(b"\x00" * 48) != b"\x11" * 48
1418 assert messages.SingleHost.unpack(b"\x00" * 48) != 1
1419 assert messages.SingleHost.unpack(b"\x00" * 48) == messages.SingleHost.unpack(b"\x00" * 48)
1420
1421
1422 def test_version_pack():
1423 version = messages.Version(major=1, minor=2, build=3, revision=4)
1424 assert version.major == 1
1425 assert version.minor == 2
1426 assert version.build == 3
1427 assert version.revision == 4
1428 assert len(version) == 8
1429
1430 version.major = 1
1431 version.minor = 1
1432 version.build = 1
1433 version.revision = 10
1434 actual = version.pack()
1435
1436 assert actual == b"\x01\x01\x01\x00\x00\x00\x00\x0A"
1437
1438
1439 def test_version_defaults():
1440 version = messages.Version()
1441
1442 assert version.major == 0
1443 assert version.minor == 0
1444 assert version.build == 0
1445 assert version.reserved == b"\x00\x00\x00"
1446 assert version.revision == 15
1447 assert len(version) == 8
1448
1449
1450 def test_version_unpack():
1451 actual = messages.Version.unpack(b"\x01\x01\x01\x00\x00\x00\x00\x0F")
1452
1453 assert isinstance(actual, messages.Version)
1454 assert str(actual) == "1.1.1.15"
1455 assert repr(actual) == "<spnego._ntlm_raw.messages.Version 1.1.1.15>"
1456 assert actual.major == 1
1457 assert actual.minor == 1
1458 assert actual.build == 1
1459 assert actual.reserved == b"\x00\x00\x00"
1460 assert actual.revision == 15
1461 assert len(actual) == 8
1462
1463
1464 def test_version_unpack_incorrect_length():
1465 with pytest.raises(ValueError, match="Version bytes must have a length of 8"):
1466 messages.Version.unpack(b"\x00")
1467
1468
1469 def test_version_get_current():
1470 actual = messages.Version.get_current()
1471
1472 assert isinstance(actual, messages.Version)
1473 assert len(actual) == 8
1474 assert len(actual.pack()) == 8
1475
1476
1477 @pytest.mark.parametrize(
1478 "version, major, minor, build",
1479 [
1480 ("0.1.0.dev1", 0, 1, 0),
1481 ("0.1.0b1", 0, 1, 0),
1482 ("0.1.10b1", 0, 1, 10),
1483 ("0.1.0a1", 0, 1, 0),
1484 ("0.1.0", 0, 1, 0),
1485 ("0", 0, 0, 0),
1486 ("1", 1, 0, 0),
1487 ("1.2", 1, 2, 0),
1488 ("1..", 1, 0, 0),
1489 ],
1490 )
1491 def test_version_get_current_formats(version, major, minor, build, monkeypatch):
1492 monkeypatch.setattr(messages, "pyspnego_version", version)
1493
1494 actual = messages.Version.get_current()
1495 assert actual.major == major
1496 assert actual.minor == minor
1497 assert actual.build == build
1498
1499
1500 def test_version_eq():
1501 assert messages.Version.get_current() != messages.Version()
1502 assert messages.Version() == b"\x00" * 7 + b"\x0F"
1503 assert messages.Version() != b"\x11" * 8
1504 assert messages.Version() != 1
1505 assert messages.Version.get_current() == messages.Version.get_current()