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"
39 static int CmdHelp(const char *Cmd
);
41 #define ICLASS_KEYS_MAX 8
42 static uint8_t iClass_Key_Table
[ICLASS_KEYS_MAX
][8] = {
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 },
50 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }
53 typedef struct iclass_block
{
57 int xorbits_8(uint8_t val
) {
58 uint8_t res
= val
^ (val
>> 1); //1st pass
59 res
= res
^ (res
>> 1); // 2nd pass
60 res
= res
^ (res
>> 2); // 3rd pass
61 res
= res
^ (res
>> 4); // 4th pass
65 int CmdHFiClassList(const char *Cmd
) {
66 //PrintAndLog("Deprecated command, use 'hf list iclass' instead");
71 int CmdHFiClassSnoop(const char *Cmd
) {
72 UsbCommand c
= {CMD_SNOOP_ICLASS
};
77 int usage_hf_iclass_sim(void) {
78 PrintAndLog("Usage: hf iclass sim <option> [CSN]");
79 PrintAndLog(" options");
80 PrintAndLog(" 0 <CSN> simulate the given CSN");
81 PrintAndLog(" 1 simulate default CSN");
82 PrintAndLog(" 2 Reader-attack, gather reader responses to extract elite key");
83 PrintAndLog(" 3 Full simulation using emulator memory (see 'hf iclass eload')");
84 PrintAndLog(" example: hf iclass sim 0 031FEC8AF7FF12E0");
85 PrintAndLog(" example: hf iclass sim 2");
86 PrintAndLog(" example: hf iclass eload 'tagdump.bin'");
87 PrintAndLog(" hf iclass sim 3");
92 int CmdHFiClassSim(const char *Cmd
) {
94 uint8_t CSN
[8] = {0, 0, 0, 0, 0, 0, 0, 0};
97 return usage_hf_iclass_sim();
99 simType
= param_get8ex(Cmd
, 0, 0, 10);
103 if (param_gethex(Cmd
, 1, CSN
, 16)) {
104 PrintAndLog("A CSN should consist of 16 HEX symbols");
105 return usage_hf_iclass_sim();
108 PrintAndLog("--simtype:%02x csn:%s", simType
, sprint_hex(CSN
, 8));
112 PrintAndLog("Undefined simptype %d", simType
);
113 return usage_hf_iclass_sim();
116 uint8_t numberOfCSNs
=0;
119 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,NUM_CSNS
}};
120 UsbCommand resp
= {0};
122 uint8_t csns
[8*NUM_CSNS
] = {
123 0x00, 0x0B, 0x0F, 0xFF, 0xF7, 0xFF, 0x12, 0xE0,
124 0x00, 0x04, 0x0E, 0x08, 0xF7, 0xFF, 0x12, 0xE0,
125 0x00, 0x09, 0x0D, 0x05, 0xF7, 0xFF, 0x12, 0xE0,
126 0x00, 0x0A, 0x0C, 0x06, 0xF7, 0xFF, 0x12, 0xE0,
127 0x00, 0x0F, 0x0B, 0x03, 0xF7, 0xFF, 0x12, 0xE0,
128 0x00, 0x08, 0x0A, 0x0C, 0xF7, 0xFF, 0x12, 0xE0,
129 0x00, 0x0D, 0x09, 0x09, 0xF7, 0xFF, 0x12, 0xE0,
130 0x00, 0x0E, 0x08, 0x0A, 0xF7, 0xFF, 0x12, 0xE0,
131 0x00, 0x03, 0x07, 0x17, 0xF7, 0xFF, 0x12, 0xE0,
132 0x00, 0x3C, 0x06, 0xE0, 0xF7, 0xFF, 0x12, 0xE0,
133 0x00, 0x01, 0x05, 0x1D, 0xF7, 0xFF, 0x12, 0xE0,
134 0x00, 0x02, 0x04, 0x1E, 0xF7, 0xFF, 0x12, 0xE0,
135 0x00, 0x07, 0x03, 0x1B, 0xF7, 0xFF, 0x12, 0xE0,
136 0x00, 0x00, 0x02, 0x24, 0xF7, 0xFF, 0x12, 0xE0,
137 0x00, 0x05, 0x01, 0x21, 0xF7, 0xFF, 0x12, 0xE0 };
139 memcpy(c
.d
.asBytes
, csns
, 8*NUM_CSNS
);
142 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, -1)) {
143 PrintAndLog("Command timed out");
147 uint8_t num_mac_responses
= resp
.arg
[1];
148 PrintAndLog("Mac responses: %d MACs obtained (should be %d)", num_mac_responses
,NUM_CSNS
);
150 size_t datalen
= NUM_CSNS
*24;
152 * Now, time to dump to file. We'll use this format:
153 * <8-byte CSN><8-byte CC><4 byte NR><4 byte MAC>....
154 * So, it should wind up as
157 * The returndata from the pm3 is on the following format
158 * <4 byte NR><4 byte MAC>
159 * CC are all zeroes, CSN is the same as was sent in
161 void* dump
= malloc(datalen
);
162 memset(dump
,0,datalen
);//<-- Need zeroes for the CC-field
164 for(i
= 0 ; i
< NUM_CSNS
; i
++)
166 memcpy(dump
+i
*24, csns
+i
*8,8); //CSN
167 //8 zero bytes here...
168 //Then comes NR_MAC (eight bytes from the response)
169 memcpy(dump
+i
*24+16,resp
.d
.asBytes
+i
*8,8);
172 /** Now, save to dumpfile **/
173 saveFile("iclass_mac_attack", "bin", dump
,datalen
);
177 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,numberOfCSNs
}};
178 memcpy(c
.d
.asBytes
, CSN
, 8);
185 int HFiClassReader(const char *Cmd
, bool loop
, bool verbose
) {
186 bool tagFound
= false;
187 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
188 FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_AA
}};
189 // loop in client not device - else on windows have a communication error
190 c
.arg
[0] |= FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
;
194 if (WaitForResponseTimeout(CMD_ACK
,&resp
, 4500)) {
195 uint8_t readStatus
= resp
.arg
[0] & 0xff;
196 uint8_t *data
= resp
.d
.asBytes
;
199 PrintAndLog("Readstatus:%02x", readStatus
);
200 if( readStatus
== 0){
202 if (verbose
) PrintAndLog("Quitting...");
205 if( readStatus
& FLAG_ICLASS_READER_CSN
){
206 PrintAndLog("CSN: %s",sprint_hex(data
,8));
209 if( readStatus
& FLAG_ICLASS_READER_CC
) PrintAndLog("CC: %s",sprint_hex(data
+16,8));
210 if( readStatus
& FLAG_ICLASS_READER_CONF
){
211 printIclassDumpInfo(data
);
213 if (tagFound
&& !loop
) return 1;
215 if (verbose
) PrintAndLog("Command execute timeout");
222 int CmdHFiClassReader(const char *Cmd
) {
223 return HFiClassReader(Cmd
, true, true);
226 int CmdHFiClassReader_Replay(const char *Cmd
) {
227 uint8_t readerType
= 0;
228 uint8_t MAC
[4]={0x00, 0x00, 0x00, 0x00};
231 PrintAndLog("Usage: hf iclass replay <MAC>");
232 PrintAndLog(" sample: hf iclass replay 00112233");
236 if (param_gethex(Cmd
, 0, MAC
, 8)) {
237 PrintAndLog("MAC must include 8 HEX symbols");
241 UsbCommand c
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
242 memcpy(c
.d
.asBytes
, MAC
, 4);
248 int iclassEmlSetMem(uint8_t *data
, int blockNum
, int blocksCount
) {
249 UsbCommand c
= {CMD_MIFARE_EML_MEMSET
, {blockNum
, blocksCount
, 0}};
250 memcpy(c
.d
.asBytes
, data
, blocksCount
* 16);
255 int hf_iclass_eload_usage(void) {
256 PrintAndLog("Loads iclass tag-dump into emulator memory on device");
257 PrintAndLog("Usage: hf iclass eload f <filename>");
259 PrintAndLog("Example: hf iclass eload f iclass_tagdump-aa162d30f8ff12f1.bin");
263 int CmdHFiClassELoad(const char *Cmd
) {
265 char opt
= param_getchar(Cmd
, 0);
266 if (strlen(Cmd
)<1 || opt
== 'h')
267 return hf_iclass_eload_usage();
269 //File handling and reading
271 char filename
[FILE_PATH_SIZE
];
272 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
274 f
= fopen(filename
, "rb");
276 return hf_iclass_eload_usage();
280 PrintAndLog("Failed to read from file '%s'", filename
);
284 fseek(f
, 0, SEEK_END
);
285 long fsize
= ftell(f
);
286 fseek(f
, 0, SEEK_SET
);
288 uint8_t *dump
= malloc(fsize
);
291 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
294 printIclassDumpInfo(dump
);
297 if (bytes_read
< fsize
)
299 prnlog("Error, could only read %d bytes (should be %d)",bytes_read
, fsize
);
304 uint32_t bytes_sent
= 0;
305 uint32_t bytes_remaining
= bytes_read
;
307 while(bytes_remaining
> 0){
308 uint32_t bytes_in_packet
= MIN(USB_CMD_DATA_SIZE
, bytes_remaining
);
309 UsbCommand c
= {CMD_ICLASS_EML_MEMSET
, {bytes_sent
,bytes_in_packet
,0}};
310 memcpy(c
.d
.asBytes
, dump
, bytes_in_packet
);
312 bytes_remaining
-= bytes_in_packet
;
313 bytes_sent
+= bytes_in_packet
;
316 PrintAndLog("Sent %d bytes of data to device emulator memory", bytes_sent
);
320 static int readKeyfile(const char *filename
, size_t len
, uint8_t* buffer
) {
321 FILE *f
= fopen(filename
, "rb");
323 PrintAndLog("Failed to read from file '%s'", filename
);
326 fseek(f
, 0, SEEK_END
);
327 long fsize
= ftell(f
);
328 fseek(f
, 0, SEEK_SET
);
329 size_t bytes_read
= fread(buffer
, 1, len
, f
);
333 PrintAndLog("Warning, file size is %d, expected %d", fsize
, len
);
336 if(bytes_read
!= len
)
338 PrintAndLog("Warning, could only read %d bytes, expected %d" ,bytes_read
, len
);
344 int usage_hf_iclass_decrypt(void) {
345 PrintAndLog("Usage: hf iclass decrypt f <tagdump>");
347 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
348 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
350 PrintAndLog("example: hf iclass decrypt f tagdump_12312342343.bin");
352 PrintAndLog("OBS! This is pretty stupid implementation, it tries to decrypt every block after block 6. ");
353 PrintAndLog("Correct behaviour would be to decrypt only the application areas where the key is valid,");
354 PrintAndLog("which is defined by the configuration block.");
358 int CmdHFiClassDecrypt(const char *Cmd
) {
359 uint8_t key
[16] = { 0 };
360 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
362 usage_hf_iclass_decrypt();
365 PrintAndLog("Decryption file found... ");
366 char opt
= param_getchar(Cmd
, 0);
367 if (strlen(Cmd
)<1 || opt
== 'h')
368 return usage_hf_iclass_decrypt();
370 //Open the tagdump-file
372 char filename
[FILE_PATH_SIZE
];
373 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
375 f
= fopen(filename
, "rb");
377 return usage_hf_iclass_decrypt();
380 fseek(f
, 0, SEEK_END
);
381 long fsize
= ftell(f
);
382 fseek(f
, 0, SEEK_SET
);
383 uint8_t enc_dump
[8] = {0};
384 uint8_t *decrypted
= malloc(fsize
);
385 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
386 des3_set2key_dec( &ctx
, key
);
387 size_t bytes_read
= fread(enc_dump
, 1, 8, f
);
389 //Use the first block (CSN) for filename
390 char outfilename
[FILE_PATH_SIZE
] = { 0 };
391 snprintf(outfilename
,FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x-decrypted",
392 enc_dump
[0],enc_dump
[1],enc_dump
[2],enc_dump
[3],
393 enc_dump
[4],enc_dump
[5],enc_dump
[6],enc_dump
[7]);
396 while(bytes_read
== 8)
400 memcpy(decrypted
+(blocknum
*8), enc_dump
, 8);
402 des3_crypt_ecb(&ctx
, enc_dump
,decrypted
+(blocknum
*8) );
404 printvar("decrypted block", decrypted
+(blocknum
*8), 8);
405 bytes_read
= fread(enc_dump
, 1, 8, f
);
410 saveFile(outfilename
,"bin", decrypted
, blocknum
*8);
415 int usage_hf_iclass_encrypt(void) {
416 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
418 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
419 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
421 PrintAndLog("example: hf iclass encrypt 0102030405060708");
426 static int iClassEncryptBlkData(uint8_t *blkData
) {
427 uint8_t key
[16] = { 0 };
428 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
430 usage_hf_iclass_encrypt();
433 PrintAndLog("Decryption file found... ");
435 uint8_t encryptedData
[16];
436 uint8_t *encrypted
= encryptedData
;
437 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
438 des3_set2key_enc( &ctx
, key
);
440 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
441 //printvar("decrypted block", decrypted, 8);
442 memcpy(blkData
,encrypted
,8);
447 int CmdHFiClassEncryptBlk(const char *Cmd
) {
448 uint8_t blkData
[8] = {0};
449 char opt
= param_getchar(Cmd
, 0);
450 if (strlen(Cmd
)<1 || opt
== 'h')
451 return usage_hf_iclass_encrypt();
453 //get the bytes to encrypt
454 if (param_gethex(Cmd
, 0, blkData
, 16))
456 PrintAndLog("BlockData must include 16 HEX symbols");
459 if (!iClassEncryptBlkData(blkData
)) return 0;
461 printvar("encrypted block", blkData
, 8);
465 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
468 memcpy(WB
+ 1,data
,8);
469 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
470 //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]);
473 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
476 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
477 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
479 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
481 clearCommandBuffer();
483 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
485 PrintAndLog("Command execute timeout");
489 uint8_t isOK
= resp
.arg
[0] & 0xff;
490 uint8_t *data
= resp
.d
.asBytes
;
493 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
496 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
499 PrintAndLog("Failed to obtain CC! Aborting");
505 static bool select_and_auth(uint8_t *KEY
, uint8_t *MAC
, uint8_t *div_key
, bool use_credit_key
, bool elite
, bool verbose
) {
506 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
507 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
509 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
513 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
515 doMAC(CCNR
, div_key
, MAC
);
517 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
518 memcpy(d
.d
.asBytes
, MAC
, 4);
519 clearCommandBuffer();
521 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
523 PrintAndLog("Auth Command execute timeout");
526 uint8_t isOK
= resp
.arg
[0] & 0xff;
528 PrintAndLog("Authentication error");
534 int usage_hf_iclass_dump(void) {
535 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e\n");
536 PrintAndLog("Options:");
537 PrintAndLog(" f <filename> : specify a filename to save dump to");
538 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
539 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
540 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
541 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
542 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
543 PrintAndLog(" NOTE: * = required");
544 PrintAndLog("Samples:");
545 PrintAndLog(" hf iclass dump k 001122334455667B");
546 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
547 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
551 int CmdHFiClassReader_Dump(const char *Cmd
) {
553 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
554 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
555 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
559 uint8_t app_areas
= 1;
561 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
562 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
565 uint8_t fileNameLen
= 0;
566 char filename
[FILE_PATH_SIZE
]={0};
567 char tempStr
[50] = {0};
568 bool have_debit_key
= false;
569 bool have_credit_key
= false;
570 bool use_credit_key
= false;
575 while(param_getchar(Cmd
, cmdp
) != 0x00)
577 switch(param_getchar(Cmd
, cmdp
))
581 return usage_hf_iclass_dump();
584 have_credit_key
= true;
585 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
587 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
588 } else if (dataLen
== 1) {
589 keyNbr
= param_get8(Cmd
, cmdp
+1);
590 if (keyNbr
<= ICLASS_KEYS_MAX
) {
591 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
593 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
597 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
609 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
610 if (fileNameLen
< 1) {
611 PrintAndLog("No filename found after f");
618 have_debit_key
= true;
619 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
621 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
622 } else if (dataLen
== 1) {
623 keyNbr
= param_get8(Cmd
, cmdp
+1);
624 if (keyNbr
<= ICLASS_KEYS_MAX
) {
625 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
627 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
631 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
637 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
641 if(errors
) return usage_hf_iclass_dump();
644 if (cmdp
< 2) return usage_hf_iclass_dump();
645 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
646 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
648 //get config and first 3 blocks
649 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
650 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
652 uint8_t tag_data
[255*8];
654 clearCommandBuffer();
656 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
657 PrintAndLog("Command execute timeout");
658 ul_switch_off_field();
661 uint8_t readStatus
= resp
.arg
[0] & 0xff;
662 uint8_t * data
= resp
.d
.asBytes
;
665 PrintAndLog("No tag found...");
666 ul_switch_off_field();
669 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
670 memcpy(tag_data
, data
, 8*3);
671 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
673 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
674 // large memory - not able to dump pages currently
675 if (numblks
> maxBlk
) numblks
= maxBlk
;
677 ul_switch_off_field();
678 // authenticate debit key and get div_key - later store in dump block 3
679 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, false)){
680 //try twice - for some reason it sometimes fails the first time...
681 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, false)){
682 ul_switch_off_field();
688 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
689 clearCommandBuffer();
691 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
692 PrintAndLog("Command execute time-out 1");
693 ul_switch_off_field();
696 uint32_t blocksRead
= resp
.arg
[1];
697 uint8_t isOK
= resp
.arg
[0] & 0xff;
698 if (!isOK
&& !blocksRead
) {
699 PrintAndLog("Read Block Failed");
700 ul_switch_off_field();
703 uint32_t startindex
= resp
.arg
[2];
704 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
705 PrintAndLog("Data exceeded Buffer size!");
706 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
708 // response ok - now get bigbuf content of the dump
709 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
710 WaitForResponse(CMD_ACK
,NULL
);
711 size_t gotBytes
= blocksRead
*8 + blockno
*8;
714 if (have_credit_key
) {
715 //turn off hf field before authenticating with different key
716 ul_switch_off_field();
718 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
719 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false)){
720 //try twice - for some reason it sometimes fails the first time...
721 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false)){
722 ul_switch_off_field();
726 // do we still need to read more block? (aa2 enabled?)
727 if (maxBlk
> blockno
+numblks
+1) {
728 // setup dump and start
729 w
.arg
[0] = blockno
+ blocksRead
;
730 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
731 clearCommandBuffer();
733 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
734 PrintAndLog("Command execute timeout 2");
735 ul_switch_off_field();
738 uint8_t isOK
= resp
.arg
[0] & 0xff;
739 blocksRead
= resp
.arg
[1];
740 if (!isOK
&& !blocksRead
) {
741 PrintAndLog("Read Block Failed 2");
742 ul_switch_off_field();
746 startindex
= resp
.arg
[2];
747 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
748 PrintAndLog("Data exceeded Buffer size!");
749 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
751 // get dumped data from bigbuf
752 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
753 WaitForResponse(CMD_ACK
,NULL
);
755 gotBytes
+= blocksRead
*8;
756 } else { //field is still on - turn it off...
757 ul_switch_off_field();
761 // add diversified keys to dump
762 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
763 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
765 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
766 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
767 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
769 if (filename
[0] == 0){
770 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
771 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
772 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
775 // save the dump to .bin file
776 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
777 saveFile(filename
, "bin", tag_data
, gotBytes
);
781 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool verbose
) {
782 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
783 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
784 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, verbose
))
789 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
790 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
791 memcpy(w
.d
.asBytes
, bldata
, 8);
792 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
794 clearCommandBuffer();
796 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
798 PrintAndLog("Write Command execute timeout");
801 uint8_t isOK
= resp
.arg
[0] & 0xff;
803 PrintAndLog("Write Block Failed");
806 PrintAndLog("Write Block Successful");
810 int usage_hf_iclass_writeblock(void) {
811 PrintAndLog("Options:");
812 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
813 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
814 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
815 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
816 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
817 PrintAndLog("Samples:");
818 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
819 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
820 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
824 int CmdHFiClass_WriteBlock(const char *Cmd
) {
826 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
827 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
830 char tempStr
[50] = {0};
831 bool use_credit_key
= false;
835 while(param_getchar(Cmd
, cmdp
) != 0x00)
837 switch(param_getchar(Cmd
, cmdp
))
841 return usage_hf_iclass_writeblock();
844 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
845 PrintAndLog("Block No must include 2 HEX symbols\n");
852 use_credit_key
= true;
857 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
859 PrintAndLog("KEY must include 16 HEX symbols\n");
871 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
873 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
874 } else if (dataLen
== 1) {
875 keyNbr
= param_get8(Cmd
, cmdp
+1);
876 if (keyNbr
<= ICLASS_KEYS_MAX
) {
877 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
879 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
883 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
889 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
893 if(errors
) return usage_hf_iclass_writeblock();
896 if (cmdp
< 6) return usage_hf_iclass_writeblock();
897 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, true);
898 ul_switch_off_field();
902 int usage_hf_iclass_clone(void) {
903 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> e c");
904 PrintAndLog("Options:");
905 PrintAndLog(" f <filename>: specify a filename to clone from");
906 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
907 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
908 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
909 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
910 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
911 PrintAndLog("Samples:");
912 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
913 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
914 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
918 int CmdHFiClassCloneTag(const char *Cmd
) {
919 char filename
[FILE_PATH_SIZE
];
920 char tempStr
[50]={0};
921 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
923 uint8_t fileNameLen
= 0;
924 uint8_t startblock
= 0;
925 uint8_t endblock
= 0;
927 bool use_credit_key
= false;
931 while(param_getchar(Cmd
, cmdp
) != 0x00)
933 switch(param_getchar(Cmd
, cmdp
))
937 return usage_hf_iclass_clone();
940 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
941 PrintAndLog("Start Block No must include 2 HEX symbols\n");
948 use_credit_key
= true;
958 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
959 if (fileNameLen
< 1) {
960 PrintAndLog("No filename found after f");
967 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
969 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
970 } else if (dataLen
== 1) {
971 keyNbr
= param_get8(Cmd
, cmdp
+1);
972 if (keyNbr
<= ICLASS_KEYS_MAX
) {
973 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
975 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
979 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
986 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
987 PrintAndLog("Start Block No must include 2 HEX symbols\n");
993 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
997 if(errors
) return usage_hf_iclass_clone();
1000 if (cmdp
< 8) return usage_hf_iclass_clone();
1004 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1006 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1007 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1009 // file handling and reading
1010 f
= fopen(filename
,"rb");
1012 PrintAndLog("Failed to read from file '%s'", filename
);
1017 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1020 // now read data from the file from block 6 --- 19
1021 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1022 // 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,
1023 // else we have to create a share memory
1025 fseek(f
,startblock
*8,SEEK_SET
);
1026 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0){
1027 PrintAndLog("File reading error.");
1032 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1033 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1035 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, true))
1038 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1040 // calculate all mac for every the block we will write
1041 for (i
= startblock
; i
<= endblock
; i
++){
1042 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1043 // usb command d start pointer = d + (i - 6) * 12
1044 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1045 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1047 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1048 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1049 memcpy(ptr
+ 8,MAC
, 4);
1052 for (i
= 0; i
<= endblock
- startblock
;i
++){
1053 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1054 printf("Block |%02x|",i
+ startblock
);
1055 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]);
1056 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1060 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1062 PrintAndLog("Command execute timeout");
1068 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool verbose
) {
1069 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1070 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1072 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, verbose
))
1076 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1077 clearCommandBuffer();
1079 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1081 PrintAndLog("Command execute timeout");
1084 uint8_t isOK
= resp
.arg
[0] & 0xff;
1086 PrintAndLog("Read Block Failed");
1089 //data read is stored in: resp.d.asBytes[0-15]
1090 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1094 int usage_hf_iclass_readblock(void) {
1095 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e\n");
1096 PrintAndLog("Options:");
1097 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1098 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1099 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1100 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1101 PrintAndLog("Samples:");
1102 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1103 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1104 PrintAndLog(" hf iclass readblk b 0A k 0");
1108 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1110 uint8_t keyType
= 0x88; //debit key
1111 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1113 uint8_t dataLen
= 0;
1114 char tempStr
[50] = {0};
1116 bool errors
= false;
1118 while(param_getchar(Cmd
, cmdp
) != 0x00)
1120 switch(param_getchar(Cmd
, cmdp
))
1124 return usage_hf_iclass_readblock();
1127 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1128 PrintAndLog("Block No must include 2 HEX symbols\n");
1145 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1146 if (dataLen
== 16) {
1147 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1148 } else if (dataLen
== 1) {
1149 keyNbr
= param_get8(Cmd
, cmdp
+1);
1150 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1151 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1153 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1157 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1163 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1167 if(errors
) return usage_hf_iclass_readblock();
1170 if (cmdp
< 4) return usage_hf_iclass_readblock();
1172 return ReadBlock(KEY
, blockno
, keyType
, elite
, true);
1175 int CmdHFiClass_loclass(const char *Cmd
) {
1176 char opt
= param_getchar(Cmd
, 0);
1178 if (strlen(Cmd
)<1 || opt
== 'h') {
1179 PrintAndLog("Usage: hf iclass loclass [options]");
1180 PrintAndLog("Options:");
1181 PrintAndLog("h Show this help");
1182 PrintAndLog("t Perform self-test");
1183 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1184 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1185 PrintAndLog(" malicious CSNs, and their protocol responses");
1186 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
1187 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1188 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1189 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1190 PrintAndLog(" ... totalling N*24 bytes");
1193 char fileName
[255] = {0};
1196 if(param_getstr(Cmd
, 1, fileName
) > 0)
1198 return bruteforceFileNoKeys(fileName
);
1201 PrintAndLog("You must specify a filename");
1206 int errors
= testCipherUtils();
1207 errors
+= testMAC();
1208 errors
+= doKeyTests(0);
1209 errors
+= testElite();
1212 prnlog("OBS! There were errors!!!");
1220 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1221 uint8_t blockdata
[8];
1223 memcpy(&mem_config
, iclass_dump
+ 13,1);
1224 uint8_t maxmemcount
;
1225 uint8_t filemaxblock
= filesize
/ 8;
1226 if (mem_config
& 0x80)
1230 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1232 if (startblock
== 0)
1234 if ((endblock
> maxmemcount
) || (endblock
== 0))
1235 endblock
= maxmemcount
;
1236 if (endblock
> filemaxblock
)
1237 endblock
= filemaxblock
;
1240 while (i
<= endblock
){
1241 printf("Block |%02X| ",i
);
1242 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1243 for (j
= 0;j
< 8;j
++)
1244 printf("%02X ",blockdata
[j
]);
1250 int usage_hf_iclass_readtagfile() {
1251 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1255 int CmdHFiClassReadTagFile(const char *Cmd
) {
1260 char filename
[FILE_PATH_SIZE
];
1261 if (param_getstr(Cmd
, 0, filename
) < 1)
1262 return usage_hf_iclass_readtagfile();
1263 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1266 sscanf(tempnum
,"%d",&startblock
);
1268 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1271 sscanf(tempnum
,"%d",&endblock
);
1272 // file handling and reading
1273 f
= fopen(filename
,"rb");
1275 PrintAndLog("Failed to read from file '%s'", filename
);
1278 fseek(f
, 0, SEEK_END
);
1279 long fsize
= ftell(f
);
1280 fseek(f
, 0, SEEK_SET
);
1282 uint8_t *dump
= malloc(fsize
);
1285 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1287 uint8_t *csn
= dump
;
1288 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]);
1289 // printIclassDumpInfo(dump);
1290 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1296 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1297 uint64_t new_div = 0x00;
1303 uint64_t hexarray_to_uint64(uint8_t *key) {
1306 for (int i = 0;i < 8;i++)
1307 sprintf(&temp[(i *2)],"%02X",key[i]);
1309 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1314 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1315 uint8_t keytable
[128] = {0};
1316 uint8_t key_index
[8] = {0};
1318 uint8_t key_sel
[8] = { 0 };
1319 uint8_t key_sel_p
[8] = { 0 };
1320 hash2(KEY
, keytable
);
1321 hash1(CSN
, key_index
);
1322 for(uint8_t i
= 0; i
< 8 ; i
++)
1323 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1325 //Permute from iclass format to standard format
1326 permutekey_rev(key_sel
, key_sel_p
);
1327 diversifyKey(CSN
, key_sel_p
, div_key
);
1329 diversifyKey(CSN
, KEY
, div_key
);
1333 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1334 //calculate and return xor_div_key (ready for a key write command)
1335 //print all div_keys if verbose
1336 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1337 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1338 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1340 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1342 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1344 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1345 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1348 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1349 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1350 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1354 int usage_hf_iclass_calc_newkey(void) {
1355 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1356 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1357 PrintAndLog(" Options:");
1358 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1359 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1360 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1361 PrintAndLog(" e : specify new key as elite calc");
1362 PrintAndLog(" ee : specify old and new key as elite calc");
1363 PrintAndLog("Samples:");
1364 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1365 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1366 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1367 PrintAndLog("NOTE: * = required\n");
1372 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1373 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1374 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1375 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1376 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1377 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1379 uint8_t dataLen
= 0;
1380 char tempStr
[50] = {0};
1381 bool givenCSN
= false;
1382 bool oldElite
= false;
1384 bool errors
= false;
1386 while(param_getchar(Cmd
, cmdp
) != 0x00)
1388 switch(param_getchar(Cmd
, cmdp
))
1392 return usage_hf_iclass_calc_newkey();
1395 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1403 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1404 if (dataLen
== 16) {
1405 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1406 } else if (dataLen
== 1) {
1407 keyNbr
= param_get8(Cmd
, cmdp
+1);
1408 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1409 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1411 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1415 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1422 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1423 if (dataLen
== 16) {
1424 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1425 } else if (dataLen
== 1) {
1426 keyNbr
= param_get8(Cmd
, cmdp
+1);
1427 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1428 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1430 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1434 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1442 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1443 return usage_hf_iclass_calc_newkey();
1447 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1451 if(errors
) return usage_hf_iclass_calc_newkey();
1454 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1457 if (!select_only(CSN
, CCNR
, false, true))
1460 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1464 static int loadKeys(char *filename
) {
1466 f
= fopen(filename
,"rb");
1468 PrintAndLog("Failed to read from file '%s'", filename
);
1471 fseek(f
, 0, SEEK_END
);
1472 long fsize
= ftell(f
);
1473 fseek(f
, 0, SEEK_SET
);
1475 uint8_t *dump
= malloc(fsize
);
1477 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1479 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1480 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1485 for (; i
< bytes_read
/8; i
++){
1486 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1489 PrintAndLog("%u keys loaded", i
);
1493 static int saveKeys(char *filename
) {
1495 f
= fopen(filename
,"wb");
1497 printf("error opening file %s\n",filename
);
1500 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1501 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1502 PrintAndLog("save key failed to write to file: %s", filename
);
1510 static int printKeys(void) {
1512 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1513 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1519 int usage_hf_iclass_managekeys(void) {
1520 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1521 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1522 PrintAndLog(" Options:");
1523 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1524 PrintAndLog(" k <key> : set a key in memory");
1525 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1526 PrintAndLog(" s : save keys in memory to file specified by filename");
1527 PrintAndLog(" l : load keys to memory from file specified by filename");
1528 PrintAndLog(" p : print keys loaded into memory\n");
1529 PrintAndLog("Samples:");
1530 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1531 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1532 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1533 PrintAndLog(" print keys : hf iclass managekeys p\n");
1537 int CmdHFiClassManageKeys(const char *Cmd
) {
1539 uint8_t dataLen
= 0;
1540 uint8_t KEY
[8] = {0};
1541 char filename
[FILE_PATH_SIZE
];
1542 uint8_t fileNameLen
= 0;
1543 bool errors
= false;
1544 uint8_t operation
= 0;
1548 while(param_getchar(Cmd
, cmdp
) != 0x00)
1550 switch(param_getchar(Cmd
, cmdp
))
1554 return usage_hf_iclass_managekeys();
1557 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1558 if (fileNameLen
< 1) {
1559 PrintAndLog("No filename found after f");
1566 keyNbr
= param_get8(Cmd
, cmdp
+1);
1568 PrintAndLog("Wrong block number");
1575 operation
+= 3; //set key
1576 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1577 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1578 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1580 PrintAndLog("\nERROR: Key is incorrect length\n");
1587 operation
+= 4; //print keys in memory
1592 operation
+= 5; //load keys from file
1597 operation
+= 6; //save keys to file
1601 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1605 if(errors
) return usage_hf_iclass_managekeys();
1607 if (operation
== 0){
1608 PrintAndLog("no operation specified (load, save, or print)\n");
1609 return usage_hf_iclass_managekeys();
1612 PrintAndLog("Too many operations specified\n");
1613 return usage_hf_iclass_managekeys();
1615 if (operation
> 4 && fileNameLen
== 0){
1616 PrintAndLog("You must enter a filename when loading or saving\n");
1617 return usage_hf_iclass_managekeys();
1621 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1622 case 4: return printKeys();
1623 case 5: return loadKeys(filename
);
1624 case 6: return saveKeys(filename
);
1630 static command_t CommandTable
[] =
1632 {"help", CmdHelp
, 1, "This help"},
1633 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1634 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1635 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1636 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1637 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1638 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1639 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1640 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1641 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1642 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1643 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
1644 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1645 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1646 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1647 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1648 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1649 {NULL
, NULL
, 0, NULL
}
1652 int CmdHFiClass(const char *Cmd
)
1654 CmdsParse(CommandTable
, Cmd
);
1658 int CmdHelp(const char *Cmd
)
1660 CmdsHelp(CommandTable
);