Repository navigation
SSL & TLS Encoder & Decoder
Olivier Arteau edited this page Aug 26, 2015
·
5 revisions
If you want to automatically fill an object based on serialized data, you can use the method decode of an instance of the object that matches the serialized typed. This will be in almost all cases TLSHeader.
Example :
from tls_attack.structure import *
header = TLSHeader()
header.decode(b'\x16\x03\x03\x00\xdc\x01\x00\x00\xd8\x03\x03\x53\x43\x5b\x90\x9d\x9b\x72\x0b\xbc\x0c\xbc\x2b\x92\xa8\x48\x97\xcf\xbd\x39\x04\xcc\x16\x0a\x85\x03\x90\x9f\x77\x04\x33\xd4\xde\x00\x00\x66\xc0\x14\xc0\x0a\xc0\x22\xc0\x21\x00\x39\x00\x38\x00\x88\x00\x87\xc0\x0f\xc0\x05\x00\x35\x00\x84\xc0\x12\xc0\x08\xc0\x1c\xc0\x1b\x00\x16\x00\x13\xc0\x0d\xc0\x03\x00\x0a\xc0\x13\xc0\x09\xc0\x1f\xc0\x1e\x00\x33\x00\x32\x00\x9a\x00\x99\x00\x45\x00\x44\xc0\x0e\xc0\x04\x00\x2f\x00\x96\x00\x41\xc0\x11\xc0\x07\xc0\x0c\xc0\x02\x00\x05\x00\x04\x00\x15\x00\x12\x00\x09\x00\x14\x00\x11\x00\x08\x00\x06\x00\x03\x00\xff\x01\x00\x00\x49\x00\x0b\x00\x04\x03\x00\x01\x02\x00\x0a\x00\x34\x00\x32\x00\x0e\x00\x0d\x00\x19\x00\x0b\x00\x0c\x00\x18\x00\x09\x00\x0a\x00\x16\x00\x17\x00\x08\x00\x06\x00\x07\x00\x14\x00\x15\x00\x04\x00\x05\x00\x12\x00\x13\x00\x01\x00\x02\x00\x03\x00\x0f\x00\x10\x00\x11\x00\x23\x00\x00\x00\x0f\x00\x01\x01')
print(header)
Output :
TLSHeader {
content_type = 22
version = TLSVersion.TLS12
length = 220
body = TLSHandshake {
[...] Truncating the output [...]
}
}
Structure value can be assigned with the constructor.
Example :
header = TLSHeader (
version = TLSVersion.TLS10,
body = TLSHeartbeat (
heartbeat_type = TLSHeartbeatMessageType.HEARTBEAT_REQUEST,
length = 0x4000,
payload = b""
)
)
If you wish to modify field value after the initialization it's possible to do so by changing the attribute value.
Example :
header.version = TLSVersion.TLS11
When manually filling structure data, you can use the magic class TLSAuto to automatically assign the correct value to a length field or a type field. The correct value will be computed when encoding the structure or displaying it.
Example :
header = TLSHeader (
content_type = TLSAuto(),
version = TLSVersion.TLS10,
body = TLSHeartbeat (
heartbeat_type = TLSHeartbeatMessageType.HEARTBEAT_REQUEST,
length = 0x4000,
payload = b""
)
)
Here content_type will have the value 24 assigned when it's encoded or printed.