Python Sample Exploitation ETL - Revision history

Sam: /* Development and Debugging */

2024-09-11T20:55:28Z

Development and Debugging

2024-09-11T20:55:20Z

Source Code

2024-09-11T20:40:31Z

Development and Debugging

2024-09-11T20:39:39Z

Source Code

2024-01-24T11:26:16Z

2023-08-17T23:54:50Z

Development and Debugging

2023-08-17T23:54:37Z

Source Code

2023-05-25T09:41:05Z

Code Walkthrough

2023-05-25T09:37:39Z

Code Walkthrough

2022-09-17T07:43:40Z

Development and Debugging

@@ Line 96: / Line 96: @@
 import truxton
-def main():
+def main() -> None:
    etl = truxton.etl()

@@ Line 20: / Line 20: @@
 import truxton
-def main():
+def main() -> None:
    etl = truxton.etl()

@@ Line 110: / Line 110: @@
    while message is not None:
-     file_in_truxton = message.file()
+     with message.file() as file_in_truxton:
-    file_in_truxton.seek(5)
+      file_in_truxton.seek(5)
-    next_byte = file_in_truxton.read(1)
+      next_byte = file_in_truxton.read(1)
-    if next_byte[0] == 0x11:
+      if next_byte[0] == 0x11:
-      # Serial Number. The next 8 bytes are a serial number
+        # Serial Number. The next 8 bytes are a serial number
-      file_in_truxton.seek(6)
+        file_in_truxton.seek(6)
-      serial_number = file_in_truxton.read(8)
+        serial_number = file_in_truxton.read(8)
-      artifact = file_in_truxton.newartifact()
+        artifact = file_in_truxton.newartifact()
-      artifact.type = truxton.ENTITY_TYPE_SERIAL_NUMBER
+        artifact.type = truxton.ENTITY_TYPE_SERIAL_NUMBER
-      artifact.value = serial_number.hex()
+        artifact.value = serial_number.hex()
-      artifact.datatype = truxton.DATA_TYPE_uint8_t
+        artifact.datatype = truxton.DATA_TYPE_uint8_t
-      artifact.offset = 6
+        artifact.offset = 6
-      artifact.length = 8
+        artifact.length = 8
-      artifact.save()
+        artifact.save()
      # Pause here until we get another message from the "wiley" message queue

@@ Line 32: / Line 32: @@
    while message is not None:
-     file_in_truxton = message.file()
+     with message.file() as file_in_truxton:
-    file_in_truxton.seek(5)
+      file_in_truxton.seek(5)
-    next_byte = file_in_truxton.read(1)
+      next_byte = file_in_truxton.read(1)
-    if next_byte[0] == 0x11:
+      if next_byte[0] == 0x11:
-      # Serial Number. The next 8 bytes are a serial number
+        # Serial Number. The next 8 bytes are a serial number
-      file_in_truxton.seek(6)
+        file_in_truxton.seek(6)
-      serial_number = file_in_truxton.read(8)
+        serial_number = file_in_truxton.read(8)
-      artifact = file_in_truxton.newartifact()
+        artifact = file_in_truxton.newartifact()
-      artifact.type = truxton.ENTITY_TYPE_SERIAL_NUMBER
+        artifact.type = truxton.ENTITY_TYPE_SERIAL_NUMBER
-      artifact.value = serial_number.hex()
+        artifact.value = serial_number.hex()
-      artifact.datatype = truxton.DATA_TYPE_uint8_t
+        artifact.datatype = truxton.DATA_TYPE_uint8_t
-      artifact.offset = 6
+        artifact.offset = 6
-      artifact.length = 8
+        artifact.length = 8
-      artifact.save()
+        artifact.save()
      # Pause here until we get another message from the "wiley" message queue

@@ Line 1: / Line 1: @@
 This sample shows the steps needed to implement a file exploitation ETL in Truxton.
 You can see this same sample implemented in [[C Sample Exploitation ETL|C]].
 =Sample File Format=

@@ Line 133: / Line 133: @@
 if __name__ == "__main__":
-     main()
+     sys.exit(main())
 </source>

@@ Line 59: / Line 59: @@
 =Code Walkthrough=
-Lines 7-12 setup the ETL. The message queue name will be "wiley", we are an early stage and want to receive Acme files (11111 was chosen as the identifier of Acme files).
+Lines 7-12 setup the ETL. The message queue name will be "wiley", we are an early [[ETL Stages|stage]] and want to receive Acme files (11111 was chosen as the identifier of Acme files).
 Line 14 starts the ETL logic and waits until a message arrives on the "wiley" queue.