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) {
273 f
= fopen(filename
, "rb");
275 return hf_iclass_eload_usage();
279 PrintAndLog("Failed to read from file '%s'", filename
);
283 fseek(f
, 0, SEEK_END
);
284 long fsize
= ftell(f
);
285 fseek(f
, 0, SEEK_SET
);
288 prnlog("Error, when getting filesize");
293 uint8_t *dump
= malloc(fsize
);
295 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
298 printIclassDumpInfo(dump
);
301 if (bytes_read
< fsize
)
303 prnlog("Error, could only read %d bytes (should be %d)",bytes_read
, fsize
);
308 uint32_t bytes_sent
= 0;
309 uint32_t bytes_remaining
= bytes_read
;
311 while(bytes_remaining
> 0){
312 uint32_t bytes_in_packet
= MIN(USB_CMD_DATA_SIZE
, bytes_remaining
);
313 UsbCommand c
= {CMD_ICLASS_EML_MEMSET
, {bytes_sent
,bytes_in_packet
,0}};
314 memcpy(c
.d
.asBytes
, dump
, bytes_in_packet
);
316 bytes_remaining
-= bytes_in_packet
;
317 bytes_sent
+= bytes_in_packet
;
320 PrintAndLog("Sent %d bytes of data to device emulator memory", bytes_sent
);
324 static int readKeyfile(const char *filename
, size_t len
, uint8_t* buffer
) {
325 FILE *f
= fopen(filename
, "rb");
327 PrintAndLog("Failed to read from file '%s'", filename
);
330 fseek(f
, 0, SEEK_END
);
331 long fsize
= ftell(f
);
332 fseek(f
, 0, SEEK_SET
);
333 size_t bytes_read
= fread(buffer
, 1, len
, f
);
337 PrintAndLog("Warning, file size is %d, expected %d", fsize
, len
);
340 if(bytes_read
!= len
)
342 PrintAndLog("Warning, could only read %d bytes, expected %d" ,bytes_read
, len
);
348 int usage_hf_iclass_decrypt(void) {
349 PrintAndLog("Usage: hf iclass decrypt f <tagdump>");
351 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
352 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
354 PrintAndLog("example: hf iclass decrypt f tagdump_12312342343.bin");
356 PrintAndLog("OBS! This is pretty stupid implementation, it tries to decrypt every block after block 6. ");
357 PrintAndLog("Correct behaviour would be to decrypt only the application areas where the key is valid,");
358 PrintAndLog("which is defined by the configuration block.");
362 int CmdHFiClassDecrypt(const char *Cmd
) {
363 uint8_t key
[16] = { 0 };
364 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
366 usage_hf_iclass_decrypt();
369 PrintAndLog("Decryption file found... ");
370 char opt
= param_getchar(Cmd
, 0);
371 if (strlen(Cmd
)<1 || opt
== 'h')
372 return usage_hf_iclass_decrypt();
374 //Open the tagdump-file
376 char filename
[FILE_PATH_SIZE
];
377 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0) {
378 if ( (f
= fopen(filename
, "rb")) == NULL
) {
379 PrintAndLog("Could not find file %s", filename
);
384 return usage_hf_iclass_decrypt();
387 fseek(f
, 0, SEEK_END
);
388 long fsize
= ftell(f
);
389 fseek(f
, 0, SEEK_SET
);
390 uint8_t enc_dump
[8] = {0};
391 uint8_t *decrypted
= malloc(fsize
);
392 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
393 des3_set2key_dec( &ctx
, key
);
394 size_t bytes_read
= fread(enc_dump
, 1, 8, f
);
396 //Use the first block (CSN) for filename
397 char outfilename
[FILE_PATH_SIZE
] = { 0 };
398 snprintf(outfilename
,FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x-decrypted",
399 enc_dump
[0],enc_dump
[1],enc_dump
[2],enc_dump
[3],
400 enc_dump
[4],enc_dump
[5],enc_dump
[6],enc_dump
[7]);
403 while(bytes_read
== 8)
407 memcpy(decrypted
+(blocknum
*8), enc_dump
, 8);
409 des3_crypt_ecb(&ctx
, enc_dump
,decrypted
+(blocknum
*8) );
411 printvar("decrypted block", decrypted
+(blocknum
*8), 8);
412 bytes_read
= fread(enc_dump
, 1, 8, f
);
417 saveFile(outfilename
,"bin", decrypted
, blocknum
*8);
423 int usage_hf_iclass_encrypt(void) {
424 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
426 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
427 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
429 PrintAndLog("example: hf iclass encrypt 0102030405060708");
434 static int iClassEncryptBlkData(uint8_t *blkData
) {
435 uint8_t key
[16] = { 0 };
436 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
438 usage_hf_iclass_encrypt();
441 PrintAndLog("Decryption file found... ");
443 uint8_t encryptedData
[16];
444 uint8_t *encrypted
= encryptedData
;
445 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
446 des3_set2key_enc( &ctx
, key
);
448 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
449 //printvar("decrypted block", decrypted, 8);
450 memcpy(blkData
,encrypted
,8);
455 int CmdHFiClassEncryptBlk(const char *Cmd
) {
456 uint8_t blkData
[8] = {0};
457 char opt
= param_getchar(Cmd
, 0);
458 if (strlen(Cmd
)<1 || opt
== 'h')
459 return usage_hf_iclass_encrypt();
461 //get the bytes to encrypt
462 if (param_gethex(Cmd
, 0, blkData
, 16))
464 PrintAndLog("BlockData must include 16 HEX symbols");
467 if (!iClassEncryptBlkData(blkData
)) return 0;
469 printvar("encrypted block", blkData
, 8);
473 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
476 memcpy(WB
+ 1,data
,8);
477 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
478 //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]);
481 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
484 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
485 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
487 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
489 clearCommandBuffer();
491 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
493 PrintAndLog("Command execute timeout");
497 uint8_t isOK
= resp
.arg
[0] & 0xff;
498 uint8_t *data
= resp
.d
.asBytes
;
501 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
504 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
507 PrintAndLog("Failed to obtain CC! Aborting");
513 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
) {
514 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
515 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
517 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
522 memcpy(div_key
, KEY
, 8);
524 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
525 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]);
527 doMAC(CCNR
, div_key
, MAC
);
529 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
530 memcpy(d
.d
.asBytes
, MAC
, 4);
531 clearCommandBuffer();
533 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
535 PrintAndLog("Auth Command execute timeout");
538 uint8_t isOK
= resp
.arg
[0] & 0xff;
540 PrintAndLog("Authentication error");
546 int usage_hf_iclass_dump(void) {
547 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e|r\n");
548 PrintAndLog("Options:");
549 PrintAndLog(" f <filename> : specify a filename to save dump to");
550 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
551 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
552 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
553 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
554 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
555 PrintAndLog(" r : If 'r' is specified, the key is interpreted as raw block 3/4");
556 PrintAndLog(" NOTE: * = required");
557 PrintAndLog("Samples:");
558 PrintAndLog(" hf iclass dump k 001122334455667B");
559 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
560 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
564 int CmdHFiClassReader_Dump(const char *Cmd
) {
566 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
567 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
568 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
572 uint8_t app_areas
= 1;
574 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
575 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
578 uint8_t fileNameLen
= 0;
579 char filename
[FILE_PATH_SIZE
]={0};
580 char tempStr
[50] = {0};
581 bool have_debit_key
= false;
582 bool have_credit_key
= false;
583 bool use_credit_key
= false;
589 while(param_getchar(Cmd
, cmdp
) != 0x00)
591 switch(param_getchar(Cmd
, cmdp
))
595 return usage_hf_iclass_dump();
598 have_credit_key
= true;
599 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
601 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
602 } else if (dataLen
== 1) {
603 keyNbr
= param_get8(Cmd
, cmdp
+1);
604 if (keyNbr
<= ICLASS_KEYS_MAX
) {
605 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
607 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
611 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
623 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
624 if (fileNameLen
< 1) {
625 PrintAndLog("No filename found after f");
632 have_debit_key
= true;
633 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
635 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
636 } else if (dataLen
== 1) {
637 keyNbr
= param_get8(Cmd
, cmdp
+1);
638 if (keyNbr
<= ICLASS_KEYS_MAX
) {
639 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
641 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
645 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
656 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
660 if(errors
) return usage_hf_iclass_dump();
663 if (cmdp
< 2) return usage_hf_iclass_dump();
664 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
665 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
667 //get config and first 3 blocks
668 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
669 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
671 uint8_t tag_data
[255*8];
673 clearCommandBuffer();
675 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
676 PrintAndLog("Command execute timeout");
677 ul_switch_off_field();
680 uint8_t readStatus
= resp
.arg
[0] & 0xff;
681 uint8_t * data
= resp
.d
.asBytes
;
684 PrintAndLog("No tag found...");
685 ul_switch_off_field();
688 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
689 memcpy(tag_data
, data
, 8*3);
690 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
692 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
693 // large memory - not able to dump pages currently
694 if (numblks
> maxBlk
) numblks
= maxBlk
;
696 ul_switch_off_field();
697 // authenticate debit key and get div_key - later store in dump block 3
698 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
699 //try twice - for some reason it sometimes fails the first time...
700 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
701 ul_switch_off_field();
707 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
708 clearCommandBuffer();
710 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
711 PrintAndLog("Command execute time-out 1");
712 ul_switch_off_field();
715 uint32_t blocksRead
= resp
.arg
[1];
716 uint8_t isOK
= resp
.arg
[0] & 0xff;
717 if (!isOK
&& !blocksRead
) {
718 PrintAndLog("Read Block Failed");
719 ul_switch_off_field();
722 uint32_t startindex
= resp
.arg
[2];
723 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
724 PrintAndLog("Data exceeded Buffer size!");
725 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
727 // response ok - now get bigbuf content of the dump
728 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
729 WaitForResponse(CMD_ACK
,NULL
);
730 size_t gotBytes
= blocksRead
*8 + blockno
*8;
733 if (have_credit_key
) {
734 //turn off hf field before authenticating with different key
735 ul_switch_off_field();
737 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
738 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
739 //try twice - for some reason it sometimes fails the first time...
740 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
741 ul_switch_off_field();
745 // do we still need to read more block? (aa2 enabled?)
746 if (maxBlk
> blockno
+numblks
+1) {
747 // setup dump and start
748 w
.arg
[0] = blockno
+ blocksRead
;
749 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
750 clearCommandBuffer();
752 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
753 PrintAndLog("Command execute timeout 2");
754 ul_switch_off_field();
757 uint8_t isOK
= resp
.arg
[0] & 0xff;
758 blocksRead
= resp
.arg
[1];
759 if (!isOK
&& !blocksRead
) {
760 PrintAndLog("Read Block Failed 2");
761 ul_switch_off_field();
765 startindex
= resp
.arg
[2];
766 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
767 PrintAndLog("Data exceeded Buffer size!");
768 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
770 // get dumped data from bigbuf
771 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
772 WaitForResponse(CMD_ACK
,NULL
);
774 gotBytes
+= blocksRead
*8;
775 } else { //field is still on - turn it off...
776 ul_switch_off_field();
780 // add diversified keys to dump
781 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
782 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
784 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
785 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
786 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
788 if (filename
[0] == 0){
789 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
790 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
791 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
794 // save the dump to .bin file
795 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
796 saveFile(filename
, "bin", tag_data
, gotBytes
);
800 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
801 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
802 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
803 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, verbose
))
808 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
809 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
810 memcpy(w
.d
.asBytes
, bldata
, 8);
811 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
813 clearCommandBuffer();
815 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
817 PrintAndLog("Write Command execute timeout");
820 uint8_t isOK
= resp
.arg
[0] & 0xff;
822 PrintAndLog("Write Block Failed");
825 PrintAndLog("Write Block Successful");
829 int usage_hf_iclass_writeblock(void) {
830 PrintAndLog("Options:");
831 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
832 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
833 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
834 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
835 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
836 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
837 PrintAndLog("Samples:");
838 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
839 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
840 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
844 int CmdHFiClass_WriteBlock(const char *Cmd
) {
846 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
847 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
850 char tempStr
[50] = {0};
851 bool use_credit_key
= false;
856 while(param_getchar(Cmd
, cmdp
) != 0x00)
858 switch(param_getchar(Cmd
, cmdp
))
862 return usage_hf_iclass_writeblock();
865 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
866 PrintAndLog("Block No must include 2 HEX symbols\n");
873 use_credit_key
= true;
878 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
880 PrintAndLog("KEY must include 16 HEX symbols\n");
892 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
894 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
895 } else if (dataLen
== 1) {
896 keyNbr
= param_get8(Cmd
, cmdp
+1);
897 if (keyNbr
<= ICLASS_KEYS_MAX
) {
898 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
900 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
904 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
915 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
919 if(errors
) return usage_hf_iclass_writeblock();
922 if (cmdp
< 6) return usage_hf_iclass_writeblock();
923 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, rawkey
, true);
924 ul_switch_off_field();
928 int usage_hf_iclass_clone(void) {
929 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> c e|r");
930 PrintAndLog("Options:");
931 PrintAndLog(" f <filename>: specify a filename to clone from");
932 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
933 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
934 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
935 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
936 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
937 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
938 PrintAndLog("Samples:");
939 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
940 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
941 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
945 int CmdHFiClassCloneTag(const char *Cmd
) {
946 char filename
[FILE_PATH_SIZE
];
947 char tempStr
[50]={0};
948 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
950 uint8_t fileNameLen
= 0;
951 uint8_t startblock
= 0;
952 uint8_t endblock
= 0;
954 bool use_credit_key
= false;
959 while(param_getchar(Cmd
, cmdp
) != 0x00)
961 switch(param_getchar(Cmd
, cmdp
))
965 return usage_hf_iclass_clone();
968 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
969 PrintAndLog("Start Block No must include 2 HEX symbols\n");
976 use_credit_key
= true;
986 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
987 if (fileNameLen
< 1) {
988 PrintAndLog("No filename found after f");
995 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
997 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
998 } else if (dataLen
== 1) {
999 keyNbr
= param_get8(Cmd
, cmdp
+1);
1000 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1001 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1003 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1007 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1014 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
1015 PrintAndLog("Start Block No must include 2 HEX symbols\n");
1026 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1030 if(errors
) return usage_hf_iclass_clone();
1033 if (cmdp
< 8) return usage_hf_iclass_clone();
1037 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1039 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1040 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1042 // file handling and reading
1043 f
= fopen(filename
,"rb");
1045 PrintAndLog("Failed to read from file '%s'", filename
);
1050 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1053 // now read data from the file from block 6 --- 19
1054 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1055 // 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,
1056 // else we have to create a share memory
1058 fseek(f
,startblock
*8,SEEK_SET
);
1059 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0){
1060 PrintAndLog("File reading error.");
1065 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1066 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1068 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, true))
1071 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1073 // calculate all mac for every the block we will write
1074 for (i
= startblock
; i
<= endblock
; i
++){
1075 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1076 // usb command d start pointer = d + (i - 6) * 12
1077 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1078 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1080 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1081 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1082 memcpy(ptr
+ 8,MAC
, 4);
1085 for (i
= 0; i
<= endblock
- startblock
;i
++){
1086 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1087 printf("Block |%02x|",i
+ startblock
);
1088 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]);
1089 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1093 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1095 PrintAndLog("Command execute timeout");
1101 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool rawkey
, bool verbose
) {
1102 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1103 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1105 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, rawkey
, verbose
))
1109 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1110 clearCommandBuffer();
1112 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1114 PrintAndLog("Command execute timeout");
1117 uint8_t isOK
= resp
.arg
[0] & 0xff;
1119 PrintAndLog("Read Block Failed");
1122 //data read is stored in: resp.d.asBytes[0-15]
1123 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1127 int usage_hf_iclass_readblock(void) {
1128 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e|r\n");
1129 PrintAndLog("Options:");
1130 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1131 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1132 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1133 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1134 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
1135 PrintAndLog("Samples:");
1136 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1137 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1138 PrintAndLog(" hf iclass readblk b 0A k 0");
1142 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1144 uint8_t keyType
= 0x88; //debit key
1145 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1147 uint8_t dataLen
= 0;
1148 char tempStr
[50] = {0};
1150 bool rawkey
= false;
1151 bool errors
= false;
1153 while(param_getchar(Cmd
, cmdp
) != 0x00)
1155 switch(param_getchar(Cmd
, cmdp
))
1159 return usage_hf_iclass_readblock();
1162 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1163 PrintAndLog("Block No must include 2 HEX symbols\n");
1180 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1181 if (dataLen
== 16) {
1182 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1183 } else if (dataLen
== 1) {
1184 keyNbr
= param_get8(Cmd
, cmdp
+1);
1185 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1186 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1188 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1192 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1203 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1207 if(errors
) return usage_hf_iclass_readblock();
1210 if (cmdp
< 4) return usage_hf_iclass_readblock();
1212 return ReadBlock(KEY
, blockno
, keyType
, elite
, rawkey
, true);
1215 int CmdHFiClass_loclass(const char *Cmd
) {
1216 char opt
= param_getchar(Cmd
, 0);
1218 if (strlen(Cmd
)<1 || opt
== 'h') {
1219 PrintAndLog("Usage: hf iclass loclass [options]");
1220 PrintAndLog("Options:");
1221 PrintAndLog("h Show this help");
1222 PrintAndLog("t Perform self-test");
1223 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1224 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1225 PrintAndLog(" malicious CSNs, and their protocol responses");
1226 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
1227 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1228 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1229 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1230 PrintAndLog(" ... totalling N*24 bytes");
1233 char fileName
[255] = {0};
1236 if(param_getstr(Cmd
, 1, fileName
) > 0)
1238 return bruteforceFileNoKeys(fileName
);
1241 PrintAndLog("You must specify a filename");
1246 int errors
= testCipherUtils();
1247 errors
+= testMAC();
1248 errors
+= doKeyTests(0);
1249 errors
+= testElite();
1252 prnlog("OBS! There were errors!!!");
1260 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1261 uint8_t blockdata
[8];
1263 memcpy(&mem_config
, iclass_dump
+ 13,1);
1264 uint8_t maxmemcount
;
1265 uint8_t filemaxblock
= filesize
/ 8;
1266 if (mem_config
& 0x80)
1270 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1272 if (startblock
== 0)
1274 if ((endblock
> maxmemcount
) || (endblock
== 0))
1275 endblock
= maxmemcount
;
1276 if (endblock
> filemaxblock
)
1277 endblock
= filemaxblock
;
1280 while (i
<= endblock
){
1281 printf("Block |%02X| ",i
);
1282 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1283 for (j
= 0;j
< 8;j
++)
1284 printf("%02X ",blockdata
[j
]);
1290 int usage_hf_iclass_readtagfile() {
1291 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1295 int CmdHFiClassReadTagFile(const char *Cmd
) {
1300 char filename
[FILE_PATH_SIZE
];
1301 if (param_getstr(Cmd
, 0, filename
) < 1)
1302 return usage_hf_iclass_readtagfile();
1303 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1306 sscanf(tempnum
,"%d",&startblock
);
1308 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1311 sscanf(tempnum
,"%d",&endblock
);
1312 // file handling and reading
1313 f
= fopen(filename
,"rb");
1315 PrintAndLog("Failed to read from file '%s'", filename
);
1318 fseek(f
, 0, SEEK_END
);
1319 long fsize
= ftell(f
);
1320 fseek(f
, 0, SEEK_SET
);
1323 PrintAndLog("Error, when getting filesize");
1328 uint8_t *dump
= malloc(fsize
);
1330 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1332 uint8_t *csn
= dump
;
1333 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]);
1334 // printIclassDumpInfo(dump);
1335 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1341 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1342 uint64_t new_div = 0x00;
1348 uint64_t hexarray_to_uint64(uint8_t *key) {
1351 for (int i = 0;i < 8;i++)
1352 sprintf(&temp[(i *2)],"%02X",key[i]);
1354 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1359 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1360 uint8_t keytable
[128] = {0};
1361 uint8_t key_index
[8] = {0};
1363 uint8_t key_sel
[8] = { 0 };
1364 uint8_t key_sel_p
[8] = { 0 };
1365 hash2(KEY
, keytable
);
1366 hash1(CSN
, key_index
);
1367 for(uint8_t i
= 0; i
< 8 ; i
++)
1368 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1370 //Permute from iclass format to standard format
1371 permutekey_rev(key_sel
, key_sel_p
);
1372 diversifyKey(CSN
, key_sel_p
, div_key
);
1374 diversifyKey(CSN
, KEY
, div_key
);
1378 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1379 //calculate and return xor_div_key (ready for a key write command)
1380 //print all div_keys if verbose
1381 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1382 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1383 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1385 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1387 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1389 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1390 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1393 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1394 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1395 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1399 int usage_hf_iclass_calc_newkey(void) {
1400 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1401 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1402 PrintAndLog(" Options:");
1403 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1404 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1405 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1406 PrintAndLog(" e : specify new key as elite calc");
1407 PrintAndLog(" ee : specify old and new key as elite calc");
1408 PrintAndLog("Samples:");
1409 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1410 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1411 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1412 PrintAndLog("NOTE: * = required\n");
1417 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1418 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1419 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1420 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1421 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1422 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1424 uint8_t dataLen
= 0;
1425 char tempStr
[50] = {0};
1426 bool givenCSN
= false;
1427 bool oldElite
= false;
1429 bool errors
= false;
1431 while(param_getchar(Cmd
, cmdp
) != 0x00)
1433 switch(param_getchar(Cmd
, cmdp
))
1437 return usage_hf_iclass_calc_newkey();
1440 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1448 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1449 if (dataLen
== 16) {
1450 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1451 } else if (dataLen
== 1) {
1452 keyNbr
= param_get8(Cmd
, cmdp
+1);
1453 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1454 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1456 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1460 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1467 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1468 if (dataLen
== 16) {
1469 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1470 } else if (dataLen
== 1) {
1471 keyNbr
= param_get8(Cmd
, cmdp
+1);
1472 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1473 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1475 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1479 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1487 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1488 return usage_hf_iclass_calc_newkey();
1492 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1496 if(errors
) return usage_hf_iclass_calc_newkey();
1499 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1502 if (!select_only(CSN
, CCNR
, false, true))
1505 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1509 static int loadKeys(char *filename
) {
1511 f
= fopen(filename
,"rb");
1513 PrintAndLog("Failed to read from file '%s'", filename
);
1516 fseek(f
, 0, SEEK_END
);
1517 long fsize
= ftell(f
);
1518 fseek(f
, 0, SEEK_SET
);
1521 PrintAndLog("Error, when getting filesize");
1526 uint8_t *dump
= malloc(fsize
);
1528 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1530 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1531 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1536 for (; i
< bytes_read
/8; i
++){
1537 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1540 PrintAndLog("%u keys loaded", i
);
1544 static int saveKeys(char *filename
) {
1546 f
= fopen(filename
,"wb");
1548 printf("error opening file %s\n",filename
);
1551 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1552 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1553 PrintAndLog("save key failed to write to file: %s", filename
);
1561 static int printKeys(void) {
1563 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1564 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1570 int usage_hf_iclass_managekeys(void) {
1571 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1572 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1573 PrintAndLog(" Options:");
1574 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1575 PrintAndLog(" k <key> : set a key in memory");
1576 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1577 PrintAndLog(" s : save keys in memory to file specified by filename");
1578 PrintAndLog(" l : load keys to memory from file specified by filename");
1579 PrintAndLog(" p : print keys loaded into memory\n");
1580 PrintAndLog("Samples:");
1581 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1582 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1583 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1584 PrintAndLog(" print keys : hf iclass managekeys p\n");
1588 int CmdHFiClassManageKeys(const char *Cmd
) {
1590 uint8_t dataLen
= 0;
1591 uint8_t KEY
[8] = {0};
1592 char filename
[FILE_PATH_SIZE
];
1593 uint8_t fileNameLen
= 0;
1594 bool errors
= false;
1595 uint8_t operation
= 0;
1599 while(param_getchar(Cmd
, cmdp
) != 0x00)
1601 switch(param_getchar(Cmd
, cmdp
))
1605 return usage_hf_iclass_managekeys();
1608 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1609 if (fileNameLen
< 1) {
1610 PrintAndLog("No filename found after f");
1617 keyNbr
= param_get8(Cmd
, cmdp
+1);
1619 PrintAndLog("Wrong block number");
1626 operation
+= 3; //set key
1627 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1628 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1629 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1631 PrintAndLog("\nERROR: Key is incorrect length\n");
1638 operation
+= 4; //print keys in memory
1643 operation
+= 5; //load keys from file
1648 operation
+= 6; //save keys to file
1652 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1656 if(errors
) return usage_hf_iclass_managekeys();
1658 if (operation
== 0){
1659 PrintAndLog("no operation specified (load, save, or print)\n");
1660 return usage_hf_iclass_managekeys();
1663 PrintAndLog("Too many operations specified\n");
1664 return usage_hf_iclass_managekeys();
1666 if (operation
> 4 && fileNameLen
== 0){
1667 PrintAndLog("You must enter a filename when loading or saving\n");
1668 return usage_hf_iclass_managekeys();
1672 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1673 case 4: return printKeys();
1674 case 5: return loadKeys(filename
);
1675 case 6: return saveKeys(filename
);
1681 static command_t CommandTable
[] =
1683 {"help", CmdHelp
, 1, "This help"},
1684 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1685 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1686 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1687 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1688 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1689 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1690 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1691 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1692 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1693 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1694 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
1695 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1696 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1697 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1698 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1699 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1700 {NULL
, NULL
, 0, NULL
}
1703 int CmdHFiClass(const char *Cmd
)
1705 CmdsParse(CommandTable
, Cmd
);
1709 int CmdHelp(const char *Cmd
)
1711 CmdsHelp(CommandTable
);