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 rawkey
, 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
))
514 memcpy(div_key
, KEY
, 8);
516 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
517 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]);
519 doMAC(CCNR
, div_key
, MAC
);
521 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
522 memcpy(d
.d
.asBytes
, MAC
, 4);
523 clearCommandBuffer();
525 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
527 PrintAndLog("Auth Command execute timeout");
530 uint8_t isOK
= resp
.arg
[0] & 0xff;
532 PrintAndLog("Authentication error");
538 int usage_hf_iclass_dump(void) {
539 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e|r\n");
540 PrintAndLog("Options:");
541 PrintAndLog(" f <filename> : specify a filename to save dump to");
542 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
543 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
544 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
545 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
546 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
547 PrintAndLog(" r : If 'r' is specified, the key is interpreted as raw block 3/4");
548 PrintAndLog(" NOTE: * = required");
549 PrintAndLog("Samples:");
550 PrintAndLog(" hf iclass dump k 001122334455667B");
551 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
552 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
556 int CmdHFiClassReader_Dump(const char *Cmd
) {
558 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
559 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
560 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
564 uint8_t app_areas
= 1;
566 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
567 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
570 uint8_t fileNameLen
= 0;
571 char filename
[FILE_PATH_SIZE
]={0};
572 char tempStr
[50] = {0};
573 bool have_debit_key
= false;
574 bool have_credit_key
= false;
575 bool use_credit_key
= false;
581 while(param_getchar(Cmd
, cmdp
) != 0x00)
583 switch(param_getchar(Cmd
, cmdp
))
587 return usage_hf_iclass_dump();
590 have_credit_key
= true;
591 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
593 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
594 } else if (dataLen
== 1) {
595 keyNbr
= param_get8(Cmd
, cmdp
+1);
596 if (keyNbr
<= ICLASS_KEYS_MAX
) {
597 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
599 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
603 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
615 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
616 if (fileNameLen
< 1) {
617 PrintAndLog("No filename found after f");
624 have_debit_key
= true;
625 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
627 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
628 } else if (dataLen
== 1) {
629 keyNbr
= param_get8(Cmd
, cmdp
+1);
630 if (keyNbr
<= ICLASS_KEYS_MAX
) {
631 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
633 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
637 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
648 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
652 if(errors
) return usage_hf_iclass_dump();
655 if (cmdp
< 2) return usage_hf_iclass_dump();
656 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
657 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
659 //get config and first 3 blocks
660 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
661 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
663 uint8_t tag_data
[255*8];
665 clearCommandBuffer();
667 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
668 PrintAndLog("Command execute timeout");
669 ul_switch_off_field();
672 uint8_t readStatus
= resp
.arg
[0] & 0xff;
673 uint8_t * data
= resp
.d
.asBytes
;
676 PrintAndLog("No tag found...");
677 ul_switch_off_field();
680 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
681 memcpy(tag_data
, data
, 8*3);
682 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
684 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
685 // large memory - not able to dump pages currently
686 if (numblks
> maxBlk
) numblks
= maxBlk
;
688 ul_switch_off_field();
689 // authenticate debit key and get div_key - later store in dump block 3
690 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
691 //try twice - for some reason it sometimes fails the first time...
692 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
693 ul_switch_off_field();
699 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
700 clearCommandBuffer();
702 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
703 PrintAndLog("Command execute time-out 1");
704 ul_switch_off_field();
707 uint32_t blocksRead
= resp
.arg
[1];
708 uint8_t isOK
= resp
.arg
[0] & 0xff;
709 if (!isOK
&& !blocksRead
) {
710 PrintAndLog("Read Block Failed");
711 ul_switch_off_field();
714 uint32_t startindex
= resp
.arg
[2];
715 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
716 PrintAndLog("Data exceeded Buffer size!");
717 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
719 // response ok - now get bigbuf content of the dump
720 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
721 WaitForResponse(CMD_ACK
,NULL
);
722 size_t gotBytes
= blocksRead
*8 + blockno
*8;
725 if (have_credit_key
) {
726 //turn off hf field before authenticating with different key
727 ul_switch_off_field();
729 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
730 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
731 //try twice - for some reason it sometimes fails the first time...
732 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
733 ul_switch_off_field();
737 // do we still need to read more block? (aa2 enabled?)
738 if (maxBlk
> blockno
+numblks
+1) {
739 // setup dump and start
740 w
.arg
[0] = blockno
+ blocksRead
;
741 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
742 clearCommandBuffer();
744 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
745 PrintAndLog("Command execute timeout 2");
746 ul_switch_off_field();
749 uint8_t isOK
= resp
.arg
[0] & 0xff;
750 blocksRead
= resp
.arg
[1];
751 if (!isOK
&& !blocksRead
) {
752 PrintAndLog("Read Block Failed 2");
753 ul_switch_off_field();
757 startindex
= resp
.arg
[2];
758 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
759 PrintAndLog("Data exceeded Buffer size!");
760 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
762 // get dumped data from bigbuf
763 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
764 WaitForResponse(CMD_ACK
,NULL
);
766 gotBytes
+= blocksRead
*8;
767 } else { //field is still on - turn it off...
768 ul_switch_off_field();
772 // add diversified keys to dump
773 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
774 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
776 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
777 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
778 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
780 if (filename
[0] == 0){
781 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
782 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
783 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
786 // save the dump to .bin file
787 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
788 saveFile(filename
, "bin", tag_data
, gotBytes
);
792 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
793 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
794 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
795 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, verbose
))
800 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
801 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
802 memcpy(w
.d
.asBytes
, bldata
, 8);
803 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
805 clearCommandBuffer();
807 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
809 PrintAndLog("Write Command execute timeout");
812 uint8_t isOK
= resp
.arg
[0] & 0xff;
814 PrintAndLog("Write Block Failed");
817 PrintAndLog("Write Block Successful");
821 int usage_hf_iclass_writeblock(void) {
822 PrintAndLog("Options:");
823 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
824 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
825 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
826 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
827 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
828 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
829 PrintAndLog("Samples:");
830 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
831 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
832 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
836 int CmdHFiClass_WriteBlock(const char *Cmd
) {
838 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
839 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
842 char tempStr
[50] = {0};
843 bool use_credit_key
= false;
848 while(param_getchar(Cmd
, cmdp
) != 0x00)
850 switch(param_getchar(Cmd
, cmdp
))
854 return usage_hf_iclass_writeblock();
857 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
858 PrintAndLog("Block No must include 2 HEX symbols\n");
865 use_credit_key
= true;
870 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
872 PrintAndLog("KEY must include 16 HEX symbols\n");
884 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
886 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
887 } else if (dataLen
== 1) {
888 keyNbr
= param_get8(Cmd
, cmdp
+1);
889 if (keyNbr
<= ICLASS_KEYS_MAX
) {
890 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
892 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
896 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
907 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
911 if(errors
) return usage_hf_iclass_writeblock();
914 if (cmdp
< 6) return usage_hf_iclass_writeblock();
915 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, rawkey
, true);
916 ul_switch_off_field();
920 int usage_hf_iclass_clone(void) {
921 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> c e|r");
922 PrintAndLog("Options:");
923 PrintAndLog(" f <filename>: specify a filename to clone from");
924 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
925 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
926 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
927 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
928 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
929 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
930 PrintAndLog("Samples:");
931 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
932 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
933 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
937 int CmdHFiClassCloneTag(const char *Cmd
) {
938 char filename
[FILE_PATH_SIZE
];
939 char tempStr
[50]={0};
940 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
942 uint8_t fileNameLen
= 0;
943 uint8_t startblock
= 0;
944 uint8_t endblock
= 0;
946 bool use_credit_key
= false;
951 while(param_getchar(Cmd
, cmdp
) != 0x00)
953 switch(param_getchar(Cmd
, cmdp
))
957 return usage_hf_iclass_clone();
960 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
961 PrintAndLog("Start Block No must include 2 HEX symbols\n");
968 use_credit_key
= true;
978 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
979 if (fileNameLen
< 1) {
980 PrintAndLog("No filename found after f");
987 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
989 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
990 } else if (dataLen
== 1) {
991 keyNbr
= param_get8(Cmd
, cmdp
+1);
992 if (keyNbr
<= ICLASS_KEYS_MAX
) {
993 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
995 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
999 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1006 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
1007 PrintAndLog("Start Block No must include 2 HEX symbols\n");
1018 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1022 if(errors
) return usage_hf_iclass_clone();
1025 if (cmdp
< 8) return usage_hf_iclass_clone();
1029 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1031 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1032 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1034 // file handling and reading
1035 f
= fopen(filename
,"rb");
1037 PrintAndLog("Failed to read from file '%s'", filename
);
1042 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1045 // now read data from the file from block 6 --- 19
1046 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1047 // 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,
1048 // else we have to create a share memory
1050 fseek(f
,startblock
*8,SEEK_SET
);
1051 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0){
1052 PrintAndLog("File reading error.");
1057 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1058 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1060 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, true))
1063 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1065 // calculate all mac for every the block we will write
1066 for (i
= startblock
; i
<= endblock
; i
++){
1067 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1068 // usb command d start pointer = d + (i - 6) * 12
1069 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1070 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1072 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1073 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1074 memcpy(ptr
+ 8,MAC
, 4);
1077 for (i
= 0; i
<= endblock
- startblock
;i
++){
1078 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1079 printf("Block |%02x|",i
+ startblock
);
1080 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]);
1081 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1085 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1087 PrintAndLog("Command execute timeout");
1093 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool rawkey
, bool verbose
) {
1094 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1095 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1097 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, rawkey
, verbose
))
1101 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1102 clearCommandBuffer();
1104 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1106 PrintAndLog("Command execute timeout");
1109 uint8_t isOK
= resp
.arg
[0] & 0xff;
1111 PrintAndLog("Read Block Failed");
1114 //data read is stored in: resp.d.asBytes[0-15]
1115 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1119 int usage_hf_iclass_readblock(void) {
1120 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e|r\n");
1121 PrintAndLog("Options:");
1122 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1123 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1124 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1125 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1126 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
1127 PrintAndLog("Samples:");
1128 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1129 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1130 PrintAndLog(" hf iclass readblk b 0A k 0");
1134 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1136 uint8_t keyType
= 0x88; //debit key
1137 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1139 uint8_t dataLen
= 0;
1140 char tempStr
[50] = {0};
1142 bool rawkey
= false;
1143 bool errors
= false;
1145 while(param_getchar(Cmd
, cmdp
) != 0x00)
1147 switch(param_getchar(Cmd
, cmdp
))
1151 return usage_hf_iclass_readblock();
1154 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1155 PrintAndLog("Block No must include 2 HEX symbols\n");
1172 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1173 if (dataLen
== 16) {
1174 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1175 } else if (dataLen
== 1) {
1176 keyNbr
= param_get8(Cmd
, cmdp
+1);
1177 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1178 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1180 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1184 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1195 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1199 if(errors
) return usage_hf_iclass_readblock();
1202 if (cmdp
< 4) return usage_hf_iclass_readblock();
1204 return ReadBlock(KEY
, blockno
, keyType
, elite
, rawkey
, true);
1207 int CmdHFiClass_loclass(const char *Cmd
) {
1208 char opt
= param_getchar(Cmd
, 0);
1210 if (strlen(Cmd
)<1 || opt
== 'h') {
1211 PrintAndLog("Usage: hf iclass loclass [options]");
1212 PrintAndLog("Options:");
1213 PrintAndLog("h Show this help");
1214 PrintAndLog("t Perform self-test");
1215 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1216 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1217 PrintAndLog(" malicious CSNs, and their protocol responses");
1218 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
1219 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1220 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1221 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1222 PrintAndLog(" ... totalling N*24 bytes");
1225 char fileName
[255] = {0};
1228 if(param_getstr(Cmd
, 1, fileName
) > 0)
1230 return bruteforceFileNoKeys(fileName
);
1233 PrintAndLog("You must specify a filename");
1238 int errors
= testCipherUtils();
1239 errors
+= testMAC();
1240 errors
+= doKeyTests(0);
1241 errors
+= testElite();
1244 prnlog("OBS! There were errors!!!");
1252 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1253 uint8_t blockdata
[8];
1255 memcpy(&mem_config
, iclass_dump
+ 13,1);
1256 uint8_t maxmemcount
;
1257 uint8_t filemaxblock
= filesize
/ 8;
1258 if (mem_config
& 0x80)
1262 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1264 if (startblock
== 0)
1266 if ((endblock
> maxmemcount
) || (endblock
== 0))
1267 endblock
= maxmemcount
;
1268 if (endblock
> filemaxblock
)
1269 endblock
= filemaxblock
;
1272 while (i
<= endblock
){
1273 printf("Block |%02X| ",i
);
1274 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1275 for (j
= 0;j
< 8;j
++)
1276 printf("%02X ",blockdata
[j
]);
1282 int usage_hf_iclass_readtagfile() {
1283 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1287 int CmdHFiClassReadTagFile(const char *Cmd
) {
1292 char filename
[FILE_PATH_SIZE
];
1293 if (param_getstr(Cmd
, 0, filename
) < 1)
1294 return usage_hf_iclass_readtagfile();
1295 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1298 sscanf(tempnum
,"%d",&startblock
);
1300 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1303 sscanf(tempnum
,"%d",&endblock
);
1304 // file handling and reading
1305 f
= fopen(filename
,"rb");
1307 PrintAndLog("Failed to read from file '%s'", filename
);
1310 fseek(f
, 0, SEEK_END
);
1311 long fsize
= ftell(f
);
1312 fseek(f
, 0, SEEK_SET
);
1314 uint8_t *dump
= malloc(fsize
);
1317 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1319 uint8_t *csn
= dump
;
1320 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]);
1321 // printIclassDumpInfo(dump);
1322 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1328 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1329 uint64_t new_div = 0x00;
1335 uint64_t hexarray_to_uint64(uint8_t *key) {
1338 for (int i = 0;i < 8;i++)
1339 sprintf(&temp[(i *2)],"%02X",key[i]);
1341 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1346 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1347 uint8_t keytable
[128] = {0};
1348 uint8_t key_index
[8] = {0};
1350 uint8_t key_sel
[8] = { 0 };
1351 uint8_t key_sel_p
[8] = { 0 };
1352 hash2(KEY
, keytable
);
1353 hash1(CSN
, key_index
);
1354 for(uint8_t i
= 0; i
< 8 ; i
++)
1355 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1357 //Permute from iclass format to standard format
1358 permutekey_rev(key_sel
, key_sel_p
);
1359 diversifyKey(CSN
, key_sel_p
, div_key
);
1361 diversifyKey(CSN
, KEY
, div_key
);
1365 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1366 //calculate and return xor_div_key (ready for a key write command)
1367 //print all div_keys if verbose
1368 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1369 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1370 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1372 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1374 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1376 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1377 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1380 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1381 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1382 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1386 int usage_hf_iclass_calc_newkey(void) {
1387 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1388 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1389 PrintAndLog(" Options:");
1390 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1391 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1392 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1393 PrintAndLog(" e : specify new key as elite calc");
1394 PrintAndLog(" ee : specify old and new key as elite calc");
1395 PrintAndLog("Samples:");
1396 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1397 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1398 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1399 PrintAndLog("NOTE: * = required\n");
1404 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1405 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1406 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1407 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1408 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1409 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1411 uint8_t dataLen
= 0;
1412 char tempStr
[50] = {0};
1413 bool givenCSN
= false;
1414 bool oldElite
= false;
1416 bool errors
= false;
1418 while(param_getchar(Cmd
, cmdp
) != 0x00)
1420 switch(param_getchar(Cmd
, cmdp
))
1424 return usage_hf_iclass_calc_newkey();
1427 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1435 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1436 if (dataLen
== 16) {
1437 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1438 } else if (dataLen
== 1) {
1439 keyNbr
= param_get8(Cmd
, cmdp
+1);
1440 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1441 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1443 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1447 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1454 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1455 if (dataLen
== 16) {
1456 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1457 } else if (dataLen
== 1) {
1458 keyNbr
= param_get8(Cmd
, cmdp
+1);
1459 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1460 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1462 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1466 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1474 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1475 return usage_hf_iclass_calc_newkey();
1479 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1483 if(errors
) return usage_hf_iclass_calc_newkey();
1486 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1489 if (!select_only(CSN
, CCNR
, false, true))
1492 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1496 static int loadKeys(char *filename
) {
1498 f
= fopen(filename
,"rb");
1500 PrintAndLog("Failed to read from file '%s'", filename
);
1503 fseek(f
, 0, SEEK_END
);
1504 long fsize
= ftell(f
);
1505 fseek(f
, 0, SEEK_SET
);
1507 uint8_t *dump
= malloc(fsize
);
1509 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1511 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1512 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1517 for (; i
< bytes_read
/8; i
++){
1518 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1521 PrintAndLog("%u keys loaded", i
);
1525 static int saveKeys(char *filename
) {
1527 f
= fopen(filename
,"wb");
1529 printf("error opening file %s\n",filename
);
1532 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1533 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1534 PrintAndLog("save key failed to write to file: %s", filename
);
1542 static int printKeys(void) {
1544 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1545 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1551 int usage_hf_iclass_managekeys(void) {
1552 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1553 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1554 PrintAndLog(" Options:");
1555 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1556 PrintAndLog(" k <key> : set a key in memory");
1557 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1558 PrintAndLog(" s : save keys in memory to file specified by filename");
1559 PrintAndLog(" l : load keys to memory from file specified by filename");
1560 PrintAndLog(" p : print keys loaded into memory\n");
1561 PrintAndLog("Samples:");
1562 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1563 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1564 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1565 PrintAndLog(" print keys : hf iclass managekeys p\n");
1569 int CmdHFiClassManageKeys(const char *Cmd
) {
1571 uint8_t dataLen
= 0;
1572 uint8_t KEY
[8] = {0};
1573 char filename
[FILE_PATH_SIZE
];
1574 uint8_t fileNameLen
= 0;
1575 bool errors
= false;
1576 uint8_t operation
= 0;
1580 while(param_getchar(Cmd
, cmdp
) != 0x00)
1582 switch(param_getchar(Cmd
, cmdp
))
1586 return usage_hf_iclass_managekeys();
1589 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1590 if (fileNameLen
< 1) {
1591 PrintAndLog("No filename found after f");
1598 keyNbr
= param_get8(Cmd
, cmdp
+1);
1600 PrintAndLog("Wrong block number");
1607 operation
+= 3; //set key
1608 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1609 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1610 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1612 PrintAndLog("\nERROR: Key is incorrect length\n");
1619 operation
+= 4; //print keys in memory
1624 operation
+= 5; //load keys from file
1629 operation
+= 6; //save keys to file
1633 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1637 if(errors
) return usage_hf_iclass_managekeys();
1639 if (operation
== 0){
1640 PrintAndLog("no operation specified (load, save, or print)\n");
1641 return usage_hf_iclass_managekeys();
1644 PrintAndLog("Too many operations specified\n");
1645 return usage_hf_iclass_managekeys();
1647 if (operation
> 4 && fileNameLen
== 0){
1648 PrintAndLog("You must enter a filename when loading or saving\n");
1649 return usage_hf_iclass_managekeys();
1653 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1654 case 4: return printKeys();
1655 case 5: return loadKeys(filename
);
1656 case 6: return saveKeys(filename
);
1662 static command_t CommandTable
[] =
1664 {"help", CmdHelp
, 1, "This help"},
1665 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1666 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1667 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1668 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1669 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1670 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1671 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1672 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1673 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1674 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1675 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
1676 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1677 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1678 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1679 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1680 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1681 {NULL
, NULL
, 0, NULL
}
1684 int CmdHFiClass(const char *Cmd
)
1686 CmdsParse(CommandTable
, Cmd
);
1690 int CmdHelp(const char *Cmd
)
1692 CmdsHelp(CommandTable
);