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)
379 f
= fopen(filename
, "rb");
381 return usage_hf_iclass_decrypt();
384 fseek(f
, 0, SEEK_END
);
385 long fsize
= ftell(f
);
386 fseek(f
, 0, SEEK_SET
);
387 uint8_t enc_dump
[8] = {0};
388 uint8_t *decrypted
= malloc(fsize
);
389 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
390 des3_set2key_dec( &ctx
, key
);
391 size_t bytes_read
= fread(enc_dump
, 1, 8, f
);
393 //Use the first block (CSN) for filename
394 char outfilename
[FILE_PATH_SIZE
] = { 0 };
395 snprintf(outfilename
,FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x-decrypted",
396 enc_dump
[0],enc_dump
[1],enc_dump
[2],enc_dump
[3],
397 enc_dump
[4],enc_dump
[5],enc_dump
[6],enc_dump
[7]);
400 while(bytes_read
== 8)
404 memcpy(decrypted
+(blocknum
*8), enc_dump
, 8);
406 des3_crypt_ecb(&ctx
, enc_dump
,decrypted
+(blocknum
*8) );
408 printvar("decrypted block", decrypted
+(blocknum
*8), 8);
409 bytes_read
= fread(enc_dump
, 1, 8, f
);
414 saveFile(outfilename
,"bin", decrypted
, blocknum
*8);
420 int usage_hf_iclass_encrypt(void) {
421 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
423 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
424 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
426 PrintAndLog("example: hf iclass encrypt 0102030405060708");
431 static int iClassEncryptBlkData(uint8_t *blkData
) {
432 uint8_t key
[16] = { 0 };
433 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
435 usage_hf_iclass_encrypt();
438 PrintAndLog("Decryption file found... ");
440 uint8_t encryptedData
[16];
441 uint8_t *encrypted
= encryptedData
;
442 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
443 des3_set2key_enc( &ctx
, key
);
445 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
446 //printvar("decrypted block", decrypted, 8);
447 memcpy(blkData
,encrypted
,8);
452 int CmdHFiClassEncryptBlk(const char *Cmd
) {
453 uint8_t blkData
[8] = {0};
454 char opt
= param_getchar(Cmd
, 0);
455 if (strlen(Cmd
)<1 || opt
== 'h')
456 return usage_hf_iclass_encrypt();
458 //get the bytes to encrypt
459 if (param_gethex(Cmd
, 0, blkData
, 16))
461 PrintAndLog("BlockData must include 16 HEX symbols");
464 if (!iClassEncryptBlkData(blkData
)) return 0;
466 printvar("encrypted block", blkData
, 8);
470 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
473 memcpy(WB
+ 1,data
,8);
474 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
475 //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]);
478 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
481 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
482 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
484 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
486 clearCommandBuffer();
488 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
490 PrintAndLog("Command execute timeout");
494 uint8_t isOK
= resp
.arg
[0] & 0xff;
495 uint8_t *data
= resp
.d
.asBytes
;
498 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
501 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
504 PrintAndLog("Failed to obtain CC! Aborting");
510 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
) {
511 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
512 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
514 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
519 memcpy(div_key
, KEY
, 8);
521 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
522 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]);
524 doMAC(CCNR
, div_key
, MAC
);
526 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
527 memcpy(d
.d
.asBytes
, MAC
, 4);
528 clearCommandBuffer();
530 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
532 PrintAndLog("Auth Command execute timeout");
535 uint8_t isOK
= resp
.arg
[0] & 0xff;
537 PrintAndLog("Authentication error");
543 int usage_hf_iclass_dump(void) {
544 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e|r\n");
545 PrintAndLog("Options:");
546 PrintAndLog(" f <filename> : specify a filename to save dump to");
547 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
548 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
549 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
550 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
551 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
552 PrintAndLog(" r : If 'r' is specified, the key is interpreted as raw block 3/4");
553 PrintAndLog(" NOTE: * = required");
554 PrintAndLog("Samples:");
555 PrintAndLog(" hf iclass dump k 001122334455667B");
556 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
557 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
561 int CmdHFiClassReader_Dump(const char *Cmd
) {
563 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
564 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
565 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
569 uint8_t app_areas
= 1;
571 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
572 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
575 uint8_t fileNameLen
= 0;
576 char filename
[FILE_PATH_SIZE
]={0};
577 char tempStr
[50] = {0};
578 bool have_debit_key
= false;
579 bool have_credit_key
= false;
580 bool use_credit_key
= false;
586 while(param_getchar(Cmd
, cmdp
) != 0x00)
588 switch(param_getchar(Cmd
, cmdp
))
592 return usage_hf_iclass_dump();
595 have_credit_key
= true;
596 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
598 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
599 } else if (dataLen
== 1) {
600 keyNbr
= param_get8(Cmd
, cmdp
+1);
601 if (keyNbr
<= ICLASS_KEYS_MAX
) {
602 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
604 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
608 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
620 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
621 if (fileNameLen
< 1) {
622 PrintAndLog("No filename found after f");
629 have_debit_key
= true;
630 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
632 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
633 } else if (dataLen
== 1) {
634 keyNbr
= param_get8(Cmd
, cmdp
+1);
635 if (keyNbr
<= ICLASS_KEYS_MAX
) {
636 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
638 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
642 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
653 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
657 if(errors
) return usage_hf_iclass_dump();
660 if (cmdp
< 2) return usage_hf_iclass_dump();
661 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
662 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
664 //get config and first 3 blocks
665 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
666 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
668 uint8_t tag_data
[255*8];
670 clearCommandBuffer();
672 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
673 PrintAndLog("Command execute timeout");
674 ul_switch_off_field();
677 uint8_t readStatus
= resp
.arg
[0] & 0xff;
678 uint8_t * data
= resp
.d
.asBytes
;
681 PrintAndLog("No tag found...");
682 ul_switch_off_field();
685 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
686 memcpy(tag_data
, data
, 8*3);
687 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
689 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
690 // large memory - not able to dump pages currently
691 if (numblks
> maxBlk
) numblks
= maxBlk
;
693 ul_switch_off_field();
694 // authenticate debit key and get div_key - later store in dump block 3
695 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
696 //try twice - for some reason it sometimes fails the first time...
697 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
698 ul_switch_off_field();
704 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
705 clearCommandBuffer();
707 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
708 PrintAndLog("Command execute time-out 1");
709 ul_switch_off_field();
712 uint32_t blocksRead
= resp
.arg
[1];
713 uint8_t isOK
= resp
.arg
[0] & 0xff;
714 if (!isOK
&& !blocksRead
) {
715 PrintAndLog("Read Block Failed");
716 ul_switch_off_field();
719 uint32_t startindex
= resp
.arg
[2];
720 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
721 PrintAndLog("Data exceeded Buffer size!");
722 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
724 // response ok - now get bigbuf content of the dump
725 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
726 WaitForResponse(CMD_ACK
,NULL
);
727 size_t gotBytes
= blocksRead
*8 + blockno
*8;
730 if (have_credit_key
) {
731 //turn off hf field before authenticating with different key
732 ul_switch_off_field();
734 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
735 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
736 //try twice - for some reason it sometimes fails the first time...
737 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
738 ul_switch_off_field();
742 // do we still need to read more block? (aa2 enabled?)
743 if (maxBlk
> blockno
+numblks
+1) {
744 // setup dump and start
745 w
.arg
[0] = blockno
+ blocksRead
;
746 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
747 clearCommandBuffer();
749 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
750 PrintAndLog("Command execute timeout 2");
751 ul_switch_off_field();
754 uint8_t isOK
= resp
.arg
[0] & 0xff;
755 blocksRead
= resp
.arg
[1];
756 if (!isOK
&& !blocksRead
) {
757 PrintAndLog("Read Block Failed 2");
758 ul_switch_off_field();
762 startindex
= resp
.arg
[2];
763 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
764 PrintAndLog("Data exceeded Buffer size!");
765 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
767 // get dumped data from bigbuf
768 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
769 WaitForResponse(CMD_ACK
,NULL
);
771 gotBytes
+= blocksRead
*8;
772 } else { //field is still on - turn it off...
773 ul_switch_off_field();
777 // add diversified keys to dump
778 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
779 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
781 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
782 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
783 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
785 if (filename
[0] == 0){
786 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
787 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
788 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
791 // save the dump to .bin file
792 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
793 saveFile(filename
, "bin", tag_data
, gotBytes
);
797 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
798 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
799 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
800 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, verbose
))
805 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
806 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
807 memcpy(w
.d
.asBytes
, bldata
, 8);
808 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
810 clearCommandBuffer();
812 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
814 PrintAndLog("Write Command execute timeout");
817 uint8_t isOK
= resp
.arg
[0] & 0xff;
819 PrintAndLog("Write Block Failed");
822 PrintAndLog("Write Block Successful");
826 int usage_hf_iclass_writeblock(void) {
827 PrintAndLog("Options:");
828 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
829 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
830 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
831 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
832 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
833 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
834 PrintAndLog("Samples:");
835 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
836 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
837 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
841 int CmdHFiClass_WriteBlock(const char *Cmd
) {
843 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
844 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
847 char tempStr
[50] = {0};
848 bool use_credit_key
= false;
853 while(param_getchar(Cmd
, cmdp
) != 0x00)
855 switch(param_getchar(Cmd
, cmdp
))
859 return usage_hf_iclass_writeblock();
862 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
863 PrintAndLog("Block No must include 2 HEX symbols\n");
870 use_credit_key
= true;
875 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
877 PrintAndLog("KEY must include 16 HEX symbols\n");
889 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
891 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
892 } else if (dataLen
== 1) {
893 keyNbr
= param_get8(Cmd
, cmdp
+1);
894 if (keyNbr
<= ICLASS_KEYS_MAX
) {
895 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
897 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
901 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
912 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
916 if(errors
) return usage_hf_iclass_writeblock();
919 if (cmdp
< 6) return usage_hf_iclass_writeblock();
920 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, rawkey
, true);
921 ul_switch_off_field();
925 int usage_hf_iclass_clone(void) {
926 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> c e|r");
927 PrintAndLog("Options:");
928 PrintAndLog(" f <filename>: specify a filename to clone from");
929 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
930 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
931 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
932 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
933 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
934 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
935 PrintAndLog("Samples:");
936 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
937 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
938 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
942 int CmdHFiClassCloneTag(const char *Cmd
) {
943 char filename
[FILE_PATH_SIZE
];
944 char tempStr
[50]={0};
945 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
947 uint8_t fileNameLen
= 0;
948 uint8_t startblock
= 0;
949 uint8_t endblock
= 0;
951 bool use_credit_key
= false;
956 while(param_getchar(Cmd
, cmdp
) != 0x00)
958 switch(param_getchar(Cmd
, cmdp
))
962 return usage_hf_iclass_clone();
965 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
966 PrintAndLog("Start Block No must include 2 HEX symbols\n");
973 use_credit_key
= true;
983 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
984 if (fileNameLen
< 1) {
985 PrintAndLog("No filename found after f");
992 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
994 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
995 } else if (dataLen
== 1) {
996 keyNbr
= param_get8(Cmd
, cmdp
+1);
997 if (keyNbr
<= ICLASS_KEYS_MAX
) {
998 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1000 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1004 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1011 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
1012 PrintAndLog("Start Block No must include 2 HEX symbols\n");
1023 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1027 if(errors
) return usage_hf_iclass_clone();
1030 if (cmdp
< 8) return usage_hf_iclass_clone();
1034 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1036 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1037 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1039 // file handling and reading
1040 f
= fopen(filename
,"rb");
1042 PrintAndLog("Failed to read from file '%s'", filename
);
1047 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1050 // now read data from the file from block 6 --- 19
1051 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1052 // 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,
1053 // else we have to create a share memory
1055 fseek(f
,startblock
*8,SEEK_SET
);
1056 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0){
1057 PrintAndLog("File reading error.");
1062 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1063 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1065 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, true))
1068 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1070 // calculate all mac for every the block we will write
1071 for (i
= startblock
; i
<= endblock
; i
++){
1072 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1073 // usb command d start pointer = d + (i - 6) * 12
1074 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1075 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1077 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1078 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1079 memcpy(ptr
+ 8,MAC
, 4);
1082 for (i
= 0; i
<= endblock
- startblock
;i
++){
1083 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1084 printf("Block |%02x|",i
+ startblock
);
1085 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]);
1086 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1090 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1092 PrintAndLog("Command execute timeout");
1098 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool rawkey
, bool verbose
) {
1099 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1100 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1102 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, rawkey
, verbose
))
1106 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1107 clearCommandBuffer();
1109 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1111 PrintAndLog("Command execute timeout");
1114 uint8_t isOK
= resp
.arg
[0] & 0xff;
1116 PrintAndLog("Read Block Failed");
1119 //data read is stored in: resp.d.asBytes[0-15]
1120 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1124 int usage_hf_iclass_readblock(void) {
1125 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e|r\n");
1126 PrintAndLog("Options:");
1127 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1128 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1129 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1130 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1131 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
1132 PrintAndLog("Samples:");
1133 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1134 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1135 PrintAndLog(" hf iclass readblk b 0A k 0");
1139 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1141 uint8_t keyType
= 0x88; //debit key
1142 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1144 uint8_t dataLen
= 0;
1145 char tempStr
[50] = {0};
1147 bool rawkey
= false;
1148 bool errors
= false;
1150 while(param_getchar(Cmd
, cmdp
) != 0x00)
1152 switch(param_getchar(Cmd
, cmdp
))
1156 return usage_hf_iclass_readblock();
1159 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1160 PrintAndLog("Block No must include 2 HEX symbols\n");
1177 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1178 if (dataLen
== 16) {
1179 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1180 } else if (dataLen
== 1) {
1181 keyNbr
= param_get8(Cmd
, cmdp
+1);
1182 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1183 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1185 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1189 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1200 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1204 if(errors
) return usage_hf_iclass_readblock();
1207 if (cmdp
< 4) return usage_hf_iclass_readblock();
1209 return ReadBlock(KEY
, blockno
, keyType
, elite
, rawkey
, true);
1212 int CmdHFiClass_loclass(const char *Cmd
) {
1213 char opt
= param_getchar(Cmd
, 0);
1215 if (strlen(Cmd
)<1 || opt
== 'h') {
1216 PrintAndLog("Usage: hf iclass loclass [options]");
1217 PrintAndLog("Options:");
1218 PrintAndLog("h Show this help");
1219 PrintAndLog("t Perform self-test");
1220 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1221 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1222 PrintAndLog(" malicious CSNs, and their protocol responses");
1223 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
1224 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1225 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1226 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1227 PrintAndLog(" ... totalling N*24 bytes");
1230 char fileName
[255] = {0};
1233 if(param_getstr(Cmd
, 1, fileName
) > 0)
1235 return bruteforceFileNoKeys(fileName
);
1238 PrintAndLog("You must specify a filename");
1243 int errors
= testCipherUtils();
1244 errors
+= testMAC();
1245 errors
+= doKeyTests(0);
1246 errors
+= testElite();
1249 prnlog("OBS! There were errors!!!");
1257 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1258 uint8_t blockdata
[8];
1260 memcpy(&mem_config
, iclass_dump
+ 13,1);
1261 uint8_t maxmemcount
;
1262 uint8_t filemaxblock
= filesize
/ 8;
1263 if (mem_config
& 0x80)
1267 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1269 if (startblock
== 0)
1271 if ((endblock
> maxmemcount
) || (endblock
== 0))
1272 endblock
= maxmemcount
;
1273 if (endblock
> filemaxblock
)
1274 endblock
= filemaxblock
;
1277 while (i
<= endblock
){
1278 printf("Block |%02X| ",i
);
1279 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1280 for (j
= 0;j
< 8;j
++)
1281 printf("%02X ",blockdata
[j
]);
1287 int usage_hf_iclass_readtagfile() {
1288 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1292 int CmdHFiClassReadTagFile(const char *Cmd
) {
1297 char filename
[FILE_PATH_SIZE
];
1298 if (param_getstr(Cmd
, 0, filename
) < 1)
1299 return usage_hf_iclass_readtagfile();
1300 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1303 sscanf(tempnum
,"%d",&startblock
);
1305 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1308 sscanf(tempnum
,"%d",&endblock
);
1309 // file handling and reading
1310 f
= fopen(filename
,"rb");
1312 PrintAndLog("Failed to read from file '%s'", filename
);
1315 fseek(f
, 0, SEEK_END
);
1316 long fsize
= ftell(f
);
1317 fseek(f
, 0, SEEK_SET
);
1319 uint8_t *dump
= malloc(fsize
);
1322 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1324 uint8_t *csn
= dump
;
1325 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]);
1326 // printIclassDumpInfo(dump);
1327 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1333 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1334 uint64_t new_div = 0x00;
1340 uint64_t hexarray_to_uint64(uint8_t *key) {
1343 for (int i = 0;i < 8;i++)
1344 sprintf(&temp[(i *2)],"%02X",key[i]);
1346 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1351 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1352 uint8_t keytable
[128] = {0};
1353 uint8_t key_index
[8] = {0};
1355 uint8_t key_sel
[8] = { 0 };
1356 uint8_t key_sel_p
[8] = { 0 };
1357 hash2(KEY
, keytable
);
1358 hash1(CSN
, key_index
);
1359 for(uint8_t i
= 0; i
< 8 ; i
++)
1360 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1362 //Permute from iclass format to standard format
1363 permutekey_rev(key_sel
, key_sel_p
);
1364 diversifyKey(CSN
, key_sel_p
, div_key
);
1366 diversifyKey(CSN
, KEY
, div_key
);
1370 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1371 //calculate and return xor_div_key (ready for a key write command)
1372 //print all div_keys if verbose
1373 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1374 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1375 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1377 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1379 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1381 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1382 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1385 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1386 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1387 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1391 int usage_hf_iclass_calc_newkey(void) {
1392 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1393 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1394 PrintAndLog(" Options:");
1395 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1396 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1397 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1398 PrintAndLog(" e : specify new key as elite calc");
1399 PrintAndLog(" ee : specify old and new key as elite calc");
1400 PrintAndLog("Samples:");
1401 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1402 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1403 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1404 PrintAndLog("NOTE: * = required\n");
1409 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1410 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1411 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1412 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1413 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1414 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1416 uint8_t dataLen
= 0;
1417 char tempStr
[50] = {0};
1418 bool givenCSN
= false;
1419 bool oldElite
= false;
1421 bool errors
= false;
1423 while(param_getchar(Cmd
, cmdp
) != 0x00)
1425 switch(param_getchar(Cmd
, cmdp
))
1429 return usage_hf_iclass_calc_newkey();
1432 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1440 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1441 if (dataLen
== 16) {
1442 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1443 } else if (dataLen
== 1) {
1444 keyNbr
= param_get8(Cmd
, cmdp
+1);
1445 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1446 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1448 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1452 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1459 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1460 if (dataLen
== 16) {
1461 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1462 } else if (dataLen
== 1) {
1463 keyNbr
= param_get8(Cmd
, cmdp
+1);
1464 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1465 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1467 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1471 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1479 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1480 return usage_hf_iclass_calc_newkey();
1484 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1488 if(errors
) return usage_hf_iclass_calc_newkey();
1491 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1494 if (!select_only(CSN
, CCNR
, false, true))
1497 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1501 static int loadKeys(char *filename
) {
1503 f
= fopen(filename
,"rb");
1505 PrintAndLog("Failed to read from file '%s'", filename
);
1508 fseek(f
, 0, SEEK_END
);
1509 long fsize
= ftell(f
);
1510 fseek(f
, 0, SEEK_SET
);
1512 uint8_t *dump
= malloc(fsize
);
1514 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1516 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1517 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1522 for (; i
< bytes_read
/8; i
++){
1523 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1526 PrintAndLog("%u keys loaded", i
);
1530 static int saveKeys(char *filename
) {
1532 f
= fopen(filename
,"wb");
1534 printf("error opening file %s\n",filename
);
1537 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1538 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1539 PrintAndLog("save key failed to write to file: %s", filename
);
1547 static int printKeys(void) {
1549 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1550 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1556 int usage_hf_iclass_managekeys(void) {
1557 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1558 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1559 PrintAndLog(" Options:");
1560 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1561 PrintAndLog(" k <key> : set a key in memory");
1562 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1563 PrintAndLog(" s : save keys in memory to file specified by filename");
1564 PrintAndLog(" l : load keys to memory from file specified by filename");
1565 PrintAndLog(" p : print keys loaded into memory\n");
1566 PrintAndLog("Samples:");
1567 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1568 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1569 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1570 PrintAndLog(" print keys : hf iclass managekeys p\n");
1574 int CmdHFiClassManageKeys(const char *Cmd
) {
1576 uint8_t dataLen
= 0;
1577 uint8_t KEY
[8] = {0};
1578 char filename
[FILE_PATH_SIZE
];
1579 uint8_t fileNameLen
= 0;
1580 bool errors
= false;
1581 uint8_t operation
= 0;
1585 while(param_getchar(Cmd
, cmdp
) != 0x00)
1587 switch(param_getchar(Cmd
, cmdp
))
1591 return usage_hf_iclass_managekeys();
1594 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1595 if (fileNameLen
< 1) {
1596 PrintAndLog("No filename found after f");
1603 keyNbr
= param_get8(Cmd
, cmdp
+1);
1605 PrintAndLog("Wrong block number");
1612 operation
+= 3; //set key
1613 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1614 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1615 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1617 PrintAndLog("\nERROR: Key is incorrect length\n");
1624 operation
+= 4; //print keys in memory
1629 operation
+= 5; //load keys from file
1634 operation
+= 6; //save keys to file
1638 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1642 if(errors
) return usage_hf_iclass_managekeys();
1644 if (operation
== 0){
1645 PrintAndLog("no operation specified (load, save, or print)\n");
1646 return usage_hf_iclass_managekeys();
1649 PrintAndLog("Too many operations specified\n");
1650 return usage_hf_iclass_managekeys();
1652 if (operation
> 4 && fileNameLen
== 0){
1653 PrintAndLog("You must enter a filename when loading or saving\n");
1654 return usage_hf_iclass_managekeys();
1658 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1659 case 4: return printKeys();
1660 case 5: return loadKeys(filename
);
1661 case 6: return saveKeys(filename
);
1667 static command_t CommandTable
[] =
1669 {"help", CmdHelp
, 1, "This help"},
1670 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1671 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1672 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1673 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1674 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1675 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1676 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1677 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1678 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1679 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1680 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
1681 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1682 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1683 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1684 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1685 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1686 {NULL
, NULL
, 0, NULL
}
1689 int CmdHFiClass(const char *Cmd
)
1691 CmdsParse(CommandTable
, Cmd
);
1695 int CmdHelp(const char *Cmd
)
1697 CmdsHelp(CommandTable
);