3
0

PortscanAttack.py 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248
  1. import logging
  2. import random as rnd
  3. import lea
  4. import scapy.layers.inet as inet
  5. import Attack.AttackParameters as atkParam
  6. import Attack.BaseAttack as BaseAttack
  7. import ID2TLib.Utility as Util
  8. logging.getLogger("scapy.runtime").setLevel(logging.ERROR)
  9. # noinspection PyPep8
  10. class PortscanAttack(BaseAttack.BaseAttack):
  11. def __init__(self):
  12. """
  13. Creates a new instance of the PortscanAttack.
  14. This attack injects TCP Syn-requests and respective responses into the output pcap file.
  15. """
  16. # Initialize attack
  17. super(PortscanAttack, self).__init__("Portscan Attack", "Injects a nmap 'regular scan'",
  18. "Scanning/Probing")
  19. # Define allowed parameters and their type
  20. self.supported_params.update({
  21. atkParam.Parameter.IP_SOURCE: atkParam.ParameterTypes.TYPE_IP_ADDRESS,
  22. atkParam.Parameter.IP_DESTINATION: atkParam.ParameterTypes.TYPE_IP_ADDRESS,
  23. atkParam.Parameter.PORT_SOURCE: atkParam.ParameterTypes.TYPE_PORT,
  24. atkParam.Parameter.PORT_DESTINATION: atkParam.ParameterTypes.TYPE_PORT,
  25. atkParam.Parameter.PORT_OPEN: atkParam.ParameterTypes.TYPE_PORT,
  26. atkParam.Parameter.MAC_SOURCE: atkParam.ParameterTypes.TYPE_MAC_ADDRESS,
  27. atkParam.Parameter.MAC_DESTINATION: atkParam.ParameterTypes.TYPE_MAC_ADDRESS,
  28. atkParam.Parameter.INJECT_AT_TIMESTAMP: atkParam.ParameterTypes.TYPE_FLOAT,
  29. atkParam.Parameter.INJECT_AFTER_PACKET: atkParam.ParameterTypes.TYPE_PACKET_POSITION,
  30. atkParam.Parameter.PORT_DEST_SHUFFLE: atkParam.ParameterTypes.TYPE_BOOLEAN,
  31. atkParam.Parameter.PORT_DEST_ORDER_DESC: atkParam.ParameterTypes.TYPE_BOOLEAN,
  32. atkParam.Parameter.IP_SOURCE_RANDOMIZE: atkParam.ParameterTypes.TYPE_BOOLEAN,
  33. atkParam.Parameter.PACKETS_PER_SECOND: atkParam.ParameterTypes.TYPE_FLOAT,
  34. atkParam.Parameter.PORT_SOURCE_RANDOMIZE: atkParam.ParameterTypes.TYPE_BOOLEAN
  35. })
  36. def init_params(self):
  37. """
  38. Initialize the parameters of this attack using the user supplied command line parameters.
  39. Use the provided statistics to calculate default parameters and to process user
  40. supplied queries.
  41. """
  42. # PARAMETERS: initialize with default values
  43. # (values are overwritten if user specifies them)
  44. most_used_ip_address = self.statistics.get_most_used_ip_address()
  45. self.add_param_value(atkParam.Parameter.IP_SOURCE, most_used_ip_address)
  46. self.add_param_value(atkParam.Parameter.IP_SOURCE_RANDOMIZE, 'False')
  47. self.add_param_value(atkParam.Parameter.MAC_SOURCE, self.statistics.get_mac_address(most_used_ip_address))
  48. random_ip_address = self.statistics.get_random_ip_address()
  49. # ip.dst should be valid and not equal to ip.src
  50. while not self.is_valid_ip_address(random_ip_address) or random_ip_address == most_used_ip_address:
  51. random_ip_address = self.statistics.get_random_ip_address()
  52. self.add_param_value(atkParam.Parameter.IP_DESTINATION, random_ip_address)
  53. destination_mac = self.statistics.get_mac_address(random_ip_address)
  54. if isinstance(destination_mac, list) and len(destination_mac) == 0:
  55. destination_mac = self.generate_random_mac_address()
  56. self.add_param_value(atkParam.Parameter.MAC_DESTINATION, destination_mac)
  57. self.add_param_value(atkParam.Parameter.PORT_DESTINATION, self.get_ports_from_nmap_service_dst(1000))
  58. self.add_param_value(atkParam.Parameter.PORT_OPEN, '1')
  59. self.add_param_value(atkParam.Parameter.PORT_DEST_SHUFFLE, 'False')
  60. self.add_param_value(atkParam.Parameter.PORT_DEST_ORDER_DESC, 'False')
  61. self.add_param_value(atkParam.Parameter.PORT_SOURCE, rnd.randint(1024, 65535))
  62. self.add_param_value(atkParam.Parameter.PORT_SOURCE_RANDOMIZE, 'False')
  63. self.add_param_value(atkParam.Parameter.PACKETS_PER_SECOND,
  64. (self.statistics.get_pps_sent(most_used_ip_address) +
  65. self.statistics.get_pps_received(most_used_ip_address)) / 2)
  66. self.add_param_value(atkParam.Parameter.INJECT_AFTER_PACKET, rnd.randint(0, self.statistics.get_packet_count()))
  67. def generate_attack_packets(self):
  68. """
  69. Creates the attack packets.
  70. """
  71. mac_source = self.get_param_value(atkParam.Parameter.MAC_SOURCE)
  72. mac_destination = self.get_param_value(atkParam.Parameter.MAC_DESTINATION)
  73. pps = self.get_param_value(atkParam.Parameter.PACKETS_PER_SECOND)
  74. # Calculate complement packet rates of the background traffic for each interval
  75. complement_interval_pps = self.statistics.calculate_complement_packet_rates(pps)
  76. # Determine ports
  77. dest_ports = self.get_param_value(atkParam.Parameter.PORT_DESTINATION)
  78. if self.get_param_value(atkParam.Parameter.PORT_DEST_ORDER_DESC):
  79. dest_ports.reverse()
  80. elif self.get_param_value(atkParam.Parameter.PORT_DEST_SHUFFLE):
  81. rnd.shuffle(dest_ports)
  82. if self.get_param_value(atkParam.Parameter.PORT_SOURCE_RANDOMIZE):
  83. # FIXME: why is sport never used?
  84. sport = rnd.randint(1, 65535)
  85. else:
  86. sport = self.get_param_value(atkParam.Parameter.PORT_SOURCE)
  87. # Timestamp
  88. timestamp_next_pkt = self.get_param_value(atkParam.Parameter.INJECT_AT_TIMESTAMP)
  89. # store start time of attack
  90. self.attack_start_utime = timestamp_next_pkt
  91. timestamp_prv_reply, timestamp_confirm = 0, 0
  92. # Initialize parameters
  93. self.packets = []
  94. ip_source = self.get_param_value(atkParam.Parameter.IP_SOURCE)
  95. if isinstance(ip_source, list):
  96. ip_source = ip_source[0]
  97. ip_destination = self.get_param_value(atkParam.Parameter.IP_DESTINATION)
  98. if isinstance(ip_destination, list):
  99. ip_destination = ip_destination[0]
  100. # Check ip.src == ip.dst
  101. self.ip_src_dst_equal_check(ip_source, ip_destination)
  102. # Select open ports
  103. ports_open = self.get_param_value(atkParam.Parameter.PORT_OPEN)
  104. if ports_open == 1: # user did not specify open ports
  105. # the ports that were already used by ip.dst (direction in) in the background traffic are open ports
  106. ports_used_by_ip_dst = self.statistics.process_db_query(
  107. "SELECT portNumber FROM ip_ports WHERE portDirection='in' AND ipAddress='" + ip_destination + "'")
  108. if ports_used_by_ip_dst:
  109. ports_open = ports_used_by_ip_dst
  110. else: # if no ports were retrieved from database
  111. # Take open ports from nmap-service file
  112. # ports_temp = self.get_ports_from_nmap_service_dst(100)
  113. # ports_open = ports_temp[0:rnd.randint(1,10)]
  114. # OR take open ports from the most used ports in traffic statistics
  115. ports_open = self.statistics.process_db_query(
  116. "SELECT portNumber FROM ip_ports GROUP BY portNumber ORDER BY SUM(portCount) DESC LIMIT " + str(
  117. rnd.randint(1, 10)))
  118. # in case of one open port, convert ports_open to array
  119. if not isinstance(ports_open, list):
  120. ports_open = [ports_open]
  121. # Set MSS (Maximum Segment Size) based on MSS distribution of IP address
  122. source_mss_dist = self.statistics.get_mss_distribution(ip_source)
  123. if len(source_mss_dist) > 0:
  124. source_mss_prob_dict = lea.Lea.fromValFreqsDict(source_mss_dist)
  125. source_mss_value = source_mss_prob_dict.random()
  126. else:
  127. source_mss_value = Util.handle_most_used_outputs(self.statistics.get_most_used_mss_value())
  128. destination_mss_dist = self.statistics.get_mss_distribution(ip_destination)
  129. if len(destination_mss_dist) > 0:
  130. destination_mss_prob_dict = lea.Lea.fromValFreqsDict(destination_mss_dist)
  131. destination_mss_value = destination_mss_prob_dict.random()
  132. else:
  133. destination_mss_value = Util.handle_most_used_outputs(self.statistics.get_most_used_mss_value())
  134. # Set TTL based on TTL distribution of IP address
  135. source_ttl_dist = self.statistics.get_ttl_distribution(ip_source)
  136. if len(source_ttl_dist) > 0:
  137. source_ttl_prob_dict = lea.Lea.fromValFreqsDict(source_ttl_dist)
  138. source_ttl_value = source_ttl_prob_dict.random()
  139. else:
  140. source_ttl_value = Util.handle_most_used_outputs(self.statistics.get_most_used_ttl_value())
  141. destination_ttl_dist = self.statistics.get_ttl_distribution(ip_destination)
  142. if len(destination_ttl_dist) > 0:
  143. destination_ttl_prob_dict = lea.Lea.fromValFreqsDict(destination_ttl_dist)
  144. destination_ttl_value = destination_ttl_prob_dict.random()
  145. else:
  146. destination_ttl_value = Util.handle_most_used_outputs(self.statistics.get_most_used_ttl_value())
  147. # Set Window Size based on Window Size distribution of IP address
  148. source_win_dist = self.statistics.get_win_distribution(ip_source)
  149. if len(source_win_dist) > 0:
  150. source_win_prob_dict = lea.Lea.fromValFreqsDict(source_win_dist)
  151. source_win_value = source_win_prob_dict.random()
  152. else:
  153. source_win_value = Util.handle_most_used_outputs(self.statistics.get_most_used_win_size())
  154. destination_win_dist = self.statistics.get_win_distribution(ip_destination)
  155. if len(destination_win_dist) > 0:
  156. destination_win_prob_dict = lea.Lea.fromValFreqsDict(destination_win_dist)
  157. destination_win_value = destination_win_prob_dict.random()
  158. else:
  159. destination_win_value = Util.handle_most_used_outputs(self.statistics.get_most_used_win_size())
  160. min_delay, max_delay = self.get_reply_delay(ip_destination)
  161. for dport in dest_ports:
  162. # Parameters changing each iteration
  163. if self.get_param_value(atkParam.Parameter.IP_SOURCE_RANDOMIZE) and isinstance(ip_source, list):
  164. ip_source = rnd.choice(ip_source)
  165. # 1) Build request package
  166. request_ether = inet.Ether(src=mac_source, dst=mac_destination)
  167. request_ip = inet.IP(src=ip_source, dst=ip_destination, ttl=source_ttl_value)
  168. # Random src port for each packet
  169. sport = rnd.randint(1, 65535)
  170. request_tcp = inet.TCP(sport=sport, dport=dport, window=source_win_value, flags='S',
  171. options=[('MSS', source_mss_value)])
  172. request = (request_ether / request_ip / request_tcp)
  173. request.time = timestamp_next_pkt
  174. # Append request
  175. self.packets.append(request)
  176. # 2) Build reply (for open ports) package
  177. if dport in ports_open: # destination port is OPEN
  178. reply_ether = inet.Ether(src=mac_destination, dst=mac_source)
  179. reply_ip = inet.IP(src=ip_destination, dst=ip_source, ttl=destination_ttl_value, flags='DF')
  180. reply_tcp = inet.TCP(sport=dport, dport=sport, seq=0, ack=1, flags='SA', window=destination_win_value,
  181. options=[('MSS', destination_mss_value)])
  182. reply = (reply_ether / reply_ip / reply_tcp)
  183. timestamp_reply = Util.update_timestamp(timestamp_next_pkt, pps, min_delay)
  184. while timestamp_reply <= timestamp_prv_reply:
  185. timestamp_reply = Util.update_timestamp(timestamp_prv_reply, pps, min_delay)
  186. timestamp_prv_reply = timestamp_reply
  187. reply.time = timestamp_reply
  188. self.packets.append(reply)
  189. # requester confirms
  190. confirm_ether = request_ether
  191. confirm_ip = request_ip
  192. confirm_tcp = inet.TCP(sport=sport, dport=dport, seq=1, window=0, flags='R')
  193. confirm = (confirm_ether / confirm_ip / confirm_tcp)
  194. timestamp_confirm = Util.update_timestamp(timestamp_reply, pps, min_delay)
  195. confirm.time = timestamp_confirm
  196. self.packets.append(confirm)
  197. # else: destination port is NOT OPEN -> no reply is sent by target
  198. pps = max(Util.get_interval_pps(complement_interval_pps, timestamp_next_pkt), 10)
  199. timestamp_next_pkt = Util.update_timestamp(timestamp_next_pkt, pps)
  200. def generate_attack_pcap(self):
  201. """
  202. Creates a pcap containing the attack packets.
  203. :return: The location of the generated pcap file.
  204. """
  205. # store end time of attack
  206. self.attack_end_utime = self.packets[-1].time
  207. # write attack packets to pcap
  208. pcap_path = self.write_attack_pcap(sorted(self.packets, key=lambda pkt: pkt.time))
  209. # return packets sorted by packet time_sec_start
  210. return len(self.packets), pcap_path