1 //-----------------------------------------------------------------------------
2 // Copyright (C) 2010 iZsh <izsh at fail0verflow.com>, Hagen Fritsch
3 // Copyright (C) 2011 Gerhard de Koning Gans
4 // Copyright (C) 2014 Midnitesnake & Andy Davies & Martin Holst Swende
6 // This code is licensed to you under the terms of the GNU GPL, version 2 or,
7 // at your option, any later version. See the LICENSE.txt file for the text of
9 //-----------------------------------------------------------------------------
10 // High frequency iClass commands
11 //-----------------------------------------------------------------------------
17 #include "iso14443crc.h" // Can also be used for iClass, using 0xE012 as CRC-type
19 #include "proxmark3.h"
21 #include "cmdparser.h"
22 #include "cmdhficlass.h"
26 #include "polarssl/des.h"
27 #include "loclass/cipherutils.h"
28 #include "loclass/cipher.h"
29 #include "loclass/ikeys.h"
30 #include "loclass/elite_crack.h"
31 #include "loclass/fileutils.h"
32 #include "protocols.h"
36 static int CmdHelp(const char *Cmd
);
38 #define ICLASS_KEYS_MAX 8
39 static uint8_t iClass_Key_Table
[ICLASS_KEYS_MAX
][8] = {
40 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
41 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
42 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
43 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
44 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
45 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
46 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
47 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }
50 typedef struct iclass_block
{
54 int xorbits_8(uint8_t val
) {
55 uint8_t res
= val
^ (val
>> 1); //1st pass
56 res
= res
^ (res
>> 1); // 2nd pass
57 res
= res
^ (res
>> 2); // 3rd pass
58 res
= res
^ (res
>> 4); // 4th pass
62 int CmdHFiClassList(const char *Cmd
) {
63 PrintAndLog("Deprecated command, use 'hf list iclass' instead");
67 int CmdHFiClassSnoop(const char *Cmd
) {
68 UsbCommand c
= {CMD_SNOOP_ICLASS
};
73 int usage_hf_iclass_sim(void) {
74 PrintAndLog("Usage: hf iclass sim <option> [CSN]");
75 PrintAndLog(" options");
76 PrintAndLog(" 0 <CSN> simulate the given CSN");
77 PrintAndLog(" 1 simulate default CSN");
78 PrintAndLog(" 2 Reader-attack, gather reader responses to extract elite key");
79 PrintAndLog(" 3 Full simulation using emulator memory (see 'hf iclass eload')");
80 PrintAndLog(" example: hf iclass sim 0 031FEC8AF7FF12E0");
81 PrintAndLog(" example: hf iclass sim 2");
82 PrintAndLog(" example: hf iclass eload 'tagdump.bin'");
83 PrintAndLog(" hf iclass sim 3");
88 int CmdHFiClassSim(const char *Cmd
) {
90 uint8_t CSN
[8] = {0, 0, 0, 0, 0, 0, 0, 0};
93 return usage_hf_iclass_sim();
95 simType
= param_get8ex(Cmd
, 0, 0, 10);
99 if (param_gethex(Cmd
, 1, CSN
, 16)) {
100 PrintAndLog("A CSN should consist of 16 HEX symbols");
101 return usage_hf_iclass_sim();
104 PrintAndLog("--simtype:%02x csn:%s", simType
, sprint_hex(CSN
, 8));
108 PrintAndLog("Undefined simptype %d", simType
);
109 return usage_hf_iclass_sim();
112 uint8_t numberOfCSNs
=0;
115 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,NUM_CSNS
}};
116 UsbCommand resp
= {0};
118 uint8_t csns
[8*NUM_CSNS
] = {
119 0x00, 0x0B, 0x0F, 0xFF, 0xF7, 0xFF, 0x12, 0xE0,
120 0x00, 0x04, 0x0E, 0x08, 0xF7, 0xFF, 0x12, 0xE0,
121 0x00, 0x09, 0x0D, 0x05, 0xF7, 0xFF, 0x12, 0xE0,
122 0x00, 0x0A, 0x0C, 0x06, 0xF7, 0xFF, 0x12, 0xE0,
123 0x00, 0x0F, 0x0B, 0x03, 0xF7, 0xFF, 0x12, 0xE0,
124 0x00, 0x08, 0x0A, 0x0C, 0xF7, 0xFF, 0x12, 0xE0,
125 0x00, 0x0D, 0x09, 0x09, 0xF7, 0xFF, 0x12, 0xE0,
126 0x00, 0x0E, 0x08, 0x0A, 0xF7, 0xFF, 0x12, 0xE0,
127 0x00, 0x03, 0x07, 0x17, 0xF7, 0xFF, 0x12, 0xE0,
128 0x00, 0x3C, 0x06, 0xE0, 0xF7, 0xFF, 0x12, 0xE0,
129 0x00, 0x01, 0x05, 0x1D, 0xF7, 0xFF, 0x12, 0xE0,
130 0x00, 0x02, 0x04, 0x1E, 0xF7, 0xFF, 0x12, 0xE0,
131 0x00, 0x07, 0x03, 0x1B, 0xF7, 0xFF, 0x12, 0xE0,
132 0x00, 0x00, 0x02, 0x24, 0xF7, 0xFF, 0x12, 0xE0,
133 0x00, 0x05, 0x01, 0x21, 0xF7, 0xFF, 0x12, 0xE0 };
135 memcpy(c
.d
.asBytes
, csns
, 8*NUM_CSNS
);
138 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, -1)) {
139 PrintAndLog("Command timed out");
143 uint8_t num_mac_responses
= resp
.arg
[1];
144 PrintAndLog("Mac responses: %d MACs obtained (should be %d)", num_mac_responses
,NUM_CSNS
);
146 size_t datalen
= NUM_CSNS
*24;
148 * Now, time to dump to file. We'll use this format:
149 * <8-byte CSN><8-byte CC><4 byte NR><4 byte MAC>....
150 * So, it should wind up as
153 * The returndata from the pm3 is on the following format
154 * <4 byte NR><4 byte MAC>
155 * CC are all zeroes, CSN is the same as was sent in
157 void* dump
= malloc(datalen
);
158 memset(dump
,0,datalen
);//<-- Need zeroes for the CC-field
160 for(i
= 0 ; i
< NUM_CSNS
; i
++)
162 memcpy(dump
+i
*24, csns
+i
*8,8); //CSN
163 //8 zero bytes here...
164 //Then comes NR_MAC (eight bytes from the response)
165 memcpy(dump
+i
*24+16,resp
.d
.asBytes
+i
*8,8);
168 /** Now, save to dumpfile **/
169 saveFile("iclass_mac_attack", "bin", dump
,datalen
);
173 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,numberOfCSNs
}};
174 memcpy(c
.d
.asBytes
, CSN
, 8);
181 int HFiClassReader(const char *Cmd
, bool loop
, bool verbose
) {
182 bool tagFound
= false;
183 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
184 FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_AA
|
185 FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
} };
186 // loop in client not device - else on windows have a communication error
190 if (WaitForResponseTimeout(CMD_ACK
,&resp
, 4500)) {
191 uint8_t readStatus
= resp
.arg
[0] & 0xff;
192 uint8_t *data
= resp
.d
.asBytes
;
194 // no tag found or button pressed
195 if( (readStatus
== 0 && !loop
) || readStatus
== 0xFF) {
197 if (verbose
) PrintAndLog("Quitting...");
201 if( readStatus
& FLAG_ICLASS_READER_CSN
) {
202 PrintAndLog(" CSN: %s",sprint_hex(data
,8));
205 if( readStatus
& FLAG_ICLASS_READER_CC
) {
206 PrintAndLog(" CC: %s",sprint_hex(data
+16,8));
208 if( readStatus
& FLAG_ICLASS_READER_CONF
) {
209 printIclassDumpInfo(data
);
211 if (readStatus
& FLAG_ICLASS_READER_AA
) {
213 PrintAndLog(" AppIA: %s",sprint_hex(data
+8*5,8));
214 for (int i
= 0; i
<8; i
++) {
215 if (data
[8*5+i
] != 0xFF) {
219 PrintAndLog(" : Possible iClass %s",(legacy
) ? "(legacy tag)" : "(NOT legacy tag)");
222 if (tagFound
&& !loop
) return 1;
224 if (verbose
) PrintAndLog("Command execute timeout");
231 int CmdHFiClassReader(const char *Cmd
) {
232 return HFiClassReader(Cmd
, true, true);
235 int CmdHFiClassReader_Replay(const char *Cmd
) {
236 uint8_t readerType
= 0;
237 uint8_t MAC
[4]={0x00, 0x00, 0x00, 0x00};
240 PrintAndLog("Usage: hf iclass replay <MAC>");
241 PrintAndLog(" sample: hf iclass replay 00112233");
245 if (param_gethex(Cmd
, 0, MAC
, 8)) {
246 PrintAndLog("MAC must include 8 HEX symbols");
250 UsbCommand c
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
251 memcpy(c
.d
.asBytes
, MAC
, 4);
257 int iclassEmlSetMem(uint8_t *data
, int blockNum
, int blocksCount
) {
258 UsbCommand c
= {CMD_MIFARE_EML_MEMSET
, {blockNum
, blocksCount
, 0}};
259 memcpy(c
.d
.asBytes
, data
, blocksCount
* 16);
264 int hf_iclass_eload_usage(void) {
265 PrintAndLog("Loads iclass tag-dump into emulator memory on device");
266 PrintAndLog("Usage: hf iclass eload f <filename>");
268 PrintAndLog("Example: hf iclass eload f iclass_tagdump-aa162d30f8ff12f1.bin");
272 int CmdHFiClassELoad(const char *Cmd
) {
274 char opt
= param_getchar(Cmd
, 0);
275 if (strlen(Cmd
)<1 || opt
== 'h')
276 return hf_iclass_eload_usage();
278 //File handling and reading
280 char filename
[FILE_PATH_SIZE
];
281 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
283 f
= fopen(filename
, "rb");
285 return hf_iclass_eload_usage();
289 PrintAndLog("Failed to read from file '%s'", filename
);
293 fseek(f
, 0, SEEK_END
);
294 long fsize
= ftell(f
);
295 fseek(f
, 0, SEEK_SET
);
298 PrintAndLog("Error, when getting filesize");
303 uint8_t *dump
= malloc(fsize
);
305 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
308 printIclassDumpInfo(dump
);
311 if (bytes_read
< fsize
)
313 prnlog("Error, could only read %d bytes (should be %d)",bytes_read
, fsize
);
318 uint32_t bytes_sent
= 0;
319 uint32_t bytes_remaining
= bytes_read
;
321 while(bytes_remaining
> 0){
322 uint32_t bytes_in_packet
= MIN(USB_CMD_DATA_SIZE
, bytes_remaining
);
323 UsbCommand c
= {CMD_ICLASS_EML_MEMSET
, {bytes_sent
,bytes_in_packet
,0}};
324 memcpy(c
.d
.asBytes
, dump
, bytes_in_packet
);
326 bytes_remaining
-= bytes_in_packet
;
327 bytes_sent
+= bytes_in_packet
;
330 PrintAndLog("Sent %d bytes of data to device emulator memory", bytes_sent
);
334 static int readKeyfile(const char *filename
, size_t len
, uint8_t* buffer
) {
335 FILE *f
= fopen(filename
, "rb");
337 PrintAndLog("Failed to read from file '%s'", filename
);
340 fseek(f
, 0, SEEK_END
);
341 long fsize
= ftell(f
);
342 fseek(f
, 0, SEEK_SET
);
343 size_t bytes_read
= fread(buffer
, 1, len
, f
);
347 PrintAndLog("Warning, file size is %d, expected %d", fsize
, len
);
350 if(bytes_read
!= len
)
352 PrintAndLog("Warning, could only read %d bytes, expected %d" ,bytes_read
, len
);
358 int usage_hf_iclass_decrypt(void) {
359 PrintAndLog("Usage: hf iclass decrypt f <tagdump>");
361 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
362 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
364 PrintAndLog("example: hf iclass decrypt f tagdump_12312342343.bin");
366 PrintAndLog("OBS! This is pretty stupid implementation, it tries to decrypt every block after block 6. ");
367 PrintAndLog("Correct behaviour would be to decrypt only the application areas where the key is valid,");
368 PrintAndLog("which is defined by the configuration block.");
372 int CmdHFiClassDecrypt(const char *Cmd
) {
373 uint8_t key
[16] = { 0 };
374 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
376 usage_hf_iclass_decrypt();
379 PrintAndLog("Decryption file found... ");
380 char opt
= param_getchar(Cmd
, 0);
381 if (strlen(Cmd
)<1 || opt
== 'h')
382 return usage_hf_iclass_decrypt();
384 //Open the tagdump-file
386 char filename
[FILE_PATH_SIZE
];
387 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0) {
388 f
= fopen(filename
, "rb");
390 PrintAndLog("Could not find file %s", filename
);
394 return usage_hf_iclass_decrypt();
397 fseek(f
, 0, SEEK_END
);
398 long fsize
= ftell(f
);
399 fseek(f
, 0, SEEK_SET
);
400 uint8_t enc_dump
[8] = {0};
401 uint8_t *decrypted
= malloc(fsize
);
402 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
403 des3_set2key_dec( &ctx
, key
);
404 size_t bytes_read
= fread(enc_dump
, 1, 8, f
);
406 //Use the first block (CSN) for filename
407 char outfilename
[FILE_PATH_SIZE
] = { 0 };
408 snprintf(outfilename
,FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x-decrypted",
409 enc_dump
[0],enc_dump
[1],enc_dump
[2],enc_dump
[3],
410 enc_dump
[4],enc_dump
[5],enc_dump
[6],enc_dump
[7]);
413 while(bytes_read
== 8)
417 memcpy(decrypted
+(blocknum
*8), enc_dump
, 8);
419 des3_crypt_ecb(&ctx
, enc_dump
,decrypted
+(blocknum
*8) );
421 printvar("decrypted block", decrypted
+(blocknum
*8), 8);
422 bytes_read
= fread(enc_dump
, 1, 8, f
);
427 saveFile(outfilename
,"bin", decrypted
, blocknum
*8);
432 int usage_hf_iclass_encrypt(void) {
433 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
435 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
436 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
438 PrintAndLog("example: hf iclass encrypt 0102030405060708");
443 static int iClassEncryptBlkData(uint8_t *blkData
) {
444 uint8_t key
[16] = { 0 };
445 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
447 usage_hf_iclass_encrypt();
450 PrintAndLog("Decryption file found... ");
452 uint8_t encryptedData
[16];
453 uint8_t *encrypted
= encryptedData
;
454 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
455 des3_set2key_enc( &ctx
, key
);
457 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
458 //printvar("decrypted block", decrypted, 8);
459 memcpy(blkData
,encrypted
,8);
464 int CmdHFiClassEncryptBlk(const char *Cmd
) {
465 uint8_t blkData
[8] = {0};
466 char opt
= param_getchar(Cmd
, 0);
467 if (strlen(Cmd
)<1 || opt
== 'h')
468 return usage_hf_iclass_encrypt();
470 //get the bytes to encrypt
471 if (param_gethex(Cmd
, 0, blkData
, 16))
473 PrintAndLog("BlockData must include 16 HEX symbols");
476 if (!iClassEncryptBlkData(blkData
)) return 0;
478 printvar("encrypted block", blkData
, 8);
482 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
485 memcpy(WB
+ 1,data
,8);
486 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
487 //printf("Cal wb mac block [%02x][%02x%02x%02x%02x%02x%02x%02x%02x] : MAC [%02x%02x%02x%02x]",WB[0],WB[1],WB[2],WB[3],WB[4],WB[5],WB[6],WB[7],WB[8],MAC[0],MAC[1],MAC[2],MAC[3]);
490 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
493 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
494 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
496 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
498 clearCommandBuffer();
500 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
502 PrintAndLog("Command execute timeout");
506 uint8_t isOK
= resp
.arg
[0] & 0xff;
507 uint8_t *data
= resp
.d
.asBytes
;
510 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
513 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
516 PrintAndLog("Failed to obtain CC! Aborting");
522 static bool select_and_auth(uint8_t *KEY
, uint8_t *MAC
, uint8_t *div_key
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
523 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
524 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
526 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
531 memcpy(div_key
, KEY
, 8);
533 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
534 PrintAndLog("Authing with %s: %02x%02x%02x%02x%02x%02x%02x%02x", rawkey
? "raw key" : "diversified key", div_key
[0],div_key
[1],div_key
[2],div_key
[3],div_key
[4],div_key
[5],div_key
[6],div_key
[7]);
536 doMAC(CCNR
, div_key
, MAC
);
538 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
539 memcpy(d
.d
.asBytes
, MAC
, 4);
540 clearCommandBuffer();
542 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
544 PrintAndLog("Auth Command execute timeout");
547 uint8_t isOK
= resp
.arg
[0] & 0xff;
549 PrintAndLog("Authentication error");
555 int usage_hf_iclass_dump(void) {
556 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e|r\n");
557 PrintAndLog("Options:");
558 PrintAndLog(" f <filename> : specify a filename to save dump to");
559 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
560 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
561 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
562 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
563 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
564 PrintAndLog(" r : If 'r' is specified, the key is interpreted as raw block 3/4");
565 PrintAndLog(" NOTE: * = required");
566 PrintAndLog("Samples:");
567 PrintAndLog(" hf iclass dump k 001122334455667B");
568 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
569 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
573 int CmdHFiClassReader_Dump(const char *Cmd
) {
575 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
576 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
577 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
581 uint8_t app_areas
= 1;
583 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
584 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
587 uint8_t fileNameLen
= 0;
588 char filename
[FILE_PATH_SIZE
]={0};
589 char tempStr
[50] = {0};
590 bool have_debit_key
= false;
591 bool have_credit_key
= false;
592 bool use_credit_key
= false;
598 while(param_getchar(Cmd
, cmdp
) != 0x00)
600 switch(param_getchar(Cmd
, cmdp
))
604 return usage_hf_iclass_dump();
607 have_credit_key
= true;
608 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
610 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
611 } else if (dataLen
== 1) {
612 keyNbr
= param_get8(Cmd
, cmdp
+1);
613 if (keyNbr
< ICLASS_KEYS_MAX
) {
614 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
616 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
620 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
632 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
633 if (fileNameLen
< 1) {
634 PrintAndLog("No filename found after f");
641 have_debit_key
= true;
642 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
644 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
645 } else if (dataLen
== 1) {
646 keyNbr
= param_get8(Cmd
, cmdp
+1);
647 if (keyNbr
< ICLASS_KEYS_MAX
) {
648 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
650 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
654 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
665 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
669 if(errors
) return usage_hf_iclass_dump();
672 if (cmdp
< 2) return usage_hf_iclass_dump();
673 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
674 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
676 //get config and first 3 blocks
677 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
678 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
680 uint8_t tag_data
[255*8];
682 clearCommandBuffer();
684 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
685 PrintAndLog("Command execute timeout");
689 uint8_t readStatus
= resp
.arg
[0] & 0xff;
690 uint8_t *data
= resp
.d
.asBytes
;
693 PrintAndLog("No tag found...");
697 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
698 memcpy(tag_data
, data
, 8*3);
699 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
701 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
702 // large memory - not able to dump pages currently
703 if (numblks
> maxBlk
) numblks
= maxBlk
;
706 // authenticate debit key and get div_key - later store in dump block 3
707 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
708 //try twice - for some reason it sometimes fails the first time...
709 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
716 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
717 clearCommandBuffer();
719 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
720 PrintAndLog("Command execute time-out 1");
724 uint32_t blocksRead
= resp
.arg
[1];
725 uint8_t isOK
= resp
.arg
[0] & 0xff;
726 if (!isOK
&& !blocksRead
) {
727 PrintAndLog("Read Block Failed");
731 uint32_t startindex
= resp
.arg
[2];
732 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
733 PrintAndLog("Data exceeded Buffer size!");
734 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
736 // response ok - now get bigbuf content of the dump
737 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
738 WaitForResponse(CMD_ACK
,NULL
);
739 size_t gotBytes
= blocksRead
*8 + blockno
*8;
742 if (have_credit_key
) {
743 //turn off hf field before authenticating with different key
746 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
747 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
748 //try twice - for some reason it sometimes fails the first time...
749 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
754 // do we still need to read more block? (aa2 enabled?)
755 if (maxBlk
> blockno
+numblks
+1) {
756 // setup dump and start
757 w
.arg
[0] = blockno
+ blocksRead
;
758 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
759 clearCommandBuffer();
761 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
762 PrintAndLog("Command execute timeout 2");
766 uint8_t isOK
= resp
.arg
[0] & 0xff;
767 blocksRead
= resp
.arg
[1];
768 if (!isOK
&& !blocksRead
) {
769 PrintAndLog("Read Block Failed 2");
774 startindex
= resp
.arg
[2];
775 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
776 PrintAndLog("Data exceeded Buffer size!");
777 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
779 // get dumped data from bigbuf
780 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
781 WaitForResponse(CMD_ACK
,NULL
);
783 gotBytes
+= blocksRead
*8;
784 } else { //field is still on - turn it off...
789 // add diversified keys to dump
790 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
791 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
793 printf("------+--+-------------------------+\n");
794 printf("CSN |00| %s|\n",sprint_hex(tag_data
, 8));
795 printIclassDumpContents(tag_data
, 1, (gotBytes
/8), gotBytes
);
797 if (filename
[0] == 0){
798 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
799 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
800 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
803 // save the dump to .bin file
804 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
805 saveFile(filename
, "bin", tag_data
, gotBytes
);
809 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
810 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
811 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
812 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, verbose
))
817 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
818 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
819 memcpy(w
.d
.asBytes
, bldata
, 8);
820 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
822 clearCommandBuffer();
824 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
826 PrintAndLog("Write Command execute timeout");
829 uint8_t isOK
= resp
.arg
[0] & 0xff;
831 PrintAndLog("Write Block Failed");
834 PrintAndLog("Write Block Successful");
838 int usage_hf_iclass_writeblock(void) {
839 PrintAndLog("Options:");
840 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
841 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
842 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
843 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
844 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
845 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
846 PrintAndLog("Samples:");
847 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
848 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
849 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
853 int CmdHFiClass_WriteBlock(const char *Cmd
) {
855 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
856 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
859 char tempStr
[50] = {0};
860 bool use_credit_key
= false;
865 while(param_getchar(Cmd
, cmdp
) != 0x00)
867 switch(param_getchar(Cmd
, cmdp
))
871 return usage_hf_iclass_writeblock();
874 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
875 PrintAndLog("Block No must include 2 HEX symbols\n");
882 use_credit_key
= true;
887 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
889 PrintAndLog("KEY must include 16 HEX symbols\n");
901 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
903 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
904 } else if (dataLen
== 1) {
905 keyNbr
= param_get8(Cmd
, cmdp
+1);
906 if (keyNbr
< ICLASS_KEYS_MAX
) {
907 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
909 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
913 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
924 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
928 if(errors
) return usage_hf_iclass_writeblock();
931 if (cmdp
< 6) return usage_hf_iclass_writeblock();
932 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, rawkey
, true);
937 int usage_hf_iclass_clone(void) {
938 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> c e|r");
939 PrintAndLog("Options:");
940 PrintAndLog(" f <filename>: specify a filename to clone from");
941 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
942 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
943 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
944 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
945 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
946 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
947 PrintAndLog("Samples:");
948 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
949 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
950 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
954 int CmdHFiClassCloneTag(const char *Cmd
) {
955 char filename
[FILE_PATH_SIZE
] = {0};
956 char tempStr
[50]={0};
957 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
959 uint8_t fileNameLen
= 0;
960 uint8_t startblock
= 0;
961 uint8_t endblock
= 0;
963 bool use_credit_key
= false;
968 while(param_getchar(Cmd
, cmdp
) != 0x00)
970 switch(param_getchar(Cmd
, cmdp
))
974 return usage_hf_iclass_clone();
977 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
978 PrintAndLog("Start Block No must include 2 HEX symbols\n");
985 use_credit_key
= true;
995 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
996 if (fileNameLen
< 1) {
997 PrintAndLog("No filename found after f");
1004 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1005 if (dataLen
== 16) {
1006 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1007 } else if (dataLen
== 1) {
1008 keyNbr
= param_get8(Cmd
, cmdp
+1);
1009 if (keyNbr
< ICLASS_KEYS_MAX
) {
1010 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1012 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1016 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1023 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
1024 PrintAndLog("Start Block No must include 2 HEX symbols\n");
1035 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1039 if(errors
) return usage_hf_iclass_clone();
1042 if (cmdp
< 8) return usage_hf_iclass_clone();
1046 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1048 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1049 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1051 // file handling and reading
1052 f
= fopen(filename
,"rb");
1054 PrintAndLog("Failed to read from file '%s'", filename
);
1059 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1063 // now read data from the file from block 6 --- 19
1064 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1065 // then copy to usbcommand->asbytes; the max is 32 - 6 = 24 block 12 bytes each block 288 bytes then we can only accept to clone 21 blocks at the time,
1066 // else we have to create a share memory
1068 fseek(f
,startblock
*8,SEEK_SET
);
1069 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0 ) {
1070 PrintAndLog("File reading error.");
1075 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1076 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1078 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, true))
1081 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1083 // calculate all mac for every the block we will write
1084 for (i
= startblock
; i
<= endblock
; i
++){
1085 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1086 // usb command d start pointer = d + (i - 6) * 12
1087 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1088 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1090 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1091 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1092 memcpy(ptr
+ 8,MAC
, 4);
1095 for (i
= 0; i
<= endblock
- startblock
;i
++){
1096 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1097 printf("Block |%02x|",i
+ startblock
);
1098 printf(" %02x%02x%02x%02x%02x%02x%02x%02x |",p
[0],p
[1],p
[2],p
[3],p
[4],p
[5],p
[6],p
[7]);
1099 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1103 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1105 PrintAndLog("Command execute timeout");
1111 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool rawkey
, bool verbose
, bool auth
) {
1112 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1113 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1116 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, rawkey
, verbose
))
1119 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1120 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1121 if (!select_only(CSN
, CCNR
, (keyType
==0x18), verbose
))
1126 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1127 clearCommandBuffer();
1129 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1131 PrintAndLog("Command execute timeout");
1134 uint8_t isOK
= resp
.arg
[0] & 0xff;
1136 PrintAndLog("Read Block Failed");
1139 //data read is stored in: resp.d.asBytes[0-15]
1140 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1144 int usage_hf_iclass_readblock(void) {
1145 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e|r\n");
1146 PrintAndLog("Options:");
1147 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1148 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1149 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1150 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1151 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
1152 PrintAndLog("Samples:");
1153 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1154 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1155 PrintAndLog(" hf iclass readblk b 0A k 0");
1159 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1161 uint8_t keyType
= 0x88; //debit key
1162 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1164 uint8_t dataLen
= 0;
1165 char tempStr
[50] = {0};
1167 bool rawkey
= false;
1168 bool errors
= false;
1171 while(param_getchar(Cmd
, cmdp
) != 0x00)
1173 switch(param_getchar(Cmd
, cmdp
))
1177 return usage_hf_iclass_readblock();
1180 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1181 PrintAndLog("Block No must include 2 HEX symbols\n");
1199 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1200 if (dataLen
== 16) {
1201 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1202 } else if (dataLen
== 1) {
1203 keyNbr
= param_get8(Cmd
, cmdp
+1);
1204 if (keyNbr
< ICLASS_KEYS_MAX
) {
1205 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1207 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1211 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1222 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1226 if(errors
) return usage_hf_iclass_readblock();
1229 if (cmdp
< 2) return usage_hf_iclass_readblock();
1231 PrintAndLog("warning: no authentication used with read, only a few specific blocks can be read accurately without authentication.");
1232 return ReadBlock(KEY
, blockno
, keyType
, elite
, rawkey
, true, auth
);
1235 int CmdHFiClass_loclass(const char *Cmd
) {
1236 char opt
= param_getchar(Cmd
, 0);
1238 if (strlen(Cmd
)<1 || opt
== 'h') {
1239 PrintAndLog("Usage: hf iclass loclass [options]");
1240 PrintAndLog("Options:");
1241 PrintAndLog("h Show this help");
1242 PrintAndLog("t Perform self-test");
1243 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1244 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1245 PrintAndLog(" malicious CSNs, and their protocol responses");
1246 PrintAndLog(" The binary format of the file is expected to be as follows: ");
1247 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1248 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1249 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1250 PrintAndLog(" ... totalling N*24 bytes");
1253 char fileName
[255] = {0};
1256 if(param_getstr(Cmd
, 1, fileName
) > 0)
1258 return bruteforceFileNoKeys(fileName
);
1261 PrintAndLog("You must specify a filename");
1266 int errors
= testCipherUtils();
1267 errors
+= testMAC();
1268 errors
+= doKeyTests(0);
1269 errors
+= testElite();
1272 prnlog("OBS! There were errors!!!");
1280 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1282 memcpy(&mem_config
, iclass_dump
+ 13,1);
1283 uint8_t maxmemcount
;
1284 uint8_t filemaxblock
= filesize
/ 8;
1285 if (mem_config
& 0x80)
1289 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1291 if (startblock
== 0)
1293 if ((endblock
> maxmemcount
) || (endblock
== 0))
1294 endblock
= maxmemcount
;
1296 // remember endblock need to relate to zero-index arrays.
1297 if (endblock
> filemaxblock
-1)
1298 endblock
= filemaxblock
;
1301 printf("------+--+-------------------------+\n");
1302 while (i
<= endblock
) {
1303 uint8_t *blk
= iclass_dump
+ (i
* 8);
1304 printf("Block |%02X| %s|\n", i
, sprint_hex(blk
, 8) );
1307 printf("------+--+-------------------------+\n");
1310 int usage_hf_iclass_readtagfile() {
1311 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1315 int CmdHFiClassReadTagFile(const char *Cmd
) {
1320 char filename
[FILE_PATH_SIZE
];
1321 if (param_getstr(Cmd
, 0, filename
) < 1)
1322 return usage_hf_iclass_readtagfile();
1323 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1326 sscanf(tempnum
,"%d",&startblock
);
1328 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1331 sscanf(tempnum
,"%d",&endblock
);
1332 // file handling and reading
1333 f
= fopen(filename
,"rb");
1335 PrintAndLog("Failed to read from file '%s'", filename
);
1338 fseek(f
, 0, SEEK_END
);
1339 long fsize
= ftell(f
);
1340 fseek(f
, 0, SEEK_SET
);
1343 PrintAndLog("Error, when getting filesize");
1348 uint8_t *dump
= malloc(fsize
);
1350 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1352 uint8_t *csn
= dump
;
1353 printf("------+--+-------------------------+\n");
1354 printf("CSN |00| %s|\n", sprint_hex(csn
, 8) );
1355 // printIclassDumpInfo(dump);
1356 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1362 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1363 uint64_t new_div = 0x00;
1369 uint64_t hexarray_to_uint64(uint8_t *key) {
1372 for (int i = 0;i < 8;i++)
1373 sprintf(&temp[(i *2)],"%02X",key[i]);
1375 if (sscanf(temp,"%016" SCNx64,&uint_key) < 1)
1380 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1381 uint8_t keytable
[128] = {0};
1382 uint8_t key_index
[8] = {0};
1384 uint8_t key_sel
[8] = { 0 };
1385 uint8_t key_sel_p
[8] = { 0 };
1386 hash2(KEY
, keytable
);
1387 hash1(CSN
, key_index
);
1388 for(uint8_t i
= 0; i
< 8 ; i
++)
1389 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1391 //Permute from iclass format to standard format
1392 permutekey_rev(key_sel
, key_sel_p
);
1393 diversifyKey(CSN
, key_sel_p
, div_key
);
1395 diversifyKey(CSN
, KEY
, div_key
);
1399 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1400 //calculate and return xor_div_key (ready for a key write command)
1401 //print all div_keys if verbose
1402 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1403 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1404 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1406 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1408 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1410 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1411 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1414 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1415 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1416 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1420 int usage_hf_iclass_calc_newkey(void) {
1421 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1422 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1423 PrintAndLog(" Options:");
1424 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1425 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1426 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1427 PrintAndLog(" e : specify new key as elite calc");
1428 PrintAndLog(" ee : specify old and new key as elite calc");
1429 PrintAndLog("Samples:");
1430 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1431 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1432 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1433 PrintAndLog("NOTE: * = required\n");
1438 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1439 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1440 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1441 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1442 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1443 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1445 uint8_t dataLen
= 0;
1446 char tempStr
[50] = {0};
1447 bool givenCSN
= false;
1448 bool oldElite
= false;
1450 bool errors
= false;
1452 while(param_getchar(Cmd
, cmdp
) != 0x00)
1454 switch(param_getchar(Cmd
, cmdp
))
1458 return usage_hf_iclass_calc_newkey();
1461 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1469 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1470 if (dataLen
== 16) {
1471 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1472 } else if (dataLen
== 1) {
1473 keyNbr
= param_get8(Cmd
, cmdp
+1);
1474 if (keyNbr
< ICLASS_KEYS_MAX
) {
1475 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1477 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1481 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1488 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1489 if (dataLen
== 16) {
1490 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1491 } else if (dataLen
== 1) {
1492 keyNbr
= param_get8(Cmd
, cmdp
+1);
1493 if (keyNbr
< ICLASS_KEYS_MAX
) {
1494 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1496 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1500 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1508 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1509 return usage_hf_iclass_calc_newkey();
1513 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1517 if(errors
) return usage_hf_iclass_calc_newkey();
1520 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1523 if (!select_only(CSN
, CCNR
, false, true))
1526 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1530 static int loadKeys(char *filename
) {
1532 f
= fopen(filename
,"rb");
1534 PrintAndLog("Failed to read from file '%s'", filename
);
1537 fseek(f
, 0, SEEK_END
);
1538 long fsize
= ftell(f
);
1539 fseek(f
, 0, SEEK_SET
);
1542 PrintAndLog("Error, when getting filesize");
1547 uint8_t *dump
= malloc(fsize
);
1549 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1551 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1552 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1557 for (; i
< bytes_read
/8; i
++){
1558 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1561 PrintAndLog("%u keys loaded", i
);
1565 static int saveKeys(char *filename
) {
1567 f
= fopen(filename
,"wb");
1569 printf("error opening file %s\n",filename
);
1572 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1573 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1574 PrintAndLog("save key failed to write to file: %s", filename
);
1582 static int printKeys(void) {
1584 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1585 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1591 int usage_hf_iclass_managekeys(void) {
1592 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1593 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1594 PrintAndLog(" Options:");
1595 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1596 PrintAndLog(" k <key> : set a key in memory");
1597 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1598 PrintAndLog(" s : save keys in memory to file specified by filename");
1599 PrintAndLog(" l : load keys to memory from file specified by filename");
1600 PrintAndLog(" p : print keys loaded into memory\n");
1601 PrintAndLog("Samples:");
1602 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1603 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1604 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1605 PrintAndLog(" print keys : hf iclass managekeys p\n");
1609 int CmdHFiClassManageKeys(const char *Cmd
) {
1611 uint8_t dataLen
= 0;
1612 uint8_t KEY
[8] = {0};
1613 char filename
[FILE_PATH_SIZE
];
1614 uint8_t fileNameLen
= 0;
1615 bool errors
= false;
1616 uint8_t operation
= 0;
1620 while(param_getchar(Cmd
, cmdp
) != 0x00)
1622 switch(param_getchar(Cmd
, cmdp
))
1626 return usage_hf_iclass_managekeys();
1629 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1630 if (fileNameLen
< 1) {
1631 PrintAndLog("No filename found after f");
1638 keyNbr
= param_get8(Cmd
, cmdp
+1);
1639 if (keyNbr
>= ICLASS_KEYS_MAX
) {
1640 PrintAndLog("Invalid block number");
1647 operation
+= 3; //set key
1648 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1649 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1650 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1652 PrintAndLog("\nERROR: Key is incorrect length\n");
1659 operation
+= 4; //print keys in memory
1664 operation
+= 5; //load keys from file
1669 operation
+= 6; //save keys to file
1673 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1677 if(errors
) return usage_hf_iclass_managekeys();
1679 if (operation
== 0){
1680 PrintAndLog("no operation specified (load, save, or print)\n");
1681 return usage_hf_iclass_managekeys();
1684 PrintAndLog("Too many operations specified\n");
1685 return usage_hf_iclass_managekeys();
1687 if (operation
> 4 && fileNameLen
== 0){
1688 PrintAndLog("You must enter a filename when loading or saving\n");
1689 return usage_hf_iclass_managekeys();
1693 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1694 case 4: return printKeys();
1695 case 5: return loadKeys(filename
);
1696 case 6: return saveKeys(filename
);
1702 static command_t CommandTable
[] =
1704 {"help", CmdHelp
, 1, "This help"},
1705 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1706 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1707 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1708 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1709 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1710 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1711 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1712 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1713 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1714 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1715 {"reader", CmdHFiClassReader
, 0, " Look for iClass tags until a key or the pm3 button is pressed"},
1716 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1717 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1718 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1719 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1720 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1721 {NULL
, NULL
, 0, NULL
}
1724 int CmdHFiClass(const char *Cmd
)
1726 CmdsParse(CommandTable
, Cmd
);
1730 int CmdHelp(const char *Cmd
)
1732 CmdsHelp(CommandTable
);