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
] = { 0x00 };
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");
1054 // now read data from the file from block 6 --- 19
1055 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1056 // 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,
1057 // else we have to create a share memory
1059 fseek(f
,startblock
*8,SEEK_SET
);
1060 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0){
1061 PrintAndLog("File reading error.");
1066 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1067 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1069 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, true))
1072 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1074 // calculate all mac for every the block we will write
1075 for (i
= startblock
; i
<= endblock
; i
++){
1076 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1077 // usb command d start pointer = d + (i - 6) * 12
1078 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1079 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1081 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1082 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1083 memcpy(ptr
+ 8,MAC
, 4);
1086 for (i
= 0; i
<= endblock
- startblock
;i
++){
1087 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1088 printf("Block |%02x|",i
+ startblock
);
1089 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]);
1090 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1094 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1096 PrintAndLog("Command execute timeout");
1102 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool rawkey
, bool verbose
) {
1103 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1104 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1106 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, rawkey
, verbose
))
1110 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1111 clearCommandBuffer();
1113 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1115 PrintAndLog("Command execute timeout");
1118 uint8_t isOK
= resp
.arg
[0] & 0xff;
1120 PrintAndLog("Read Block Failed");
1123 //data read is stored in: resp.d.asBytes[0-15]
1124 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1128 int usage_hf_iclass_readblock(void) {
1129 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e|r\n");
1130 PrintAndLog("Options:");
1131 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1132 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1133 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1134 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1135 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
1136 PrintAndLog("Samples:");
1137 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1138 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1139 PrintAndLog(" hf iclass readblk b 0A k 0");
1143 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1145 uint8_t keyType
= 0x88; //debit key
1146 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1148 uint8_t dataLen
= 0;
1149 char tempStr
[50] = {0};
1151 bool rawkey
= false;
1152 bool errors
= false;
1154 while(param_getchar(Cmd
, cmdp
) != 0x00)
1156 switch(param_getchar(Cmd
, cmdp
))
1160 return usage_hf_iclass_readblock();
1163 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1164 PrintAndLog("Block No must include 2 HEX symbols\n");
1181 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1182 if (dataLen
== 16) {
1183 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1184 } else if (dataLen
== 1) {
1185 keyNbr
= param_get8(Cmd
, cmdp
+1);
1186 if (keyNbr
< ICLASS_KEYS_MAX
) {
1187 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1189 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1193 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1204 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1208 if(errors
) return usage_hf_iclass_readblock();
1211 if (cmdp
< 4) return usage_hf_iclass_readblock();
1213 return ReadBlock(KEY
, blockno
, keyType
, elite
, rawkey
, true);
1216 int CmdHFiClass_loclass(const char *Cmd
) {
1217 char opt
= param_getchar(Cmd
, 0);
1219 if (strlen(Cmd
)<1 || opt
== 'h') {
1220 PrintAndLog("Usage: hf iclass loclass [options]");
1221 PrintAndLog("Options:");
1222 PrintAndLog("h Show this help");
1223 PrintAndLog("t Perform self-test");
1224 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1225 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1226 PrintAndLog(" malicious CSNs, and their protocol responses");
1227 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
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(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1231 PrintAndLog(" ... totalling N*24 bytes");
1234 char fileName
[255] = {0};
1237 if(param_getstr(Cmd
, 1, fileName
) > 0)
1239 return bruteforceFileNoKeys(fileName
);
1242 PrintAndLog("You must specify a filename");
1247 int errors
= testCipherUtils();
1248 errors
+= testMAC();
1249 errors
+= doKeyTests(0);
1250 errors
+= testElite();
1253 prnlog("OBS! There were errors!!!");
1261 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1262 uint8_t blockdata
[8];
1264 memcpy(&mem_config
, iclass_dump
+ 13,1);
1265 uint8_t maxmemcount
;
1266 uint8_t filemaxblock
= filesize
/ 8;
1267 if (mem_config
& 0x80)
1271 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1273 if (startblock
== 0)
1275 if ((endblock
> maxmemcount
) || (endblock
== 0))
1276 endblock
= maxmemcount
;
1277 if (endblock
> filemaxblock
)
1278 endblock
= filemaxblock
;
1281 while (i
<= endblock
){
1282 printf("Block |%02X| ",i
);
1283 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1284 for (j
= 0;j
< 8;j
++)
1285 printf("%02X ",blockdata
[j
]);
1291 int usage_hf_iclass_readtagfile() {
1292 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1296 int CmdHFiClassReadTagFile(const char *Cmd
) {
1301 char filename
[FILE_PATH_SIZE
];
1302 if (param_getstr(Cmd
, 0, filename
) < 1)
1303 return usage_hf_iclass_readtagfile();
1304 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1307 sscanf(tempnum
,"%d",&startblock
);
1309 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1312 sscanf(tempnum
,"%d",&endblock
);
1313 // file handling and reading
1314 f
= fopen(filename
,"rb");
1316 PrintAndLog("Failed to read from file '%s'", filename
);
1319 fseek(f
, 0, SEEK_END
);
1320 long fsize
= ftell(f
);
1321 fseek(f
, 0, SEEK_SET
);
1324 PrintAndLog("Error, when getting filesize");
1329 uint8_t *dump
= malloc(fsize
);
1331 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1333 uint8_t *csn
= dump
;
1334 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]);
1335 // printIclassDumpInfo(dump);
1336 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1342 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1343 uint64_t new_div = 0x00;
1349 uint64_t hexarray_to_uint64(uint8_t *key) {
1352 for (int i = 0;i < 8;i++)
1353 sprintf(&temp[(i *2)],"%02X",key[i]);
1355 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1360 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1361 uint8_t keytable
[128] = {0};
1362 uint8_t key_index
[8] = {0};
1364 uint8_t key_sel
[8] = { 0 };
1365 uint8_t key_sel_p
[8] = { 0 };
1366 hash2(KEY
, keytable
);
1367 hash1(CSN
, key_index
);
1368 for(uint8_t i
= 0; i
< 8 ; i
++)
1369 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1371 //Permute from iclass format to standard format
1372 permutekey_rev(key_sel
, key_sel_p
);
1373 diversifyKey(CSN
, key_sel_p
, div_key
);
1375 diversifyKey(CSN
, KEY
, div_key
);
1379 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1380 //calculate and return xor_div_key (ready for a key write command)
1381 //print all div_keys if verbose
1382 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1383 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1384 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1386 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1388 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1390 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1391 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1394 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1395 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1396 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1400 int usage_hf_iclass_calc_newkey(void) {
1401 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1402 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1403 PrintAndLog(" Options:");
1404 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1405 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1406 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1407 PrintAndLog(" e : specify new key as elite calc");
1408 PrintAndLog(" ee : specify old and new key as elite calc");
1409 PrintAndLog("Samples:");
1410 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1411 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1412 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1413 PrintAndLog("NOTE: * = required\n");
1418 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1419 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1420 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1421 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1422 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1423 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1425 uint8_t dataLen
= 0;
1426 char tempStr
[50] = {0};
1427 bool givenCSN
= false;
1428 bool oldElite
= false;
1430 bool errors
= false;
1432 while(param_getchar(Cmd
, cmdp
) != 0x00)
1434 switch(param_getchar(Cmd
, cmdp
))
1438 return usage_hf_iclass_calc_newkey();
1441 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1449 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1450 if (dataLen
== 16) {
1451 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1452 } else if (dataLen
== 1) {
1453 keyNbr
= param_get8(Cmd
, cmdp
+1);
1454 if (keyNbr
< ICLASS_KEYS_MAX
) {
1455 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1457 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1461 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1468 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1469 if (dataLen
== 16) {
1470 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1471 } else if (dataLen
== 1) {
1472 keyNbr
= param_get8(Cmd
, cmdp
+1);
1473 if (keyNbr
< ICLASS_KEYS_MAX
) {
1474 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1476 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1480 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1488 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1489 return usage_hf_iclass_calc_newkey();
1493 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1497 if(errors
) return usage_hf_iclass_calc_newkey();
1500 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1503 if (!select_only(CSN
, CCNR
, false, true))
1506 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1510 static int loadKeys(char *filename
) {
1512 f
= fopen(filename
,"rb");
1514 PrintAndLog("Failed to read from file '%s'", filename
);
1517 fseek(f
, 0, SEEK_END
);
1518 long fsize
= ftell(f
);
1519 fseek(f
, 0, SEEK_SET
);
1522 PrintAndLog("Error, when getting filesize");
1527 uint8_t *dump
= malloc(fsize
);
1529 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1531 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1532 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1537 for (; i
< bytes_read
/8; i
++){
1538 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1541 PrintAndLog("%u keys loaded", i
);
1545 static int saveKeys(char *filename
) {
1547 f
= fopen(filename
,"wb");
1549 printf("error opening file %s\n",filename
);
1552 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1553 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1554 PrintAndLog("save key failed to write to file: %s", filename
);
1562 static int printKeys(void) {
1564 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1565 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1571 int usage_hf_iclass_managekeys(void) {
1572 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1573 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1574 PrintAndLog(" Options:");
1575 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1576 PrintAndLog(" k <key> : set a key in memory");
1577 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1578 PrintAndLog(" s : save keys in memory to file specified by filename");
1579 PrintAndLog(" l : load keys to memory from file specified by filename");
1580 PrintAndLog(" p : print keys loaded into memory\n");
1581 PrintAndLog("Samples:");
1582 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1583 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1584 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1585 PrintAndLog(" print keys : hf iclass managekeys p\n");
1589 int CmdHFiClassManageKeys(const char *Cmd
) {
1591 uint8_t dataLen
= 0;
1592 uint8_t KEY
[8] = {0};
1593 char filename
[FILE_PATH_SIZE
];
1594 uint8_t fileNameLen
= 0;
1595 bool errors
= false;
1596 uint8_t operation
= 0;
1600 while(param_getchar(Cmd
, cmdp
) != 0x00)
1602 switch(param_getchar(Cmd
, cmdp
))
1606 return usage_hf_iclass_managekeys();
1609 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1610 if (fileNameLen
< 1) {
1611 PrintAndLog("No filename found after f");
1618 keyNbr
= param_get8(Cmd
, cmdp
+1);
1620 PrintAndLog("Wrong block number");
1627 operation
+= 3; //set key
1628 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1629 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1630 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1632 PrintAndLog("\nERROR: Key is incorrect length\n");
1639 operation
+= 4; //print keys in memory
1644 operation
+= 5; //load keys from file
1649 operation
+= 6; //save keys to file
1653 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1657 if(errors
) return usage_hf_iclass_managekeys();
1659 if (operation
== 0){
1660 PrintAndLog("no operation specified (load, save, or print)\n");
1661 return usage_hf_iclass_managekeys();
1664 PrintAndLog("Too many operations specified\n");
1665 return usage_hf_iclass_managekeys();
1667 if (operation
> 4 && fileNameLen
== 0){
1668 PrintAndLog("You must enter a filename when loading or saving\n");
1669 return usage_hf_iclass_managekeys();
1673 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1674 case 4: return printKeys();
1675 case 5: return loadKeys(filename
);
1676 case 6: return saveKeys(filename
);
1682 static command_t CommandTable
[] =
1684 {"help", CmdHelp
, 1, "This help"},
1685 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1686 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1687 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1688 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1689 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1690 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1691 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1692 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1693 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1694 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1695 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
1696 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1697 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1698 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1699 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1700 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1701 {NULL
, NULL
, 0, NULL
}
1704 int CmdHFiClass(const char *Cmd
)
1706 CmdsParse(CommandTable
, Cmd
);
1710 int CmdHelp(const char *Cmd
)
1712 CmdsHelp(CommandTable
);