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 "loclass/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"
38 static int CmdHelp(const char *Cmd
);
40 #define ICLASS_KEYS_MAX 8
41 static uint8_t iClass_Key_Table
[ICLASS_KEYS_MAX
][8] = {
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 },
48 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
49 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }
52 typedef struct iclass_block
{
56 int xorbits_8(uint8_t val
) {
57 uint8_t res
= val
^ (val
>> 1); //1st pass
58 res
= res
^ (res
>> 1); // 2nd pass
59 res
= res
^ (res
>> 2); // 3rd pass
60 res
= res
^ (res
>> 4); // 4th pass
64 int CmdHFiClassList(const char *Cmd
) {
65 PrintAndLog("Deprecated command, use 'hf list iclass' instead");
69 int CmdHFiClassSnoop(const char *Cmd
) {
70 UsbCommand c
= {CMD_SNOOP_ICLASS
};
75 int usage_hf_iclass_sim(void) {
76 PrintAndLog("Usage: hf iclass sim <option> [CSN]");
77 PrintAndLog(" options");
78 PrintAndLog(" 0 <CSN> simulate the given CSN");
79 PrintAndLog(" 1 simulate default CSN");
80 PrintAndLog(" 2 Reader-attack, gather reader responses to extract elite key");
81 PrintAndLog(" 3 Full simulation using emulator memory (see 'hf iclass eload')");
82 PrintAndLog(" example: hf iclass sim 0 031FEC8AF7FF12E0");
83 PrintAndLog(" example: hf iclass sim 2");
84 PrintAndLog(" example: hf iclass eload 'tagdump.bin'");
85 PrintAndLog(" hf iclass sim 3");
90 int CmdHFiClassSim(const char *Cmd
) {
92 uint8_t CSN
[8] = {0, 0, 0, 0, 0, 0, 0, 0};
95 return usage_hf_iclass_sim();
97 simType
= param_get8ex(Cmd
, 0, 0, 10);
101 if (param_gethex(Cmd
, 1, CSN
, 16)) {
102 PrintAndLog("A CSN should consist of 16 HEX symbols");
103 return usage_hf_iclass_sim();
106 PrintAndLog("--simtype:%02x csn:%s", simType
, sprint_hex(CSN
, 8));
110 PrintAndLog("Undefined simptype %d", simType
);
111 return usage_hf_iclass_sim();
114 uint8_t numberOfCSNs
=0;
117 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,NUM_CSNS
}};
118 UsbCommand resp
= {0};
120 uint8_t csns
[8*NUM_CSNS
] = {
121 0x00, 0x0B, 0x0F, 0xFF, 0xF7, 0xFF, 0x12, 0xE0,
122 0x00, 0x04, 0x0E, 0x08, 0xF7, 0xFF, 0x12, 0xE0,
123 0x00, 0x09, 0x0D, 0x05, 0xF7, 0xFF, 0x12, 0xE0,
124 0x00, 0x0A, 0x0C, 0x06, 0xF7, 0xFF, 0x12, 0xE0,
125 0x00, 0x0F, 0x0B, 0x03, 0xF7, 0xFF, 0x12, 0xE0,
126 0x00, 0x08, 0x0A, 0x0C, 0xF7, 0xFF, 0x12, 0xE0,
127 0x00, 0x0D, 0x09, 0x09, 0xF7, 0xFF, 0x12, 0xE0,
128 0x00, 0x0E, 0x08, 0x0A, 0xF7, 0xFF, 0x12, 0xE0,
129 0x00, 0x03, 0x07, 0x17, 0xF7, 0xFF, 0x12, 0xE0,
130 0x00, 0x3C, 0x06, 0xE0, 0xF7, 0xFF, 0x12, 0xE0,
131 0x00, 0x01, 0x05, 0x1D, 0xF7, 0xFF, 0x12, 0xE0,
132 0x00, 0x02, 0x04, 0x1E, 0xF7, 0xFF, 0x12, 0xE0,
133 0x00, 0x07, 0x03, 0x1B, 0xF7, 0xFF, 0x12, 0xE0,
134 0x00, 0x00, 0x02, 0x24, 0xF7, 0xFF, 0x12, 0xE0,
135 0x00, 0x05, 0x01, 0x21, 0xF7, 0xFF, 0x12, 0xE0 };
137 memcpy(c
.d
.asBytes
, csns
, 8*NUM_CSNS
);
140 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, -1)) {
141 PrintAndLog("Command timed out");
145 uint8_t num_mac_responses
= resp
.arg
[1];
146 PrintAndLog("Mac responses: %d MACs obtained (should be %d)", num_mac_responses
,NUM_CSNS
);
148 size_t datalen
= NUM_CSNS
*24;
150 * Now, time to dump to file. We'll use this format:
151 * <8-byte CSN><8-byte CC><4 byte NR><4 byte MAC>....
152 * So, it should wind up as
155 * The returndata from the pm3 is on the following format
156 * <4 byte NR><4 byte MAC>
157 * CC are all zeroes, CSN is the same as was sent in
159 void* dump
= malloc(datalen
);
160 memset(dump
,0,datalen
);//<-- Need zeroes for the CC-field
162 for(i
= 0 ; i
< NUM_CSNS
; i
++)
164 memcpy(dump
+i
*24, csns
+i
*8,8); //CSN
165 //8 zero bytes here...
166 //Then comes NR_MAC (eight bytes from the response)
167 memcpy(dump
+i
*24+16,resp
.d
.asBytes
+i
*8,8);
170 /** Now, save to dumpfile **/
171 saveFile("iclass_mac_attack", "bin", dump
,datalen
);
175 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,numberOfCSNs
}};
176 memcpy(c
.d
.asBytes
, CSN
, 8);
183 int HFiClassReader(const char *Cmd
, bool loop
, bool verbose
) {
184 bool tagFound
= false;
185 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
186 FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_AA
}};
187 // loop in client not device - else on windows have a communication error
188 c
.arg
[0] |= FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
;
192 if (WaitForResponseTimeout(CMD_ACK
,&resp
, 4500)) {
193 uint8_t readStatus
= resp
.arg
[0] & 0xff;
194 uint8_t *data
= resp
.d
.asBytes
;
197 PrintAndLog("Readstatus:%02x", readStatus
);
198 if( readStatus
== 0){
200 if (verbose
) PrintAndLog("Quitting...");
203 if( readStatus
& FLAG_ICLASS_READER_CSN
){
204 PrintAndLog("CSN: %s",sprint_hex(data
,8));
207 if( readStatus
& FLAG_ICLASS_READER_CC
) PrintAndLog("CC: %s",sprint_hex(data
+16,8));
208 if( readStatus
& FLAG_ICLASS_READER_CONF
){
209 printIclassDumpInfo(data
);
211 if (tagFound
&& !loop
) return 1;
213 if (verbose
) PrintAndLog("Command execute timeout");
220 int CmdHFiClassReader(const char *Cmd
) {
221 return HFiClassReader(Cmd
, true, true);
224 int CmdHFiClassReader_Replay(const char *Cmd
) {
225 uint8_t readerType
= 0;
226 uint8_t MAC
[4]={0x00, 0x00, 0x00, 0x00};
229 PrintAndLog("Usage: hf iclass replay <MAC>");
230 PrintAndLog(" sample: hf iclass replay 00112233");
234 if (param_gethex(Cmd
, 0, MAC
, 8)) {
235 PrintAndLog("MAC must include 8 HEX symbols");
239 UsbCommand c
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
240 memcpy(c
.d
.asBytes
, MAC
, 4);
246 int iclassEmlSetMem(uint8_t *data
, int blockNum
, int blocksCount
) {
247 UsbCommand c
= {CMD_MIFARE_EML_MEMSET
, {blockNum
, blocksCount
, 0}};
248 memcpy(c
.d
.asBytes
, data
, blocksCount
* 16);
253 int hf_iclass_eload_usage(void) {
254 PrintAndLog("Loads iclass tag-dump into emulator memory on device");
255 PrintAndLog("Usage: hf iclass eload f <filename>");
257 PrintAndLog("Example: hf iclass eload f iclass_tagdump-aa162d30f8ff12f1.bin");
261 int CmdHFiClassELoad(const char *Cmd
) {
263 char opt
= param_getchar(Cmd
, 0);
264 if (strlen(Cmd
)<1 || opt
== 'h')
265 return hf_iclass_eload_usage();
267 //File handling and reading
269 char filename
[FILE_PATH_SIZE
];
270 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
272 f
= fopen(filename
, "rb");
274 return hf_iclass_eload_usage();
278 PrintAndLog("Failed to read from file '%s'", filename
);
282 fseek(f
, 0, SEEK_END
);
283 long fsize
= ftell(f
);
284 fseek(f
, 0, SEEK_SET
);
286 uint8_t *dump
= malloc(fsize
);
289 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
292 printIclassDumpInfo(dump
);
295 if (bytes_read
< fsize
)
297 prnlog("Error, could only read %d bytes (should be %d)",bytes_read
, fsize
);
302 uint32_t bytes_sent
= 0;
303 uint32_t bytes_remaining
= bytes_read
;
305 while(bytes_remaining
> 0){
306 uint32_t bytes_in_packet
= MIN(USB_CMD_DATA_SIZE
, bytes_remaining
);
307 UsbCommand c
= {CMD_ICLASS_EML_MEMSET
, {bytes_sent
,bytes_in_packet
,0}};
308 memcpy(c
.d
.asBytes
, dump
, bytes_in_packet
);
310 bytes_remaining
-= bytes_in_packet
;
311 bytes_sent
+= bytes_in_packet
;
314 PrintAndLog("Sent %d bytes of data to device emulator memory", bytes_sent
);
318 static int readKeyfile(const char *filename
, size_t len
, uint8_t* buffer
) {
319 FILE *f
= fopen(filename
, "rb");
321 PrintAndLog("Failed to read from file '%s'", filename
);
324 fseek(f
, 0, SEEK_END
);
325 long fsize
= ftell(f
);
326 fseek(f
, 0, SEEK_SET
);
327 size_t bytes_read
= fread(buffer
, 1, len
, f
);
331 PrintAndLog("Warning, file size is %d, expected %d", fsize
, len
);
334 if(bytes_read
!= len
)
336 PrintAndLog("Warning, could only read %d bytes, expected %d" ,bytes_read
, len
);
342 int usage_hf_iclass_decrypt(void) {
343 PrintAndLog("Usage: hf iclass decrypt f <tagdump>");
345 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
346 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
348 PrintAndLog("example: hf iclass decrypt f tagdump_12312342343.bin");
350 PrintAndLog("OBS! This is pretty stupid implementation, it tries to decrypt every block after block 6. ");
351 PrintAndLog("Correct behaviour would be to decrypt only the application areas where the key is valid,");
352 PrintAndLog("which is defined by the configuration block.");
356 int CmdHFiClassDecrypt(const char *Cmd
) {
357 uint8_t key
[16] = { 0 };
358 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
360 usage_hf_iclass_decrypt();
363 PrintAndLog("Decryption file found... ");
364 char opt
= param_getchar(Cmd
, 0);
365 if (strlen(Cmd
)<1 || opt
== 'h')
366 return usage_hf_iclass_decrypt();
368 //Open the tagdump-file
370 char filename
[FILE_PATH_SIZE
];
371 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
373 f
= fopen(filename
, "rb");
375 return usage_hf_iclass_decrypt();
378 fseek(f
, 0, SEEK_END
);
379 long fsize
= ftell(f
);
380 fseek(f
, 0, SEEK_SET
);
381 uint8_t enc_dump
[8] = {0};
382 uint8_t *decrypted
= malloc(fsize
);
383 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
384 des3_set2key_dec( &ctx
, key
);
385 size_t bytes_read
= fread(enc_dump
, 1, 8, f
);
387 //Use the first block (CSN) for filename
388 char outfilename
[FILE_PATH_SIZE
] = { 0 };
389 snprintf(outfilename
,FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x-decrypted",
390 enc_dump
[0],enc_dump
[1],enc_dump
[2],enc_dump
[3],
391 enc_dump
[4],enc_dump
[5],enc_dump
[6],enc_dump
[7]);
394 while(bytes_read
== 8)
398 memcpy(decrypted
+(blocknum
*8), enc_dump
, 8);
400 des3_crypt_ecb(&ctx
, enc_dump
,decrypted
+(blocknum
*8) );
402 printvar("decrypted block", decrypted
+(blocknum
*8), 8);
403 bytes_read
= fread(enc_dump
, 1, 8, f
);
408 saveFile(outfilename
,"bin", decrypted
, blocknum
*8);
413 int usage_hf_iclass_encrypt(void) {
414 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
416 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
417 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
419 PrintAndLog("example: hf iclass encrypt 0102030405060708");
424 static int iClassEncryptBlkData(uint8_t *blkData
) {
425 uint8_t key
[16] = { 0 };
426 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
428 usage_hf_iclass_encrypt();
431 PrintAndLog("Decryption file found... ");
433 uint8_t encryptedData
[16];
434 uint8_t *encrypted
= encryptedData
;
435 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
436 des3_set2key_enc( &ctx
, key
);
438 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
439 //printvar("decrypted block", decrypted, 8);
440 memcpy(blkData
,encrypted
,8);
445 int CmdHFiClassEncryptBlk(const char *Cmd
) {
446 uint8_t blkData
[8] = {0};
447 char opt
= param_getchar(Cmd
, 0);
448 if (strlen(Cmd
)<1 || opt
== 'h')
449 return usage_hf_iclass_encrypt();
451 //get the bytes to encrypt
452 if (param_gethex(Cmd
, 0, blkData
, 16))
454 PrintAndLog("BlockData must include 16 HEX symbols");
457 if (!iClassEncryptBlkData(blkData
)) return 0;
459 printvar("encrypted block", blkData
, 8);
463 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
466 memcpy(WB
+ 1,data
,8);
467 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
468 //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]);
471 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
474 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
475 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
477 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
479 clearCommandBuffer();
481 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
483 PrintAndLog("Command execute timeout");
487 uint8_t isOK
= resp
.arg
[0] & 0xff;
488 uint8_t *data
= resp
.d
.asBytes
;
491 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
494 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
497 PrintAndLog("Failed to obtain CC! Aborting");
503 static bool select_and_auth(uint8_t *KEY
, uint8_t *MAC
, uint8_t *div_key
, bool use_credit_key
, bool elite
, bool verbose
) {
504 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
505 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
507 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
511 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
513 doMAC(CCNR
, div_key
, MAC
);
515 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
516 memcpy(d
.d
.asBytes
, MAC
, 4);
517 clearCommandBuffer();
519 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
521 PrintAndLog("Auth Command execute timeout");
524 uint8_t isOK
= resp
.arg
[0] & 0xff;
526 PrintAndLog("Authentication error");
532 int usage_hf_iclass_dump(void) {
533 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e\n");
534 PrintAndLog("Options:");
535 PrintAndLog(" f <filename> : specify a filename to save dump to");
536 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
537 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
538 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
539 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
540 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
541 PrintAndLog(" NOTE: * = required");
542 PrintAndLog("Samples:");
543 PrintAndLog(" hf iclass dump k 001122334455667B");
544 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
545 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
549 int CmdHFiClassReader_Dump(const char *Cmd
) {
551 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
552 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
553 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
557 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
558 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
561 uint8_t fileNameLen
= 0;
562 char filename
[FILE_PATH_SIZE
]={0};
563 char tempStr
[50] = {0};
564 bool have_debit_key
= false;
565 bool have_credit_key
= false;
566 bool use_credit_key
= false;
571 while(param_getchar(Cmd
, cmdp
) != 0x00)
573 switch(param_getchar(Cmd
, cmdp
))
577 return usage_hf_iclass_dump();
580 have_credit_key
= true;
581 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
583 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
584 } else if (dataLen
== 1) {
585 keyNbr
= param_get8(Cmd
, cmdp
+1);
586 if (keyNbr
<= ICLASS_KEYS_MAX
) {
587 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
589 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
593 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
605 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
606 if (fileNameLen
< 1) {
607 PrintAndLog("No filename found after f");
614 have_debit_key
= true;
615 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
617 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
618 } else if (dataLen
== 1) {
619 keyNbr
= param_get8(Cmd
, cmdp
+1);
620 if (keyNbr
<= ICLASS_KEYS_MAX
) {
621 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
623 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
627 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
633 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
637 if(errors
) return usage_hf_iclass_dump();
640 if (cmdp
< 2) return usage_hf_iclass_dump();
641 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
642 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
644 //get config and first 3 blocks
645 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
646 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
648 uint8_t tag_data
[255*8];
650 clearCommandBuffer();
652 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
653 PrintAndLog("Command execute timeout");
654 ul_switch_off_field();
657 uint8_t readStatus
= resp
.arg
[0] & 0xff;
658 uint8_t *data
= resp
.d
.asBytes
;
661 PrintAndLog("No tag found...");
662 ul_switch_off_field();
665 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
666 memcpy(tag_data
, data
, 8*3);
667 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
670 if (data
[13] & 0x80) {
671 // large memory - not able to dump pages currently
676 if (numblks
> maxBlk
) numblks
= maxBlk
;
678 ul_switch_off_field();
679 // authenticate debit key and get div_key - later store in dump block 3
680 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, false)){
681 //try twice - for some reason it sometimes fails the first time...
682 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, false)){
683 ul_switch_off_field();
689 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
690 clearCommandBuffer();
692 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
693 PrintAndLog("Command execute time-out 1");
694 ul_switch_off_field();
697 uint32_t blocksRead
= resp
.arg
[1];
698 uint8_t isOK
= resp
.arg
[0] & 0xff;
699 if (!isOK
&& !blocksRead
) {
700 PrintAndLog("Read Block Failed");
701 ul_switch_off_field();
704 uint32_t startindex
= resp
.arg
[2];
705 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
706 PrintAndLog("Data exceeded Buffer size!");
707 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
709 // response ok - now get bigbuf content of the dump
710 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
711 WaitForResponse(CMD_ACK
,NULL
);
712 size_t gotBytes
= blocksRead
*8 + blockno
*8;
715 if (have_credit_key
) {
716 //turn off hf field before authenticating with different key
717 ul_switch_off_field();
719 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
720 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false)){
721 //try twice - for some reason it sometimes fails the first time...
722 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false)){
723 ul_switch_off_field();
727 // do we still need to read more block? (aa2 enabled?)
728 if (maxBlk
> blockno
+numblks
+1) {
729 // setup dump and start
730 w
.arg
[0] = blockno
+ blocksRead
;
731 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
732 clearCommandBuffer();
734 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
735 PrintAndLog("Command execute timeout 2");
736 ul_switch_off_field();
739 uint8_t isOK
= resp
.arg
[0] & 0xff;
740 blocksRead
= resp
.arg
[1];
741 if (!isOK
&& !blocksRead
) {
742 PrintAndLog("Read Block Failed 2");
743 ul_switch_off_field();
747 startindex
= resp
.arg
[2];
748 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
749 PrintAndLog("Data exceeded Buffer size!");
750 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
752 // get dumped data from bigbuf
753 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
754 WaitForResponse(CMD_ACK
,NULL
);
756 gotBytes
+= blocksRead
*8;
757 } else { //field is still on - turn it off...
758 ul_switch_off_field();
762 // add diversified keys to dump
763 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
764 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
766 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
767 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
768 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
770 if (filename
[0] == 0){
771 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
772 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
773 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
776 // save the dump to .bin file
777 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
778 saveFile(filename
, "bin", tag_data
, gotBytes
);
782 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool verbose
) {
783 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
784 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
785 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, verbose
))
790 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
791 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
792 memcpy(w
.d
.asBytes
, bldata
, 8);
793 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
795 clearCommandBuffer();
797 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
799 PrintAndLog("Write Command execute timeout");
802 uint8_t isOK
= resp
.arg
[0] & 0xff;
804 PrintAndLog("Write Block Failed");
807 PrintAndLog("Write Block Successful");
811 int usage_hf_iclass_writeblock(void) {
812 PrintAndLog("Options:");
813 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
814 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
815 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
816 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
817 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
818 PrintAndLog("Samples:");
819 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
820 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
821 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
825 int CmdHFiClass_WriteBlock(const char *Cmd
) {
827 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
828 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
831 char tempStr
[50] = {0};
832 bool use_credit_key
= false;
836 while(param_getchar(Cmd
, cmdp
) != 0x00)
838 switch(param_getchar(Cmd
, cmdp
))
842 return usage_hf_iclass_writeblock();
845 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
846 PrintAndLog("Block No must include 2 HEX symbols\n");
853 use_credit_key
= true;
858 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
860 PrintAndLog("KEY must include 16 HEX symbols\n");
872 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
874 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
875 } else if (dataLen
== 1) {
876 keyNbr
= param_get8(Cmd
, cmdp
+1);
877 if (keyNbr
<= ICLASS_KEYS_MAX
) {
878 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
880 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
884 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
890 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
894 if(errors
) return usage_hf_iclass_writeblock();
897 if (cmdp
< 6) return usage_hf_iclass_writeblock();
898 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, true);
899 ul_switch_off_field();
903 int usage_hf_iclass_clone(void) {
904 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> e c");
905 PrintAndLog("Options:");
906 PrintAndLog(" f <filename>: specify a filename to clone from");
907 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
908 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
909 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
910 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
911 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
912 PrintAndLog("Samples:");
913 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
914 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
915 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
919 int CmdHFiClassCloneTag(const char *Cmd
) {
920 char filename
[FILE_PATH_SIZE
];
921 char tempStr
[50]={0};
922 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
924 uint8_t fileNameLen
= 0;
925 uint8_t startblock
= 0;
926 uint8_t endblock
= 0;
928 bool use_credit_key
= false;
932 while(param_getchar(Cmd
, cmdp
) != 0x00)
934 switch(param_getchar(Cmd
, cmdp
))
938 return usage_hf_iclass_clone();
941 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
942 PrintAndLog("Start Block No must include 2 HEX symbols\n");
949 use_credit_key
= true;
959 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
960 if (fileNameLen
< 1) {
961 PrintAndLog("No filename found after f");
968 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
970 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
971 } else if (dataLen
== 1) {
972 keyNbr
= param_get8(Cmd
, cmdp
+1);
973 if (keyNbr
<= ICLASS_KEYS_MAX
) {
974 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
976 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
980 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
987 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
988 PrintAndLog("Start Block No must include 2 HEX symbols\n");
994 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
998 if(errors
) return usage_hf_iclass_clone();
1001 if (cmdp
< 8) return usage_hf_iclass_clone();
1005 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1007 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1008 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1010 // file handling and reading
1011 f
= fopen(filename
,"rb");
1013 PrintAndLog("Failed to read from file '%s'", filename
);
1018 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1021 // now read data from the file from block 6 --- 19
1022 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1023 // 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,
1024 // else we have to create a share memory
1026 fseek(f
,startblock
*8,SEEK_SET
);
1027 fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
);
1029 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1030 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1032 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, true))
1035 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1037 // calculate all mac for every the block we will write
1038 for (i
= startblock
; i
<= endblock
; i
++){
1039 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1040 // usb command d start pointer = d + (i - 6) * 12
1041 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1042 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1044 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1045 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1046 memcpy(ptr
+ 8,MAC
, 4);
1049 for (i
= 0; i
<= endblock
- startblock
;i
++){
1050 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1051 printf("Block |%02x|",i
+ startblock
);
1052 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]);
1053 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1057 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1059 PrintAndLog("Command execute timeout");
1065 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool verbose
) {
1066 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1067 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1069 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, verbose
))
1073 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1074 clearCommandBuffer();
1076 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1078 PrintAndLog("Command execute timeout");
1081 uint8_t isOK
= resp
.arg
[0] & 0xff;
1083 PrintAndLog("Read Block Failed");
1086 //data read is stored in: resp.d.asBytes[0-15]
1087 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1091 int usage_hf_iclass_readblock(void) {
1092 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e\n");
1093 PrintAndLog("Options:");
1094 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1095 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1096 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1097 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1098 PrintAndLog("Samples:");
1099 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1100 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1101 PrintAndLog(" hf iclass readblk b 0A k 0");
1105 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1107 uint8_t keyType
= 0x88; //debit key
1108 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1110 uint8_t dataLen
= 0;
1111 char tempStr
[50] = {0};
1113 bool errors
= false;
1115 while(param_getchar(Cmd
, cmdp
) != 0x00)
1117 switch(param_getchar(Cmd
, cmdp
))
1121 return usage_hf_iclass_readblock();
1124 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1125 PrintAndLog("Block No must include 2 HEX symbols\n");
1142 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1143 if (dataLen
== 16) {
1144 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1145 } else if (dataLen
== 1) {
1146 keyNbr
= param_get8(Cmd
, cmdp
+1);
1147 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1148 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1150 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1154 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1160 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1164 if(errors
) return usage_hf_iclass_readblock();
1167 if (cmdp
< 4) return usage_hf_iclass_readblock();
1169 return ReadBlock(KEY
, blockno
, keyType
, elite
, true);
1172 int CmdHFiClass_loclass(const char *Cmd
) {
1173 char opt
= param_getchar(Cmd
, 0);
1175 if (strlen(Cmd
)<1 || opt
== 'h') {
1176 PrintAndLog("Usage: hf iclass loclass [options]");
1177 PrintAndLog("Options:");
1178 PrintAndLog("h Show this help");
1179 PrintAndLog("t Perform self-test");
1180 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1181 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1182 PrintAndLog(" malicious CSNs, and their protocol responses");
1183 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
1184 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1185 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1186 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1187 PrintAndLog(" ... totalling N*24 bytes");
1190 char fileName
[255] = {0};
1193 if(param_getstr(Cmd
, 1, fileName
) > 0)
1195 return bruteforceFileNoKeys(fileName
);
1198 PrintAndLog("You must specify a filename");
1203 int errors
= testCipherUtils();
1204 errors
+= testMAC();
1205 errors
+= doKeyTests(0);
1206 errors
+= testElite();
1209 prnlog("OBS! There were errors!!!");
1217 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1218 uint8_t blockdata
[8];
1220 memcpy(&mem_config
, iclass_dump
+ 13,1);
1221 uint8_t maxmemcount
;
1222 uint8_t filemaxblock
= filesize
/ 8;
1223 if (mem_config
& 0x80)
1227 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1229 if (startblock
== 0)
1231 if ((endblock
> maxmemcount
) || (endblock
== 0))
1232 endblock
= maxmemcount
;
1233 if (endblock
> filemaxblock
)
1234 endblock
= filemaxblock
;
1237 while (i
<= endblock
){
1238 printf("Block |%02X| ",i
);
1239 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1240 for (j
= 0;j
< 8;j
++)
1241 printf("%02X ",blockdata
[j
]);
1247 int usage_hf_iclass_readtagfile() {
1248 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1252 int CmdHFiClassReadTagFile(const char *Cmd
) {
1257 char filename
[FILE_PATH_SIZE
];
1258 if (param_getstr(Cmd
, 0, filename
) < 1)
1259 return usage_hf_iclass_readtagfile();
1260 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1263 sscanf(tempnum
,"%d",&startblock
);
1265 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1268 sscanf(tempnum
,"%d",&endblock
);
1269 // file handling and reading
1270 f
= fopen(filename
,"rb");
1272 PrintAndLog("Failed to read from file '%s'", filename
);
1275 fseek(f
, 0, SEEK_END
);
1276 long fsize
= ftell(f
);
1277 fseek(f
, 0, SEEK_SET
);
1279 uint8_t *dump
= malloc(fsize
);
1282 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1284 uint8_t *csn
= dump
;
1285 printf("CSN [00] | %02X %02X %02X %02X %02X %02X %02X %02X |\n",csn
[0],csn
[1],csn
[2],csn
[3],csn
[4],csn
[5],csn
[6],csn
[7]);
1286 // printIclassDumpInfo(dump);
1287 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1293 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1294 uint64_t new_div = 0x00;
1300 uint64_t hexarray_to_uint64(uint8_t *key) {
1303 for (int i = 0;i < 8;i++)
1304 sprintf(&temp[(i *2)],"%02X",key[i]);
1306 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1311 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1312 uint8_t keytable
[128] = {0};
1313 uint8_t key_index
[8] = {0};
1315 uint8_t key_sel
[8] = { 0 };
1316 uint8_t key_sel_p
[8] = { 0 };
1317 hash2(KEY
, keytable
);
1318 hash1(CSN
, key_index
);
1319 for(uint8_t i
= 0; i
< 8 ; i
++)
1320 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1322 //Permute from iclass format to standard format
1323 permutekey_rev(key_sel
, key_sel_p
);
1324 diversifyKey(CSN
, key_sel_p
, div_key
);
1326 diversifyKey(CSN
, KEY
, div_key
);
1330 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1331 //calculate and return xor_div_key (ready for a key write command)
1332 //print all div_keys if verbose
1333 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1334 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1335 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1337 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1339 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1341 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1342 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1345 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1346 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1347 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1351 int usage_hf_iclass_calc_newkey(void) {
1352 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1353 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1354 PrintAndLog(" Options:");
1355 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1356 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1357 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1358 PrintAndLog(" e : specify new key as elite calc");
1359 PrintAndLog(" ee : specify old and new key as elite calc");
1360 PrintAndLog("Samples:");
1361 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1362 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1363 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1364 PrintAndLog("NOTE: * = required\n");
1369 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1370 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1371 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1372 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1373 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1374 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1376 uint8_t dataLen
= 0;
1377 char tempStr
[50] = {0};
1378 bool givenCSN
= false;
1379 bool oldElite
= false;
1381 bool errors
= false;
1383 while(param_getchar(Cmd
, cmdp
) != 0x00)
1385 switch(param_getchar(Cmd
, cmdp
))
1389 return usage_hf_iclass_calc_newkey();
1392 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1400 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1401 if (dataLen
== 16) {
1402 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1403 } else if (dataLen
== 1) {
1404 keyNbr
= param_get8(Cmd
, cmdp
+1);
1405 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1406 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1408 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1412 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1419 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1420 if (dataLen
== 16) {
1421 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1422 } else if (dataLen
== 1) {
1423 keyNbr
= param_get8(Cmd
, cmdp
+1);
1424 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1425 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1427 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1431 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1439 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1440 return usage_hf_iclass_calc_newkey();
1444 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1448 if(errors
) return usage_hf_iclass_calc_newkey();
1451 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1454 if (!select_only(CSN
, CCNR
, false, true))
1457 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1461 static int loadKeys(char *filename
) {
1463 f
= fopen(filename
,"rb");
1465 PrintAndLog("Failed to read from file '%s'", filename
);
1468 fseek(f
, 0, SEEK_END
);
1469 long fsize
= ftell(f
);
1470 fseek(f
, 0, SEEK_SET
);
1472 uint8_t *dump
= malloc(fsize
);
1474 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1476 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1477 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1482 for (; i
< bytes_read
/8; i
++){
1483 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1486 PrintAndLog("%u keys loaded", i
);
1490 static int saveKeys(char *filename
) {
1492 f
= fopen(filename
,"wb");
1494 printf("error opening file %s\n",filename
);
1497 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1498 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1499 PrintAndLog("save key failed to write to file: %s", filename
);
1507 static int printKeys(void) {
1509 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1510 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1516 int usage_hf_iclass_managekeys(void) {
1517 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1518 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1519 PrintAndLog(" Options:");
1520 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1521 PrintAndLog(" k <key> : set a key in memory");
1522 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1523 PrintAndLog(" s : save keys in memory to file specified by filename");
1524 PrintAndLog(" l : load keys to memory from file specified by filename");
1525 PrintAndLog(" p : print keys loaded into memory\n");
1526 PrintAndLog("Samples:");
1527 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1528 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1529 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1530 PrintAndLog(" print keys : hf iclass managekeys p\n");
1534 int CmdHFiClassManageKeys(const char *Cmd
) {
1536 uint8_t dataLen
= 0;
1537 uint8_t KEY
[8] = {0};
1538 char filename
[FILE_PATH_SIZE
];
1539 uint8_t fileNameLen
= 0;
1540 bool errors
= false;
1541 uint8_t operation
= 0;
1545 while(param_getchar(Cmd
, cmdp
) != 0x00)
1547 switch(param_getchar(Cmd
, cmdp
))
1551 return usage_hf_iclass_managekeys();
1554 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1555 if (fileNameLen
< 1) {
1556 PrintAndLog("No filename found after f");
1563 keyNbr
= param_get8(Cmd
, cmdp
+1);
1565 PrintAndLog("Wrong block number");
1572 operation
+= 3; //set key
1573 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1574 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1575 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1577 PrintAndLog("\nERROR: Key is incorrect length\n");
1584 operation
+= 4; //print keys in memory
1589 operation
+= 5; //load keys from file
1594 operation
+= 6; //save keys to file
1598 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1602 if(errors
) return usage_hf_iclass_managekeys();
1604 if (operation
== 0){
1605 PrintAndLog("no operation specified (load, save, or print)\n");
1606 return usage_hf_iclass_managekeys();
1609 PrintAndLog("Too many operations specified\n");
1610 return usage_hf_iclass_managekeys();
1612 if (operation
> 4 && fileNameLen
== 0){
1613 PrintAndLog("You must enter a filename when loading or saving\n");
1614 return usage_hf_iclass_managekeys();
1618 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1619 case 4: return printKeys();
1620 case 5: return loadKeys(filename
);
1621 case 6: return saveKeys(filename
);
1627 static command_t CommandTable
[] =
1629 {"help", CmdHelp
, 1, "This help"},
1630 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1631 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1632 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1633 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1634 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1635 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1636 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1637 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1638 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1639 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1640 {"reader", CmdHFiClassReader
, 0, " Read an iClass tag"},
1641 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1642 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1643 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1644 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1645 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1646 {NULL
, NULL
, 0, NULL
}
1649 int CmdHFiClass(const char *Cmd
)
1651 CmdsParse(CommandTable
, Cmd
);
1655 int CmdHelp(const char *Cmd
)
1657 CmdsHelp(CommandTable
);