From b7b36bb525b97619580641d57ea9050918176e2a Mon Sep 17 00:00:00 2001 From: QuantumEntangledAndy Date: Mon, 19 Apr 2021 14:02:20 +0700 Subject: [PATCH] Updates to protocol and message documentation --- dissector/messages.md | 305 ++++++++++++++++++++++-------------------- dissector/protocol.md | 105 ++++++++++----- 2 files changed, 230 insertions(+), 180 deletions(-) diff --git a/dissector/messages.md b/dissector/messages.md index bddf73d..a2f2a8f 100644 --- a/dissector/messages.md +++ b/dissector/messages.md @@ -5,6 +5,17 @@ This is an attempt to document the BC messages. It is subject to change and some aspects of it may not be correct. Please feel free to submit a PR to improve it. +Message have zero to two payloads. +- The first payload is after the header and before the payload offset + - This payload always contains Extension xml and so is called `Extension` + in this doc +- The second payload is after the payload offset + - This is either Body xml or binary data. + - If it is binary the extension xml will contain the `1` + tag + - This is called `Payload` in this doc + + - 1: Login Legacy - Client @@ -15,7 +26,7 @@ a PR to improve it. |--------------|--------------|----------------|-------------------|---------|---------|---------------| | f0 de bc 0a | 01 00 00 00 | 2c 07 00 00 | 00 00 00 01 | 01 | dc | 14 65 | - - Body + - Payload Body is hash of user 32 bytes and password 32 bytes and then a lot of zero pads @@ -33,7 +44,7 @@ a PR to improve it. |--------------|--------------|----------------|-------------------|---------|---------|---------------| | f0 de bc 0a | 01 00 00 00 | 91 00 00 00 | 00 00 00 01 | 01 | dd | 14 66 | - - Body + - Payload ```xml @@ -55,11 +66,11 @@ a PR to improve it. - Client - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | f0 de bc 0a | 01 00 00 00 | 28 01 00 00 | 00 00 00 01 | 00 00 | 14 64 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -80,11 +91,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | f0 de bc 0a | 01 00 00 00 | 2e 06 00 00 | 00 00 00 01 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -155,7 +166,13 @@ a PR to improve it. - Client - - Binary + - Header + + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | + |--------------|--------------|----------------|-------------------|-------------------|---------------|----------------| + | f0 de bc 0a | 02 00 00 00 | af 00 00 00 | 00 00 00 09 | 00 00 | 14 64 | 00 00 00 00 | + + - Payload ```xml @@ -174,11 +191,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | f0 de bc 0a | 03 00 00 00 | aa 00 00 00 | 00 00 00 09 | 00 00 | 14 64 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -197,11 +214,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | f0 de bc 0a | 03 00 00 00 | 8a 00 00 00 | 00 00 00 09 | c8 00 | 00 00 | 6a 00 00 00 | - - Body + - Extension ```xml @@ -210,7 +227,7 @@ a PR to improve it. ``` - - Binary + - Payload ```hex 31303032200000000009000010050000000F780A06122422780A061224220000 @@ -223,14 +240,14 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | f0 de bc 0a | 03 00 00 00 | e8 5e 00 00 | 00 00 00 09 | c8 00 | 00 00 | 00 00 00 00 | - - Body + - Payload Body is binary. This binary represents an embedded stream which should - be detailed elsewhere. + is detailed in [mediapacket.md](dissector/mediapacket.md). - 4: `` (stop) @@ -238,11 +255,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 04 | 00 00 00 86 | 2b 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -258,7 +275,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 04 | 00 00 00 00 | 2b 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -268,11 +285,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 0a | 00 00 00 68 | 0b 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -285,11 +302,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 0a | 00 00 01 f7 | 0b 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -321,11 +338,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 12 | 00 00 00 a4 | 1e 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -342,7 +359,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 12 | 00 00 00 00 | 1e 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -352,11 +369,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 19 | 00 00 05 c2 | 64 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -365,7 +382,7 @@ a PR to improve it. ``` - - Binary + - Payload ```xml @@ -453,7 +470,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 19 | 00 00 00 00 | 64 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -464,11 +481,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 1a | 00 00 00 68 | 2d 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -481,11 +498,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 1a | 00 00 05 7c | 2d 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -576,7 +593,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 1f | 00 00 00 00 | 05 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -584,12 +601,12 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 1f | 00 00 00 00 | 05 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - **Notes:** The camera will not send message 33 to the client until - after this msg has been recieved + - **Notes:** Some cameras will not send message 33 to the client until + after this msg has been received - 33: `` @@ -597,11 +614,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 21 | 00 00 00 f0 | 05 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -623,11 +640,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 2c | 00 00 00 68 | 30 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -640,11 +657,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 2c | 00 00 01 df | 30 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -676,11 +693,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 2d | 00 00 02 23 | 32 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -689,7 +706,7 @@ a PR to improve it. ``` - - Binary + - Payload ```xml @@ -717,7 +734,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 2d | 00 00 00 00 | 32 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -727,11 +744,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 34 | 00 00 00 68 | 36 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -744,11 +761,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 34 | 00 00 00 96 | 36 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -767,11 +784,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 35 | 00 00 01 d7 | 38 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -780,7 +797,7 @@ a PR to improve it. ``` - - Binary + - Payload ```xml @@ -814,7 +831,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 35 | 00 00 00 00 | 38 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -824,11 +841,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 36 | 00 00 00 68 | 14 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -841,11 +858,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 36 | 00 00 00 ed | 14 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -866,11 +883,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 37 | 00 00 01 3b | 16 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -879,7 +896,7 @@ a PR to improve it. ``` - - Binary + - Payload ```xml @@ -897,7 +914,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 37 | 00 00 00 00 | 16 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -907,11 +924,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 38 | 00 00 00 68 | 1d 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -924,11 +941,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 38 | 00 00 03 61 | 1d 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -976,11 +993,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 39 | 00 00 02 bc | 1f 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -989,7 +1006,7 @@ a PR to improve it. ``` - - Binary + - Payload ```xml @@ -1024,7 +1041,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 39 | 00 00 00 00 | 1f 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -1034,11 +1051,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 3a | 00 00 00 6b | 03 00 00 00 | 00 00 | 64 14 | 00 00 00 6b | - - Body + - Extension ```xml @@ -1051,11 +1068,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 3a | 00 00 03 a4 | 03 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1117,11 +1134,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 43 | 00 00 01 00 | 00 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | - - Body + - Extension ```xml @@ -1140,7 +1157,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 43 | 00 00 00 00 | 00 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -1148,11 +1165,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 43 | 00 00 94 58 | 00 00 00 00 | 00 00 | 64 14 | 00 00 00 6a | - - Body + - Extension ```xml @@ -1161,7 +1178,7 @@ a PR to improve it. ``` - - Binary + - Payload This contains binary data of the file but stops once the message size reaches 38000 bytes and continues in another packet. There does not appear to @@ -1171,7 +1188,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 43 | 00 00 00 00 | 00 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -1183,7 +1200,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 4c | 00 00 00 00 | 22 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1191,11 +1208,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 4c | 00 00 01 69 | 22 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1225,11 +1242,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 4d | 00 00 01 5b | 25 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1257,7 +1274,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 4d | 00 00 00 00 | 14 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -1267,11 +1284,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 4e | 00 00 00 d3 | 1b 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1292,11 +1309,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 4f | 00 00 01 3b | 1b 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1320,7 +1337,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 50 | 00 00 00 00 | 08 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1328,11 +1345,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 50 | 00 00 01 f0 | 08 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1359,11 +1376,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 51 | 00 00 00 68 | 19 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -1376,11 +1393,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 51 | 00 00 04 30 | 19 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1447,11 +1464,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 52 | 00 00 05 da | 1a 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -1460,7 +1477,7 @@ a PR to improve it. ``` - - Binary + - Payload ```xml @@ -1542,7 +1559,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 52 | 00 00 00 00 | 1a 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -1552,7 +1569,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 5d | 00 00 00 00 | 17 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1562,7 +1579,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 66 | 00 00 00 00 | 07 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1570,11 +1587,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 66 | 00 00 00 55 | 07 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1589,7 +1606,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 68 | 00 00 00 00 | 0a 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1597,11 +1614,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 68 | 00 00 01 a5 | 0a 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1632,7 +1649,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 73 | 00 00 00 00 | 0c 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1640,11 +1657,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 73 | 00 00 00 75 | 0c 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1661,11 +1678,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 84 | 00 00 00 68 | 65 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -1678,11 +1695,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 84 | 00 00 05 7c | 65 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1773,7 +1790,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 85 | 00 00 00 00 | 06 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1781,11 +1798,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 85 | 00 00 00 7f | 06 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1803,7 +1820,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 92 | 00 00 00 00 | 04 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1811,11 +1828,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 92 | 00 00 02 fc | 04 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1856,11 +1873,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 97 | 00 00 00 a7 | 02 00 00 00 | 00 00 | 64 14 | 00 00 00 a7 | - - Body + - Extension ```xml @@ -1874,11 +1891,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 97 | 00 00 03 ac | 02 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1923,11 +1940,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 be | 00 00 00 68 | 0d 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -1940,11 +1957,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 be | 00 00 00 86 | 0d 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -1962,7 +1979,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 c0 | 00 00 00 00 | 05 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1970,7 +1987,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 c0 | 00 00 00 00 | 05 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | @@ -1980,7 +1997,7 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 c7 | 00 00 00 00 | 02 00 00 00 | 00 00 | 64 14 | 00 00 00 00 | @@ -1988,11 +2005,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 c7 | 00 00 05 f6 | 02 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -2074,11 +2091,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 d0 | 00 00 00 68 | 2e 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -2091,11 +2108,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 d0 | 00 00 00 c2 | 2e 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | - - Binary + - Payload ```xml @@ -2115,11 +2132,11 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 d1 | 00 00 01 10 | 85 00 00 00 | 00 00 | 64 14 | 00 00 00 68 | - - Body + - Extension ```xml @@ -2128,7 +2145,7 @@ a PR to improve it. ``` - - Binary + - Payload ```xml @@ -2145,6 +2162,6 @@ a PR to improve it. - Header - | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | + | Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | |--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| | 0a bc de f0 | 00 00 00 d1 | 00 00 00 00 | 85 00 00 00 | c8 00 | 00 00 | 00 00 00 00 | diff --git a/dissector/protocol.md b/dissector/protocol.md index 55552f1..058b419 100644 --- a/dissector/protocol.md +++ b/dissector/protocol.md @@ -16,9 +16,9 @@ Each message has the general format: The header has the format: -| magic | message id | message length | encryption offset | encrypt | unknown | message class | -|--------------|--------------|----------------|-------------------|---------|---------|---------------| -| f0 de bc 0a | 01 00 00 00 | 2c 07 00 00 | 00 00 00 01 | 01 | dc | 14 65 | +| magic | message id | message length | encryption offset | encrypt | message class | +|--------------|--------------|----------------|-------------------|------------|---------------| +| f0 de bc 0a | 01 00 00 00 | 2c 07 00 00 | 00 00 00 01 | 01 dc | 14 65 | - Magic 4 bytes - ID 4 bytes @@ -30,9 +30,9 @@ The header has the format: Or -| Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | -|--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| -| f0 de bc 0a | 01 00 00 00 | 28 01 00 00 | 00 00 00 01 | c8 00 | 14 64 | 00 00 00 00 | +| Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | +|--------------|--------------|----------------|-------------------|-------------------|---------------|----------------| +| f0 de bc 0a | 01 00 00 00 | 28 01 00 00 | 00 00 00 01 | c8 00 | 14 64 | 00 00 00 00 | - Magic 4 bytes @@ -97,17 +97,24 @@ message_handle 1 byte - client increments per request, replies use request handl #### Encryption Flag -This flag is 0 for unencrypted or non zero for encrypted. +Client will send the number `0xXXdc` and the server will reply `0xXXdd`. +Where `XX` is one of the following. -Clients should decide to use encryption or not based on this byte that the -camera sent during login. Then should use that same setting for all further -messages with the camera. +- 0 Unencrypted +- 1 BC Encryption +- 2 AES Encryption (Camera) +- 3 AES Encryption (Client) -#### Unknown +`dc` means this encryption protol or lower. So `0x01dc` means BC on no encryption +whereas `0x03dc` means AES, BC or Unencrypted. -The purpose of this byte is unknown. -Observed - `dc` = client request, `dd` = device reply -If you figure out what it does please submit a PR. +`dd` is the reply that the camera sends to the `dc` request. It is the chosen +protocol that will be used. + +**Note:** When requesting AES the client sends `0x03dc` and the camera replies `0x02dc`. +We are not sure why. + +Encryption is negotiated in the login request. #### Status Code @@ -129,20 +136,13 @@ and header lengths are known. - 0x0000: "modern" 24 bytes -#### Binary offset +#### Payload offset -For messages that contain the binary offset field this represents where to start -the binary part of the message. The total length of XML + binary is equal -to the message length in the header so Binary Offset is -total_length - this_offset. Where as this field also represents the end of the -XML part of the message. - -Some messages seems to not set this field correctly. For example message ID 1 -sets this to zero meaning that all data in the message is binary, however -it contains XML. This best way to tell is this is binary or XML is to check the -message ID and determine from there. Alternatively you could look for ` @@ -203,7 +205,7 @@ The reply is first a message with the following xml After which all message bodies of type id 3 are binary. -The binary represents a stream of data. It can be interrupted by packet +The binary represents a stream of data that can be interrupted by packet boundaries. Clients should create a buffer and pop bytes for processing when complete media packets are received. Media packets descriptions can be found in the [docs](dissector/mediapacket.md) @@ -213,9 +215,9 @@ the [docs](dissector/mediapacket.md) Other data can be received from the camera by sending the appropriate header to the camera. For example sending the header for ID 78 -| Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | -|--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| -| f0 de bc 0a | 4e 00 00 00 | d3 00 00 00 | 08 db 9c 00 | c8 00 | 00 00 | 00 00 00 00 | +| Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | +|--------------|--------------|----------------|-------------------|-------------------|---------------|----------------| +| f0 de bc 0a | 4e 00 00 00 | d3 00 00 00 | 08 db 9c 00 | c8 00 | 00 00 | 00 00 00 00 | The camera will reply with an xml with brightness and contrast @@ -236,9 +238,9 @@ Some message IDs also require input along with the request header. For example ID 151 which is the users ability info requires the header -| Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Binary Offset | -|--------------|--------------|----------------|-------------------|-------------------|---------------|---------------| -| f0 de bc 0a | 97 00 00 00 | a7 00 00 00 | 00 00 00 02 | 00 00 | 14 64 | a7 00 00 00 | +| Magic | Message ID | Message Length | Encryption Offset | Status Code | Message Class | Payload Offset | +|--------------|--------------|----------------|-------------------|-------------------|---------------|----------------| +| f0 de bc 0a | 97 00 00 00 | a7 00 00 00 | 00 00 00 02 | 00 00 | 14 64 | a7 00 00 00 | and the body of @@ -255,3 +257,34 @@ abilities you want to know about. Details of expected formats should be found from the [docs](dissector/messages.md) + +#### AES Encryption + +If the encryption flag returned from the camera is `0x02dd` then AES encryption will be used. + +The cameras use AES cfb128 with an IV of `0123456789abcdef` the key is made as follows + +- Concatenated the `NONCE` from login with a `-` then with your plain text password +- MD5 Hash this concatenated string +- Represent the hash as hex string in all caps +- Take the first 16 characters as the encryption key + + +Here is an example: + +```rust +use aes::Aes128; +use cfb_mode::cipher::{NewStreamCipher, StreamCipher}; +use cfb_mode::Cfb; + +const IV: &[u8] = b"0123456789abcdef"; +let key_phrase = format!("{}-{}", nonce, passwd); +let key_phrase_hash = format!("{:X}\0", md5::compute(&key_phrase)) + .to_uppercase() + .into_bytes(); +let key = key_phrase_hash[0..16]; + +let mut decrypted = encrypted.to_vec(); +Cfb::::new(key.into(), IV.into()).decrypt(&mut decrypted); +return decrypted; +```