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
|
#!/usr/bin/python
# -*- coding: utf-8 -*-
# server_dhcp.py by Jonas "j" Lindstad for The Gathering tech:server 2015
# Used to configure the Juniper EX2200 edge switches with Zero Touch Protocol
# License: GPLv2
# Based on the work of psychomario - https://github.com/psychomario
import socket, binascii, time, IN, sys
from module_craft_option import craft_option
# from sys import exit
# from optparse import OptionParser
if not hasattr(IN,"SO_BINDTODEVICE"):
IN.SO_BINDTODEVICE = 25 #http://stackoverflow.com/a/8437870/541038
options_raw = {} # TODO - not a nice way to do things
# Length of DHCP fields in octets, and their placement in packet.
# Ref: http://4.bp.blogspot.com/-IyYoFjAC4l8/UXuo16a3sII/AAAAAAAAAXQ/b6BojbYXoXg/s1600/DHCPTitle.JPG
# 0 OP - 1
# 1 HTYPE - 1
# 2 HLEN - 1
# 3 HOPS - 1
# 4 XID - 4
# 5 SECS - 2
# 6 FLAGS - 2
# 7 CIADDR - 4
# 8 YIADDR - 4
# 9 SIADDR - 4
# 10 GIADDR - 4
# 11 CHADDR - 6
# 12 MAGIC COOKIE - 10
# 13 PADDING - 192 octets of 0's
# 14 MAGIC COOKIE - 4
# 15 OPTIONS - variable length
#############
# FUNCTIONS #
#############
#generator for each of the dhcp fields
def slicendice(msg,slices):
for x in slices:
yield msg[:x]
msg = msg[x:]
# Splits a chunk of hex into a list of hex. (0123456789abcdef => ['01', '23', '45', '67', '89', 'ab', 'cd', 'ef'])
def chunk_hex(hex):
return [hex[i:i+2] for i in range(0, len(hex), 2)]
# Convert hex IP to string with formated decimal IP. (0a0000ff => 10.0.0.255)
def hex_ip_to_str(hex_ip):
return '.'.join(str(y) for y in map(lambda x: int(x, 16), chunk_hex(hex_ip))) # cast int to str for join
# formats a MAC address in the format "b827eb9a520f" to "b8:27:eb:9a:52:0f"
def format_hex_mac(hex_mac):
return ':'.join(str(x) for x in chunk_hex(hex_mac))
# Parses DHCP options - raw = hex options
def parse_options(raw):
print(' --> processing DHCP options')
chunked = chunk_hex(raw)
chunked_length = len(chunked)
pointer = 0 # counter - next option start
options = {} # options dataset
global options_raw
options_raw = {} # incomming request's options
special_options = [53, 82]
while True:
option = int(chunked[pointer], 16) # option ID (0 => 255)
code = int(chunked[pointer], 16) # option code (0 => 255) # New int for options' ID with correct name. Replaces $option
length = int(chunked[pointer+1], 16) # option length
option_payload = raw[((pointer+2)*2):((pointer+length+2)*2)] # Contains the payload of the option - without option ID and length
options_raw[code] = option_payload # copying incomming request's options, directly usable in outgoing replies
asciivalue = binascii.unhexlify(option_payload) # should not contain unreadable characters
if option in special_options:
if option is 82:
option82_raw = option_payload
options[option] = parse_suboptions(option, option_payload)
elif option is 53:
# options[option] = 1 # Not adding DHCP DISCOVER to the options list, becouse it will not be used further on
if int(chunked[pointer+2], 16) is 1:
print(' --> option: %s: %s' % (option, 'DHCP Discover (will not be used in reply)'))
else:
print(' --> option: %s: %s' % (option, asciivalue))
else:
options[option] = asciivalue
print(' --> option: %s: %s' % (option, asciivalue))
pointer = pointer + length + 2 # place pointer at the next options' option ID/code field
if int(chunked[pointer], 16) is 255: # end of DHCP options - allways last field
print(' --> finished processing options')
break
return options
# Parses suboptions
def parse_suboptions(option, raw):
print(' --> processing suboption hook for option %s' % option)
chunked = chunk_hex(raw)
chunked_length = len(chunked)
pointer = 0 # counter - next option start
dataset = {}
while True:
length = int(chunked[pointer+1], 16) # option length
value = raw[2:(length+2)].strip()
print(' --> suboption %s found - value: "%s"' % (int(chunked[0], 16), value))
dataset[int(chunked[0], 16)] = value
pointer = pointer + length + 2 # place pointer at the next options' option ID/code field
if pointer not in chunked: # end of DHCP options - allways last field
print(' --> finished processing suboption %s' % option)
break
return dataset
# Parses and handles DHCP DISCOVER or DHCP REQUEST
def reqparse(message):
data=None
dhcpfields=[1,1,1,1,4,2,2,4,4,4,4,6,10,192,4,message.rfind(b'\xff'),1]
hexmessage=binascii.hexlify(message)
messagesplit=[binascii.hexlify(x) for x in slicendice(message,dhcpfields)]
# hard coded option 43 - for testing purposes
option43 = {
'length': hex(30),
'value': '01162f746731352d656467652f746573742e636f6e666967030468747470'
}
# Test parsing
options = parse_options(b'3501013c3c4a756e697065722d6578323230302d632d3132742d3267000000000000000000000000000000000000000000000000000000000000000000000000005222012064697374726f2d746573743a67652d302f302f302e303a626f6f747374726170ff')
if int(messagesplit[10]) is not 0:
print('DHCP packet forwarded by relay %s' % hex_ip_to_str(messagesplit[10]))
else:
print('DHCP packet not forwarded - direct request')
if messagesplit[15][:6] == b'350101': # option 53 (should allways be the first option in DISCOVER/REQUEST) - identifies DHCP packet type - discover/request/offer/ack++
print('\n\nDHCP DISCOVER - client MAC %s' % format_hex_mac(messagesplit[11]))
print(' --> crafting DHCP OFFER response')
lease = getlease(messagesplit[11].decode()) # Decodes MAC address
# DHCP OFFER details - Options
data = b'\x02' # Message type - boot reply
data += b'\x01' # Hardware type - ethernet
data += b'\x06' # Hardware address length - 6 octets for MAC
data += b'\x00' # Hops
data += binascii.unhexlify(messagesplit[4]) # XID / Transaction ID
data += b'\x00\x01' # seconds elapsed - 1 second
data += b'\x80\x00' # BOOTP flags - broadcast (unicast: 0x0000)
data += b'\x00'*4 # Client IP address
data += socket.inet_aton(lease) # New IP to client
data += socket.inet_aton(address) # Next server IP addres - self
data += binascii.unhexlify(messagesplit[10]) # Relay agent IP - DHCP forwarder
data += binascii.unhexlify(messagesplit[11]) # Client MAC
data += b'\x00'*202 # Client hardware address padding (10) + Server hostname (64) + Boot file name (128)
data += b'\x63\x82\x53\x63' # Magic cookie
# DHCP Options - ordered by pcapng "proof of concept" file
data += craft_option(53).raw_hex(b'\x02') # Option 53 - DHCP OFFER
elif messagesplit[15][:6] == b'350103':
print('\n\nDHCP REQUEST - client MAC %s' % format_hex_mac(messagesplit[11]))
print(' --> crafting DHCP ACK response')
data = b'\x02' # Message type - boot reply
data += b'\x01' # Hardware type - ethernet
data += b'\x06' # Hardware address length - 6 octets for MAC
data += b'\x00' # Hops
data += binascii.unhexlify(messagesplit[4]) # XID / Transaction ID
data += b'\x00\x01' # seconds elapsed - 1 second
data += b'\x80\x00' # BOOTP flags - broadcast (unicast: 0x0000)
data += b'\x00'*4 # Client IP address
data += binascii.unhexlify(messagesplit[8]) # New IP to client
data += socket.inet_aton(address) # Next server IP addres - self
data += binascii.unhexlify(messagesplit[10]) # Relay agent IP - DHCP forwarder
data += binascii.unhexlify(messagesplit[11]) # Client MAC
data += b'\x00'*202 # Client hardware address padding (10) + Server hostname (64) + Boot file name (128)
data += b'\x63\x82\x53\x63' # Magic cookie
# DHCP Options - ordered by pcapng "proof of concept" file
data += b'\x35\x01\05' # Option 53 - DHCP ACK
else:
print('Unexpected DHCP option 53 - stopping processing request')
return None
# common options for both DHCP REPLY and DHCP ACK - should be most of the options
data += craft_option(54).bytes(socket.inet_aton(address)) # Option 54 - DHCP server identifier
data += craft_option(51).raw_hex(b'\x00\x00\xff\x00') # Option 51 - Lease time left padded with "0"
data += craft_option(1).ip(netmask) # Option 1 - Subnet mask
# Set option 3 - default gateway. Only applicable if messagesplit[10] (DHCP forwarder (GIADDR)) is set
if messagesplit[10] is not b'00000000':
data += craft_option(3).bytes(messagesplit[10]) # Option 3 - Default gateway (set to DHCP forwarders IP)
else:
data += craft_option(3).bytes(socket.inet_aton(address)) # Option 3 - Default gateway (set to DHCP servers IP)
data += craft_option(43).raw_hex(binascii.unhexlify(option43['value'])) # Option 43 - ZTP
data += craft_option(150).bytes(socket.inet_aton(address)) # Option 150 - TFTP Server
# data += '\x03\x04' + option82_raw # Option 82 - with suboptions
data += b'\xff'
return data
def release(): #release a lease after timelimit has expired
for lease in leases:
if not lease[1]:
if time.time()+leasetime == leasetime:
continue
if lease[-1] > time.time()+leasetime:
print("Released" + lease[0])
lease[1]=False
lease[2]='000000000000'
lease[3]=0
def getlease(hwaddr): #return the lease of mac address, or create if doesn't exist
global leases
for lease in leases:
if hwaddr == lease[2]:
return lease[0]
for lease in leases:
if not lease[1]:
lease[1]=True
lease[2]=hwaddr
lease[3]=time.time()
return lease[0]
if __name__ == "__main__":
interface = b'eth0'
port = 67
address = '10.0.100.2'
offerfrom = '10.0.0.100'
offerto = '10.0.0.150'
broadcast = '10.0.0.255'
netmask = '255.255.255.0'
tftp = address
dns = '8.8.8.8'
gateway = address
leasetime=86400 #int
leases=[] # leases database
#next line creates the (blank) leases table. This probably isn't necessary.
# for ip in ['.'.join(elements_in_address[0:3])+'.'+str(x) for x in range(int(offerfrom[offerfrom.rfind('.')+1:]),int(offerto[offerto.rfind('.')+1:])+1)]:
for octet in range(50):
leases.append(['10.0.0.' + str(octet), False, '000000000000', 0])
# leases.append([ip,False,'000000000000',0])
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) # IPv4 UDP socket
s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
s.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
s.setsockopt(socket.SOL_SOCKET, 25, interface)
s.bind(('', 67))
print('starting main loop')
while 1: #main loop
try:
message, addressf = s.recvfrom(8192)
# print(message)
if message.startswith(b'\x01'): # UDP payload is DHCP request (discover, request, release)
if addressf[0] == '0.0.0.0':
print('DHCP broadcast')
reply_to = '<broadcast>'
else:
print('DHCP unicast - DHCP forwarding')
reply_to = addressf[0]
data=reqparse(message) # Parse the DHCP request
if data:
print(' -- > replying to %s' % reply_to)
# print(b'replying with UDP payload: ' + data)
s.sendto(data, ('<broadcast>', 68)) # Sends reply
release() # update releases table
except KeyboardInterrupt:
exit()
|