AttackParameters.py 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. import enum
  2. class Parameter(enum.Enum):
  3. """
  4. Defines the shortname for attack parameters. The shortname may be used for attack parameter specification
  5. when calling Core via the command line.
  6. """
  7. # recommended type: IP address -------------------------------
  8. IP_SOURCE = 'ip.src' # source IP address(es)
  9. IP_DESTINATION = 'ip.dst' # destination IP address(es)
  10. TARGET_COUNT = "target.count" # count of target IP addresses
  11. IP_DNS = 'ip.dns' # IP address of DNS server
  12. HOSTING_IP = 'hosting.ip' # IP address(es) hosting the vulnerable service
  13. HOSTING_PERCENTAGE = 'hosting.percentage' # percentage of target IPs hosting the vulnerable service
  14. IP_VICTIM = 'ip.victim'
  15. # recommended type: MAC address ------------------------------
  16. MAC_SOURCE = 'mac.src' # MAC address of source
  17. MAC_DESTINATION = 'mac.dst' # MAC address of destination
  18. # recommended type: Port -------------------------------------
  19. PORT_OPEN = 'port.open' # open ports
  20. PORT_DESTINATION = 'port.dst' # destination ports
  21. PORT_SOURCE = 'port.src' # source ports
  22. # recommended type: Integer positive -------------------------
  23. PACKETS_LIMIT = 'packets.limit'
  24. NUMBER_ATTACKERS = 'attackers.count'
  25. ATTACK_DURATION = 'attack.duration' # in seconds
  26. VICTIM_BUFFER = 'victim.buffer' # in packets
  27. TARGET_URI = 'target.uri'
  28. NUMBER_INITIATOR_BOTS = 'bots.count'
  29. INTERVAL_SELECT_START = 'interval.selection.start'
  30. INTERVAL_SELECT_END = 'interval.selection.end'
  31. # recommended type: domain -----------------------------------
  32. TARGET_HOST = 'target.host'
  33. # recommended type: Float ------------------------------------
  34. PACKETS_PER_SECOND = 'packets.per-second' # packets per second
  35. INJECT_PPS = 'inject.pps' # packets per seconds injected by the attack
  36. INJECT_AT_TIMESTAMP = 'inject.at-timestamp' # unix epoch time (seconds.millis) where attack should be injected
  37. # recommended type: Packet Position ----------------------------------
  38. INJECT_AFTER_PACKET = 'inject.after-pkt' # packet after which attack should be injected
  39. # recommended type: boolean --------------------------------
  40. PORT_DEST_SHUFFLE = 'port.dst.shuffle' # shuffles the destination ports if a list of ports is given
  41. PORT_DEST_ORDER_DESC = 'port.dst.order-desc' # uses a descending port order instead of a ascending order
  42. IP_SOURCE_RANDOMIZE = 'ip.src.shuffle' # randomizes the sources IP address if a list of IP addresses is given
  43. PORT_SOURCE_RANDOMIZE = 'port.src.shuffle' # randomizes the source port if a list of sources ports is given
  44. NAT_PRESENT = 'nat.present' # if NAT is active, external computers cannot initiate a communication in MembersMgmtCommAttack
  45. TTL_FROM_CAIDA = 'ttl.from.caida' # if True, TTLs are assigned based on the TTL distributions from the CAIDA dataset
  46. MULTIPORT = "multiport" # select destination port as an ephemeral port if True, calculate the destination port based on the hostname, otherwise
  47. HIDDEN_MARK = "hidden_mark" # indicating if the attack will mark generated packets
  48. # recommended type: Filepath ------------------------------------
  49. FILE_CSV = 'file.csv' # filepath to CSV containing a communication pattern
  50. FILE_XML = 'file.xml' # filepath to XML containing a communication pattern
  51. # recommended type: CommType ------------------------------------
  52. COMM_TYPE = "comm.type" # the locality of bots in botnet communication (e.g. local, external, mixed)
  53. # recommended type: Percentage (0.0-1.0) ------------------------------------
  54. IP_REUSE_TOTAL = 'ip.reuse.total' # percentage of IPs in original PCAP to be reused
  55. IP_REUSE_LOCAL = 'ip.reuse.local' # percentage of private IPs in original PCAP to be reused
  56. IP_REUSE_EXTERNAL = 'ip.reuse.external' # percentage of public IPs in original PCAP to be reused
  57. # recommended type: Positive Integer between 0 and 100 ------------------------------------
  58. PACKET_PADDING = 'packet.padding'
  59. #recommended type: interval selection strategy, i.e. 'random', 'optimal' or 'custom' ------------------------------------
  60. INTERVAL_SELECT_STRATEGY = 'interval.selection.strategy'
  61. PROTOCOL_VERSION = 'protocol.version'
  62. HOSTING_VERSION = 'hosting.version'
  63. SOURCE_PLATFORM = 'src.platform'
  64. CUSTOM_PAYLOAD = 'custom.payload' # custom payload for ftp exploits
  65. CUSTOM_PAYLOAD_FILE = 'custom.payload.file' # file that contains custom payload for ftp exploits
  66. class ParameterTypes(enum.Enum):
  67. """
  68. Defines types for parameters. These types may be used in the specification of allowed parameters within the
  69. individual attack classes. The type is used to verify the validity of the given value.
  70. """
  71. TYPE_IP_ADDRESS = 0
  72. TYPE_MAC_ADDRESS = 1
  73. TYPE_PORT = 2
  74. TYPE_INTEGER_POSITIVE = 3
  75. TYPE_TIMESTAMP = 4
  76. TYPE_BOOLEAN = 5
  77. TYPE_FLOAT = 6
  78. TYPE_PACKET_POSITION = 7 # used to derive timestamp from parameter INJECT_AFTER_PACKET
  79. TYPE_DOMAIN = 8
  80. TYPE_STRING = 9
  81. TYPE_FILEPATH = 10
  82. TYPE_PERCENTAGE = 11
  83. TYPE_PADDING = 12
  84. TYPE_INTERVAL_SELECT_STRAT = 13