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"
38 static int CmdHelp(const char *Cmd
);
40 #define ICLASS_KEYS_MAX 8
41 static uint8_t iClass_Key_Table
[ICLASS_KEYS_MAX
][8] = {
42 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
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 }
52 typedef struct iclass_block
{
56 int xorbits_8(uint8_t val
) {
57 uint8_t res
= val
^ (val
>> 1); //1st pass
58 res
= res
^ (res
>> 1); // 2nd pass
59 res
= res
^ (res
>> 2); // 3rd pass
60 res
= res
^ (res
>> 4); // 4th pass
64 int CmdHFiClassList(const char *Cmd
) {
65 PrintAndLog("Deprecated command, use 'hf list iclass' instead");
69 int CmdHFiClassSnoop(const char *Cmd
) {
70 UsbCommand c
= {CMD_SNOOP_ICLASS
};
75 int usage_hf_iclass_sim(void) {
76 PrintAndLog("Usage: hf iclass sim <option> [CSN]");
77 PrintAndLog(" options");
78 PrintAndLog(" 0 <CSN> simulate the given CSN");
79 PrintAndLog(" 1 simulate default CSN");
80 PrintAndLog(" 2 Reader-attack, gather reader responses to extract elite key");
81 PrintAndLog(" 3 Full simulation using emulator memory (see 'hf iclass eload')");
82 PrintAndLog(" example: hf iclass sim 0 031FEC8AF7FF12E0");
83 PrintAndLog(" example: hf iclass sim 2");
84 PrintAndLog(" example: hf iclass eload 'tagdump.bin'");
85 PrintAndLog(" hf iclass sim 3");
90 int CmdHFiClassSim(const char *Cmd
) {
92 uint8_t CSN
[8] = {0, 0, 0, 0, 0, 0, 0, 0};
95 return usage_hf_iclass_sim();
97 simType
= param_get8ex(Cmd
, 0, 0, 10);
101 if (param_gethex(Cmd
, 1, CSN
, 16)) {
102 PrintAndLog("A CSN should consist of 16 HEX symbols");
103 return usage_hf_iclass_sim();
106 PrintAndLog("--simtype:%02x csn:%s", simType
, sprint_hex(CSN
, 8));
110 PrintAndLog("Undefined simptype %d", simType
);
111 return usage_hf_iclass_sim();
114 uint8_t numberOfCSNs
=0;
117 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,NUM_CSNS
}};
118 UsbCommand resp
= {0};
120 uint8_t csns
[8*NUM_CSNS
] = {
121 0x00, 0x0B, 0x0F, 0xFF, 0xF7, 0xFF, 0x12, 0xE0,
122 0x00, 0x04, 0x0E, 0x08, 0xF7, 0xFF, 0x12, 0xE0,
123 0x00, 0x09, 0x0D, 0x05, 0xF7, 0xFF, 0x12, 0xE0,
124 0x00, 0x0A, 0x0C, 0x06, 0xF7, 0xFF, 0x12, 0xE0,
125 0x00, 0x0F, 0x0B, 0x03, 0xF7, 0xFF, 0x12, 0xE0,
126 0x00, 0x08, 0x0A, 0x0C, 0xF7, 0xFF, 0x12, 0xE0,
127 0x00, 0x0D, 0x09, 0x09, 0xF7, 0xFF, 0x12, 0xE0,
128 0x00, 0x0E, 0x08, 0x0A, 0xF7, 0xFF, 0x12, 0xE0,
129 0x00, 0x03, 0x07, 0x17, 0xF7, 0xFF, 0x12, 0xE0,
130 0x00, 0x3C, 0x06, 0xE0, 0xF7, 0xFF, 0x12, 0xE0,
131 0x00, 0x01, 0x05, 0x1D, 0xF7, 0xFF, 0x12, 0xE0,
132 0x00, 0x02, 0x04, 0x1E, 0xF7, 0xFF, 0x12, 0xE0,
133 0x00, 0x07, 0x03, 0x1B, 0xF7, 0xFF, 0x12, 0xE0,
134 0x00, 0x00, 0x02, 0x24, 0xF7, 0xFF, 0x12, 0xE0,
135 0x00, 0x05, 0x01, 0x21, 0xF7, 0xFF, 0x12, 0xE0 };
137 memcpy(c
.d
.asBytes
, csns
, 8*NUM_CSNS
);
140 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, -1)) {
141 PrintAndLog("Command timed out");
145 uint8_t num_mac_responses
= resp
.arg
[1];
146 PrintAndLog("Mac responses: %d MACs obtained (should be %d)", num_mac_responses
,NUM_CSNS
);
148 size_t datalen
= NUM_CSNS
*24;
150 * Now, time to dump to file. We'll use this format:
151 * <8-byte CSN><8-byte CC><4 byte NR><4 byte MAC>....
152 * So, it should wind up as
155 * The returndata from the pm3 is on the following format
156 * <4 byte NR><4 byte MAC>
157 * CC are all zeroes, CSN is the same as was sent in
159 void* dump
= malloc(datalen
);
160 memset(dump
,0,datalen
);//<-- Need zeroes for the CC-field
162 for(i
= 0 ; i
< NUM_CSNS
; i
++)
164 memcpy(dump
+i
*24, csns
+i
*8,8); //CSN
165 //8 zero bytes here...
166 //Then comes NR_MAC (eight bytes from the response)
167 memcpy(dump
+i
*24+16,resp
.d
.asBytes
+i
*8,8);
170 /** Now, save to dumpfile **/
171 saveFile("iclass_mac_attack", "bin", dump
,datalen
);
175 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,numberOfCSNs
}};
176 memcpy(c
.d
.asBytes
, CSN
, 8);
183 int HFiClassReader(const char *Cmd
, bool loop
, bool verbose
) {
184 bool tagFound
= false;
185 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
186 FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_AA
}};
187 // loop in client not device - else on windows have a communication error
188 c
.arg
[0] |= FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
;
192 if (WaitForResponseTimeout(CMD_ACK
,&resp
, 4500)) {
193 uint8_t readStatus
= resp
.arg
[0] & 0xff;
194 uint8_t *data
= resp
.d
.asBytes
;
197 PrintAndLog("Readstatus:%02x", readStatus
);
198 if( readStatus
== 0){
200 if (verbose
) PrintAndLog("Quitting...");
203 if( readStatus
& FLAG_ICLASS_READER_CSN
){
204 PrintAndLog("CSN: %s",sprint_hex(data
,8));
207 if( readStatus
& FLAG_ICLASS_READER_CC
) PrintAndLog("CC: %s",sprint_hex(data
+16,8));
208 if( readStatus
& FLAG_ICLASS_READER_CONF
){
209 printIclassDumpInfo(data
);
211 if (tagFound
&& !loop
) return 1;
213 if (verbose
) PrintAndLog("Command execute timeout");
220 int CmdHFiClassReader(const char *Cmd
) {
221 return HFiClassReader(Cmd
, true, true);
224 int CmdHFiClassReader_Replay(const char *Cmd
) {
225 uint8_t readerType
= 0;
226 uint8_t MAC
[4]={0x00, 0x00, 0x00, 0x00};
229 PrintAndLog("Usage: hf iclass replay <MAC>");
230 PrintAndLog(" sample: hf iclass replay 00112233");
234 if (param_gethex(Cmd
, 0, MAC
, 8)) {
235 PrintAndLog("MAC must include 8 HEX symbols");
239 UsbCommand c
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
240 memcpy(c
.d
.asBytes
, MAC
, 4);
246 int iclassEmlSetMem(uint8_t *data
, int blockNum
, int blocksCount
) {
247 UsbCommand c
= {CMD_MIFARE_EML_MEMSET
, {blockNum
, blocksCount
, 0}};
248 memcpy(c
.d
.asBytes
, data
, blocksCount
* 16);
253 int hf_iclass_eload_usage(void) {
254 PrintAndLog("Loads iclass tag-dump into emulator memory on device");
255 PrintAndLog("Usage: hf iclass eload f <filename>");
257 PrintAndLog("Example: hf iclass eload f iclass_tagdump-aa162d30f8ff12f1.bin");
261 int CmdHFiClassELoad(const char *Cmd
) {
263 char opt
= param_getchar(Cmd
, 0);
264 if (strlen(Cmd
)<1 || opt
== 'h')
265 return hf_iclass_eload_usage();
267 //File handling and reading
269 char filename
[FILE_PATH_SIZE
];
270 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
272 f
= fopen(filename
, "rb");
274 return hf_iclass_eload_usage();
278 PrintAndLog("Failed to read from file '%s'", filename
);
282 fseek(f
, 0, SEEK_END
);
283 long fsize
= ftell(f
);
284 fseek(f
, 0, SEEK_SET
);
286 uint8_t *dump
= malloc(fsize
);
289 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
292 printIclassDumpInfo(dump
);
295 if (bytes_read
< fsize
)
297 prnlog("Error, could only read %d bytes (should be %d)",bytes_read
, fsize
);
302 uint32_t bytes_sent
= 0;
303 uint32_t bytes_remaining
= bytes_read
;
305 while(bytes_remaining
> 0){
306 uint32_t bytes_in_packet
= MIN(USB_CMD_DATA_SIZE
, bytes_remaining
);
307 UsbCommand c
= {CMD_ICLASS_EML_MEMSET
, {bytes_sent
,bytes_in_packet
,0}};
308 memcpy(c
.d
.asBytes
, dump
, bytes_in_packet
);
310 bytes_remaining
-= bytes_in_packet
;
311 bytes_sent
+= bytes_in_packet
;
314 PrintAndLog("Sent %d bytes of data to device emulator memory", bytes_sent
);
318 static int readKeyfile(const char *filename
, size_t len
, uint8_t* buffer
) {
319 FILE *f
= fopen(filename
, "rb");
321 PrintAndLog("Failed to read from file '%s'", filename
);
324 fseek(f
, 0, SEEK_END
);
325 long fsize
= ftell(f
);
326 fseek(f
, 0, SEEK_SET
);
327 size_t bytes_read
= fread(buffer
, 1, len
, f
);
331 PrintAndLog("Warning, file size is %d, expected %d", fsize
, len
);
334 if(bytes_read
!= len
)
336 PrintAndLog("Warning, could only read %d bytes, expected %d" ,bytes_read
, len
);
342 int usage_hf_iclass_decrypt(void) {
343 PrintAndLog("Usage: hf iclass decrypt f <tagdump>");
345 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
346 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
348 PrintAndLog("example: hf iclass decrypt f tagdump_12312342343.bin");
350 PrintAndLog("OBS! This is pretty stupid implementation, it tries to decrypt every block after block 6. ");
351 PrintAndLog("Correct behaviour would be to decrypt only the application areas where the key is valid,");
352 PrintAndLog("which is defined by the configuration block.");
356 int CmdHFiClassDecrypt(const char *Cmd
) {
357 uint8_t key
[16] = { 0 };
358 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
360 usage_hf_iclass_decrypt();
363 PrintAndLog("Decryption file found... ");
364 char opt
= param_getchar(Cmd
, 0);
365 if (strlen(Cmd
)<1 || opt
== 'h')
366 return usage_hf_iclass_decrypt();
368 //Open the tagdump-file
370 char filename
[FILE_PATH_SIZE
];
371 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
373 f
= fopen(filename
, "rb");
375 return usage_hf_iclass_decrypt();
378 fseek(f
, 0, SEEK_END
);
379 long fsize
= ftell(f
);
380 fseek(f
, 0, SEEK_SET
);
381 uint8_t enc_dump
[8] = {0};
382 uint8_t *decrypted
= malloc(fsize
);
383 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
384 des3_set2key_dec( &ctx
, key
);
385 size_t bytes_read
= fread(enc_dump
, 1, 8, f
);
387 //Use the first block (CSN) for filename
388 char outfilename
[FILE_PATH_SIZE
] = { 0 };
389 snprintf(outfilename
,FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x-decrypted",
390 enc_dump
[0],enc_dump
[1],enc_dump
[2],enc_dump
[3],
391 enc_dump
[4],enc_dump
[5],enc_dump
[6],enc_dump
[7]);
394 while(bytes_read
== 8)
398 memcpy(decrypted
+(blocknum
*8), enc_dump
, 8);
400 des3_crypt_ecb(&ctx
, enc_dump
,decrypted
+(blocknum
*8) );
402 printvar("decrypted block", decrypted
+(blocknum
*8), 8);
403 bytes_read
= fread(enc_dump
, 1, 8, f
);
408 saveFile(outfilename
,"bin", decrypted
, blocknum
*8);
413 int usage_hf_iclass_encrypt(void) {
414 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
416 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
417 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
419 PrintAndLog("example: hf iclass encrypt 0102030405060708");
424 static int iClassEncryptBlkData(uint8_t *blkData
) {
425 uint8_t key
[16] = { 0 };
426 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
428 usage_hf_iclass_encrypt();
431 PrintAndLog("Decryption file found... ");
433 uint8_t encryptedData
[16];
434 uint8_t *encrypted
= encryptedData
;
435 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
436 des3_set2key_enc( &ctx
, key
);
438 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
439 //printvar("decrypted block", decrypted, 8);
440 memcpy(blkData
,encrypted
,8);
445 int CmdHFiClassEncryptBlk(const char *Cmd
) {
446 uint8_t blkData
[8] = {0};
447 char opt
= param_getchar(Cmd
, 0);
448 if (strlen(Cmd
)<1 || opt
== 'h')
449 return usage_hf_iclass_encrypt();
451 //get the bytes to encrypt
452 if (param_gethex(Cmd
, 0, blkData
, 16))
454 PrintAndLog("BlockData must include 16 HEX symbols");
457 if (!iClassEncryptBlkData(blkData
)) return 0;
459 printvar("encrypted block", blkData
, 8);
463 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
466 memcpy(WB
+ 1,data
,8);
467 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
468 //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]);
471 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
474 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
475 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
477 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
479 clearCommandBuffer();
481 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
483 PrintAndLog("Command execute timeout");
487 uint8_t isOK
= resp
.arg
[0] & 0xff;
488 uint8_t *data
= resp
.d
.asBytes
;
491 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
494 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
497 PrintAndLog("Failed to obtain CC! Aborting");
503 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
) {
504 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
505 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
507 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
512 memcpy(div_key
, KEY
, 8);
514 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
515 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]);
517 doMAC(CCNR
, div_key
, MAC
);
519 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
520 memcpy(d
.d
.asBytes
, MAC
, 4);
521 clearCommandBuffer();
523 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
525 PrintAndLog("Auth Command execute timeout");
528 uint8_t isOK
= resp
.arg
[0] & 0xff;
530 PrintAndLog("Authentication error");
536 int usage_hf_iclass_dump(void) {
537 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e|r\n");
538 PrintAndLog("Options:");
539 PrintAndLog(" f <filename> : specify a filename to save dump to");
540 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
541 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
542 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
543 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
544 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
545 PrintAndLog(" r : If 'r' is specified, the key is interpreted as raw block 3/4");
546 PrintAndLog(" NOTE: * = required");
547 PrintAndLog("Samples:");
548 PrintAndLog(" hf iclass dump k 001122334455667B");
549 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
550 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
554 int CmdHFiClassReader_Dump(const char *Cmd
) {
556 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
557 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
558 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
562 uint8_t app_areas
= 1;
564 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
565 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
568 uint8_t fileNameLen
= 0;
569 char filename
[FILE_PATH_SIZE
]={0};
570 char tempStr
[50] = {0};
571 bool have_debit_key
= false;
572 bool have_credit_key
= false;
573 bool use_credit_key
= false;
579 while(param_getchar(Cmd
, cmdp
) != 0x00)
581 switch(param_getchar(Cmd
, cmdp
))
585 return usage_hf_iclass_dump();
588 have_credit_key
= true;
589 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
591 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
592 } else if (dataLen
== 1) {
593 keyNbr
= param_get8(Cmd
, cmdp
+1);
594 if (keyNbr
<= ICLASS_KEYS_MAX
) {
595 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
597 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
601 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
613 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
614 if (fileNameLen
< 1) {
615 PrintAndLog("No filename found after f");
622 have_debit_key
= true;
623 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
625 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
626 } else if (dataLen
== 1) {
627 keyNbr
= param_get8(Cmd
, cmdp
+1);
628 if (keyNbr
<= ICLASS_KEYS_MAX
) {
629 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
631 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
635 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
646 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
650 if(errors
) return usage_hf_iclass_dump();
653 if (cmdp
< 2) return usage_hf_iclass_dump();
654 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
655 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
657 //get config and first 3 blocks
658 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
659 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
661 uint8_t tag_data
[255*8];
663 clearCommandBuffer();
665 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
666 PrintAndLog("Command execute timeout");
667 ul_switch_off_field();
670 uint8_t readStatus
= resp
.arg
[0] & 0xff;
671 uint8_t *data
= resp
.d
.asBytes
;
674 PrintAndLog("No tag found...");
675 ul_switch_off_field();
678 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
679 memcpy(tag_data
, data
, 8*3);
680 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
682 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
683 // large memory - not able to dump pages currently
684 if (numblks
> maxBlk
) numblks
= maxBlk
;
686 ul_switch_off_field();
687 // authenticate debit key and get div_key - later store in dump block 3
688 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
689 //try twice - for some reason it sometimes fails the first time...
690 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
691 ul_switch_off_field();
697 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
698 clearCommandBuffer();
700 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
701 PrintAndLog("Command execute time-out 1");
702 ul_switch_off_field();
705 uint32_t blocksRead
= resp
.arg
[1];
706 uint8_t isOK
= resp
.arg
[0] & 0xff;
707 if (!isOK
&& !blocksRead
) {
708 PrintAndLog("Read Block Failed");
709 ul_switch_off_field();
712 uint32_t startindex
= resp
.arg
[2];
713 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
714 PrintAndLog("Data exceeded Buffer size!");
715 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
717 // response ok - now get bigbuf content of the dump
718 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
719 WaitForResponse(CMD_ACK
,NULL
);
720 size_t gotBytes
= blocksRead
*8 + blockno
*8;
723 if (have_credit_key
) {
724 //turn off hf field before authenticating with different key
725 ul_switch_off_field();
727 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
728 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
729 //try twice - for some reason it sometimes fails the first time...
730 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
731 ul_switch_off_field();
735 // do we still need to read more block? (aa2 enabled?)
736 if (maxBlk
> blockno
+numblks
+1) {
737 // setup dump and start
738 w
.arg
[0] = blockno
+ blocksRead
;
739 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
740 clearCommandBuffer();
742 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
743 PrintAndLog("Command execute timeout 2");
744 ul_switch_off_field();
747 uint8_t isOK
= resp
.arg
[0] & 0xff;
748 blocksRead
= resp
.arg
[1];
749 if (!isOK
&& !blocksRead
) {
750 PrintAndLog("Read Block Failed 2");
751 ul_switch_off_field();
755 startindex
= resp
.arg
[2];
756 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
757 PrintAndLog("Data exceeded Buffer size!");
758 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
760 // get dumped data from bigbuf
761 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
762 WaitForResponse(CMD_ACK
,NULL
);
764 gotBytes
+= blocksRead
*8;
765 } else { //field is still on - turn it off...
766 ul_switch_off_field();
770 // add diversified keys to dump
771 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
772 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
774 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
775 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
776 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
778 if (filename
[0] == 0){
779 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
780 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
781 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
784 // save the dump to .bin file
785 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
786 saveFile(filename
, "bin", tag_data
, gotBytes
);
790 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
791 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
792 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
793 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, verbose
))
798 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
799 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
800 memcpy(w
.d
.asBytes
, bldata
, 8);
801 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
803 clearCommandBuffer();
805 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
807 PrintAndLog("Write Command execute timeout");
810 uint8_t isOK
= resp
.arg
[0] & 0xff;
812 PrintAndLog("Write Block Failed");
815 PrintAndLog("Write Block Successful");
819 int usage_hf_iclass_writeblock(void) {
820 PrintAndLog("Options:");
821 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
822 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
823 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
824 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
825 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
826 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
827 PrintAndLog("Samples:");
828 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
829 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
830 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
834 int CmdHFiClass_WriteBlock(const char *Cmd
) {
836 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
837 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
840 char tempStr
[50] = {0};
841 bool use_credit_key
= false;
846 while(param_getchar(Cmd
, cmdp
) != 0x00)
848 switch(param_getchar(Cmd
, cmdp
))
852 return usage_hf_iclass_writeblock();
855 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
856 PrintAndLog("Block No must include 2 HEX symbols\n");
863 use_credit_key
= true;
868 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
870 PrintAndLog("KEY must include 16 HEX symbols\n");
882 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
884 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
885 } else if (dataLen
== 1) {
886 keyNbr
= param_get8(Cmd
, cmdp
+1);
887 if (keyNbr
<= ICLASS_KEYS_MAX
) {
888 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
890 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
894 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
905 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
909 if(errors
) return usage_hf_iclass_writeblock();
912 if (cmdp
< 6) return usage_hf_iclass_writeblock();
913 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, rawkey
, true);
914 ul_switch_off_field();
918 int usage_hf_iclass_clone(void) {
919 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> c e|r");
920 PrintAndLog("Options:");
921 PrintAndLog(" f <filename>: specify a filename to clone from");
922 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
923 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
924 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
925 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
926 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
927 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
928 PrintAndLog("Samples:");
929 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
930 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
931 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
935 int CmdHFiClassCloneTag(const char *Cmd
) {
936 char filename
[FILE_PATH_SIZE
];
937 char tempStr
[50]={0};
938 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
940 uint8_t fileNameLen
= 0;
941 uint8_t startblock
= 0;
942 uint8_t endblock
= 0;
944 bool use_credit_key
= false;
949 while(param_getchar(Cmd
, cmdp
) != 0x00)
951 switch(param_getchar(Cmd
, cmdp
))
955 return usage_hf_iclass_clone();
958 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
959 PrintAndLog("Start Block No must include 2 HEX symbols\n");
966 use_credit_key
= true;
976 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
977 if (fileNameLen
< 1) {
978 PrintAndLog("No filename found after f");
985 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
987 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
988 } else if (dataLen
== 1) {
989 keyNbr
= param_get8(Cmd
, cmdp
+1);
990 if (keyNbr
<= ICLASS_KEYS_MAX
) {
991 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
993 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
997 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1004 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
1005 PrintAndLog("Start Block No must include 2 HEX symbols\n");
1016 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1020 if(errors
) return usage_hf_iclass_clone();
1023 if (cmdp
< 8) return usage_hf_iclass_clone();
1027 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1029 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1030 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1032 // file handling and reading
1033 f
= fopen(filename
,"rb");
1035 PrintAndLog("Failed to read from file '%s'", filename
);
1040 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1043 // now read data from the file from block 6 --- 19
1044 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1045 // 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,
1046 // else we have to create a share memory
1048 fseek(f
,startblock
*8,SEEK_SET
);
1049 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0 ) {
1050 PrintAndLog("File reading error.");
1055 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1056 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1058 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, true))
1061 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1063 // calculate all mac for every the block we will write
1064 for (i
= startblock
; i
<= endblock
; i
++){
1065 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1066 // usb command d start pointer = d + (i - 6) * 12
1067 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1068 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1070 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1071 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1072 memcpy(ptr
+ 8,MAC
, 4);
1075 for (i
= 0; i
<= endblock
- startblock
;i
++){
1076 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1077 printf("Block |%02x|",i
+ startblock
);
1078 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]);
1079 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1083 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1085 PrintAndLog("Command execute timeout");
1091 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool rawkey
, bool verbose
) {
1092 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1093 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1095 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, rawkey
, verbose
))
1099 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1100 clearCommandBuffer();
1102 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1104 PrintAndLog("Command execute timeout");
1107 uint8_t isOK
= resp
.arg
[0] & 0xff;
1109 PrintAndLog("Read Block Failed");
1112 //data read is stored in: resp.d.asBytes[0-15]
1113 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1117 int usage_hf_iclass_readblock(void) {
1118 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e|r\n");
1119 PrintAndLog("Options:");
1120 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1121 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1122 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1123 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1124 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
1125 PrintAndLog("Samples:");
1126 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1127 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1128 PrintAndLog(" hf iclass readblk b 0A k 0");
1132 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1134 uint8_t keyType
= 0x88; //debit key
1135 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1137 uint8_t dataLen
= 0;
1138 char tempStr
[50] = {0};
1140 bool rawkey
= false;
1141 bool errors
= false;
1143 while(param_getchar(Cmd
, cmdp
) != 0x00)
1145 switch(param_getchar(Cmd
, cmdp
))
1149 return usage_hf_iclass_readblock();
1152 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1153 PrintAndLog("Block No must include 2 HEX symbols\n");
1170 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1171 if (dataLen
== 16) {
1172 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1173 } else if (dataLen
== 1) {
1174 keyNbr
= param_get8(Cmd
, cmdp
+1);
1175 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1176 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1178 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1182 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1193 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1197 if(errors
) return usage_hf_iclass_readblock();
1200 if (cmdp
< 4) return usage_hf_iclass_readblock();
1202 return ReadBlock(KEY
, blockno
, keyType
, elite
, rawkey
, true);
1205 int CmdHFiClass_loclass(const char *Cmd
) {
1206 char opt
= param_getchar(Cmd
, 0);
1208 if (strlen(Cmd
)<1 || opt
== 'h') {
1209 PrintAndLog("Usage: hf iclass loclass [options]");
1210 PrintAndLog("Options:");
1211 PrintAndLog("h Show this help");
1212 PrintAndLog("t Perform self-test");
1213 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1214 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1215 PrintAndLog(" malicious CSNs, and their protocol responses");
1216 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
1217 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1218 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1219 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1220 PrintAndLog(" ... totalling N*24 bytes");
1223 char fileName
[255] = {0};
1226 if(param_getstr(Cmd
, 1, fileName
) > 0)
1228 return bruteforceFileNoKeys(fileName
);
1231 PrintAndLog("You must specify a filename");
1236 int errors
= testCipherUtils();
1237 errors
+= testMAC();
1238 errors
+= doKeyTests(0);
1239 errors
+= testElite();
1242 prnlog("OBS! There were errors!!!");
1250 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1251 uint8_t blockdata
[8];
1253 memcpy(&mem_config
, iclass_dump
+ 13,1);
1254 uint8_t maxmemcount
;
1255 uint8_t filemaxblock
= filesize
/ 8;
1256 if (mem_config
& 0x80)
1260 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1262 if (startblock
== 0)
1264 if ((endblock
> maxmemcount
) || (endblock
== 0))
1265 endblock
= maxmemcount
;
1266 if (endblock
> filemaxblock
)
1267 endblock
= filemaxblock
;
1270 while (i
<= endblock
){
1271 printf("Block |%02X| ",i
);
1272 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1273 for (j
= 0;j
< 8;j
++)
1274 printf("%02X ",blockdata
[j
]);
1280 int usage_hf_iclass_readtagfile() {
1281 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1285 int CmdHFiClassReadTagFile(const char *Cmd
) {
1290 char filename
[FILE_PATH_SIZE
];
1291 if (param_getstr(Cmd
, 0, filename
) < 1)
1292 return usage_hf_iclass_readtagfile();
1293 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1296 sscanf(tempnum
,"%d",&startblock
);
1298 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1301 sscanf(tempnum
,"%d",&endblock
);
1302 // file handling and reading
1303 f
= fopen(filename
,"rb");
1305 PrintAndLog("Failed to read from file '%s'", filename
);
1308 fseek(f
, 0, SEEK_END
);
1309 long fsize
= ftell(f
);
1310 fseek(f
, 0, SEEK_SET
);
1312 uint8_t *dump
= malloc(fsize
);
1315 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1317 uint8_t *csn
= dump
;
1318 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]);
1319 // printIclassDumpInfo(dump);
1320 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1326 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1327 uint64_t new_div = 0x00;
1333 uint64_t hexarray_to_uint64(uint8_t *key) {
1336 for (int i = 0;i < 8;i++)
1337 sprintf(&temp[(i *2)],"%02X",key[i]);
1339 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1344 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1345 uint8_t keytable
[128] = {0};
1346 uint8_t key_index
[8] = {0};
1348 uint8_t key_sel
[8] = { 0 };
1349 uint8_t key_sel_p
[8] = { 0 };
1350 hash2(KEY
, keytable
);
1351 hash1(CSN
, key_index
);
1352 for(uint8_t i
= 0; i
< 8 ; i
++)
1353 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1355 //Permute from iclass format to standard format
1356 permutekey_rev(key_sel
, key_sel_p
);
1357 diversifyKey(CSN
, key_sel_p
, div_key
);
1359 diversifyKey(CSN
, KEY
, div_key
);
1363 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1364 //calculate and return xor_div_key (ready for a key write command)
1365 //print all div_keys if verbose
1366 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1367 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1368 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1370 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1372 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1374 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1375 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1378 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1379 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1380 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1384 int usage_hf_iclass_calc_newkey(void) {
1385 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1386 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1387 PrintAndLog(" Options:");
1388 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1389 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1390 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1391 PrintAndLog(" e : specify new key as elite calc");
1392 PrintAndLog(" ee : specify old and new key as elite calc");
1393 PrintAndLog("Samples:");
1394 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1395 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1396 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1397 PrintAndLog("NOTE: * = required\n");
1402 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1403 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1404 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1405 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1406 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1407 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1409 uint8_t dataLen
= 0;
1410 char tempStr
[50] = {0};
1411 bool givenCSN
= false;
1412 bool oldElite
= false;
1414 bool errors
= false;
1416 while(param_getchar(Cmd
, cmdp
) != 0x00)
1418 switch(param_getchar(Cmd
, cmdp
))
1422 return usage_hf_iclass_calc_newkey();
1425 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1433 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1434 if (dataLen
== 16) {
1435 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1436 } else if (dataLen
== 1) {
1437 keyNbr
= param_get8(Cmd
, cmdp
+1);
1438 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1439 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1441 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1445 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1452 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1453 if (dataLen
== 16) {
1454 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1455 } else if (dataLen
== 1) {
1456 keyNbr
= param_get8(Cmd
, cmdp
+1);
1457 if (keyNbr
<= ICLASS_KEYS_MAX
) {
1458 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1460 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1464 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1472 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1473 return usage_hf_iclass_calc_newkey();
1477 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1481 if(errors
) return usage_hf_iclass_calc_newkey();
1484 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1487 if (!select_only(CSN
, CCNR
, false, true))
1490 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1494 static int loadKeys(char *filename
) {
1496 f
= fopen(filename
,"rb");
1498 PrintAndLog("Failed to read from file '%s'", filename
);
1501 fseek(f
, 0, SEEK_END
);
1502 long fsize
= ftell(f
);
1503 fseek(f
, 0, SEEK_SET
);
1505 uint8_t *dump
= malloc(fsize
);
1507 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1509 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1510 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1515 for (; i
< bytes_read
/8; i
++){
1516 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1519 PrintAndLog("%u keys loaded", i
);
1523 static int saveKeys(char *filename
) {
1525 f
= fopen(filename
,"wb");
1527 printf("error opening file %s\n",filename
);
1530 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1531 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1532 PrintAndLog("save key failed to write to file: %s", filename
);
1540 static int printKeys(void) {
1542 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1543 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1549 int usage_hf_iclass_managekeys(void) {
1550 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1551 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1552 PrintAndLog(" Options:");
1553 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1554 PrintAndLog(" k <key> : set a key in memory");
1555 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1556 PrintAndLog(" s : save keys in memory to file specified by filename");
1557 PrintAndLog(" l : load keys to memory from file specified by filename");
1558 PrintAndLog(" p : print keys loaded into memory\n");
1559 PrintAndLog("Samples:");
1560 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1561 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1562 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1563 PrintAndLog(" print keys : hf iclass managekeys p\n");
1567 int CmdHFiClassManageKeys(const char *Cmd
) {
1569 uint8_t dataLen
= 0;
1570 uint8_t KEY
[8] = {0};
1571 char filename
[FILE_PATH_SIZE
];
1572 uint8_t fileNameLen
= 0;
1573 bool errors
= false;
1574 uint8_t operation
= 0;
1578 while(param_getchar(Cmd
, cmdp
) != 0x00)
1580 switch(param_getchar(Cmd
, cmdp
))
1584 return usage_hf_iclass_managekeys();
1587 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1588 if (fileNameLen
< 1) {
1589 PrintAndLog("No filename found after f");
1596 keyNbr
= param_get8(Cmd
, cmdp
+1);
1598 PrintAndLog("Wrong block number");
1605 operation
+= 3; //set key
1606 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1607 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1608 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1610 PrintAndLog("\nERROR: Key is incorrect length\n");
1617 operation
+= 4; //print keys in memory
1622 operation
+= 5; //load keys from file
1627 operation
+= 6; //save keys to file
1631 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1635 if(errors
) return usage_hf_iclass_managekeys();
1637 if (operation
== 0){
1638 PrintAndLog("no operation specified (load, save, or print)\n");
1639 return usage_hf_iclass_managekeys();
1642 PrintAndLog("Too many operations specified\n");
1643 return usage_hf_iclass_managekeys();
1645 if (operation
> 4 && fileNameLen
== 0){
1646 PrintAndLog("You must enter a filename when loading or saving\n");
1647 return usage_hf_iclass_managekeys();
1651 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1652 case 4: return printKeys();
1653 case 5: return loadKeys(filename
);
1654 case 6: return saveKeys(filename
);
1660 static command_t CommandTable
[] =
1662 {"help", CmdHelp
, 1, "This help"},
1663 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1664 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1665 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1666 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1667 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1668 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1669 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1670 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1671 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1672 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1673 {"reader", CmdHFiClassReader
, 0, " Read an iClass tag"},
1674 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1675 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1676 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1677 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1678 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1679 {NULL
, NULL
, 0, NULL
}
1682 int CmdHFiClass(const char *Cmd
)
1684 CmdsParse(CommandTable
, Cmd
);
1688 int CmdHelp(const char *Cmd
)
1690 CmdsHelp(CommandTable
);