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"
36 static int CmdHelp(const char *Cmd
);
38 #define ICLASS_KEYS_MAX 8
39 static uint8_t iClass_Key_Table
[ICLASS_KEYS_MAX
][8] = {
40 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
41 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 },
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 }
50 typedef struct iclass_block
{
54 int xorbits_8(uint8_t val
) {
55 uint8_t res
= val
^ (val
>> 1); //1st pass
56 res
= res
^ (res
>> 1); // 2nd pass
57 res
= res
^ (res
>> 2); // 3rd pass
58 res
= res
^ (res
>> 4); // 4th pass
62 int CmdHFiClassList(const char *Cmd
) {
63 PrintAndLog("Deprecated command, use 'hf list iclass' instead");
67 int CmdHFiClassSnoop(const char *Cmd
) {
68 UsbCommand c
= {CMD_SNOOP_ICLASS
};
73 int usage_hf_iclass_sim(void) {
74 PrintAndLog("Usage: hf iclass sim <option> [CSN]");
75 PrintAndLog(" options");
76 PrintAndLog(" 0 <CSN> simulate the given CSN");
77 PrintAndLog(" 1 simulate default CSN");
78 PrintAndLog(" 2 Reader-attack, gather reader responses to extract elite key");
79 PrintAndLog(" 3 Full simulation using emulator memory (see 'hf iclass eload')");
80 PrintAndLog(" example: hf iclass sim 0 031FEC8AF7FF12E0");
81 PrintAndLog(" example: hf iclass sim 2");
82 PrintAndLog(" example: hf iclass eload 'tagdump.bin'");
83 PrintAndLog(" hf iclass sim 3");
88 int CmdHFiClassSim(const char *Cmd
) {
90 uint8_t CSN
[8] = {0, 0, 0, 0, 0, 0, 0, 0};
93 return usage_hf_iclass_sim();
95 simType
= param_get8ex(Cmd
, 0, 0, 10);
99 if (param_gethex(Cmd
, 1, CSN
, 16)) {
100 PrintAndLog("A CSN should consist of 16 HEX symbols");
101 return usage_hf_iclass_sim();
104 PrintAndLog("--simtype:%02x csn:%s", simType
, sprint_hex(CSN
, 8));
108 PrintAndLog("Undefined simptype %d", simType
);
109 return usage_hf_iclass_sim();
112 uint8_t numberOfCSNs
=0;
115 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,NUM_CSNS
}};
116 UsbCommand resp
= {0};
118 uint8_t csns
[8*NUM_CSNS
] = {
119 0x00, 0x0B, 0x0F, 0xFF, 0xF7, 0xFF, 0x12, 0xE0,
120 0x00, 0x04, 0x0E, 0x08, 0xF7, 0xFF, 0x12, 0xE0,
121 0x00, 0x09, 0x0D, 0x05, 0xF7, 0xFF, 0x12, 0xE0,
122 0x00, 0x0A, 0x0C, 0x06, 0xF7, 0xFF, 0x12, 0xE0,
123 0x00, 0x0F, 0x0B, 0x03, 0xF7, 0xFF, 0x12, 0xE0,
124 0x00, 0x08, 0x0A, 0x0C, 0xF7, 0xFF, 0x12, 0xE0,
125 0x00, 0x0D, 0x09, 0x09, 0xF7, 0xFF, 0x12, 0xE0,
126 0x00, 0x0E, 0x08, 0x0A, 0xF7, 0xFF, 0x12, 0xE0,
127 0x00, 0x03, 0x07, 0x17, 0xF7, 0xFF, 0x12, 0xE0,
128 0x00, 0x3C, 0x06, 0xE0, 0xF7, 0xFF, 0x12, 0xE0,
129 0x00, 0x01, 0x05, 0x1D, 0xF7, 0xFF, 0x12, 0xE0,
130 0x00, 0x02, 0x04, 0x1E, 0xF7, 0xFF, 0x12, 0xE0,
131 0x00, 0x07, 0x03, 0x1B, 0xF7, 0xFF, 0x12, 0xE0,
132 0x00, 0x00, 0x02, 0x24, 0xF7, 0xFF, 0x12, 0xE0,
133 0x00, 0x05, 0x01, 0x21, 0xF7, 0xFF, 0x12, 0xE0 };
135 memcpy(c
.d
.asBytes
, csns
, 8*NUM_CSNS
);
138 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, -1)) {
139 PrintAndLog("Command timed out");
143 uint8_t num_mac_responses
= resp
.arg
[1];
144 PrintAndLog("Mac responses: %d MACs obtained (should be %d)", num_mac_responses
,NUM_CSNS
);
146 size_t datalen
= NUM_CSNS
*24;
148 * Now, time to dump to file. We'll use this format:
149 * <8-byte CSN><8-byte CC><4 byte NR><4 byte MAC>....
150 * So, it should wind up as
153 * The returndata from the pm3 is on the following format
154 * <4 byte NR><4 byte MAC>
155 * CC are all zeroes, CSN is the same as was sent in
157 void* dump
= malloc(datalen
);
158 memset(dump
,0,datalen
);//<-- Need zeroes for the CC-field
160 for(i
= 0 ; i
< NUM_CSNS
; i
++)
162 memcpy(dump
+i
*24, csns
+i
*8,8); //CSN
163 //8 zero bytes here...
164 //Then comes NR_MAC (eight bytes from the response)
165 memcpy(dump
+i
*24+16,resp
.d
.asBytes
+i
*8,8);
168 /** Now, save to dumpfile **/
169 saveFile("iclass_mac_attack", "bin", dump
,datalen
);
173 UsbCommand c
= {CMD_SIMULATE_TAG_ICLASS
, {simType
,numberOfCSNs
}};
174 memcpy(c
.d
.asBytes
, CSN
, 8);
181 int HFiClassReader(const char *Cmd
, bool loop
, bool verbose
) {
182 bool tagFound
= false;
183 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
184 FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_AA
}};
185 // loop in client not device - else on windows have a communication error
186 c
.arg
[0] |= FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
;
190 if (WaitForResponseTimeout(CMD_ACK
,&resp
, 4500)) {
191 uint8_t readStatus
= resp
.arg
[0] & 0xff;
192 uint8_t *data
= resp
.d
.asBytes
;
195 PrintAndLog("Readstatus:%02x", readStatus
);
196 if( readStatus
== 0){
198 if (verbose
) PrintAndLog("Quitting...");
201 if( readStatus
& FLAG_ICLASS_READER_CSN
){
202 PrintAndLog("CSN: %s",sprint_hex(data
,8));
205 if( readStatus
& FLAG_ICLASS_READER_CC
) PrintAndLog("CC: %s",sprint_hex(data
+16,8));
206 if( readStatus
& FLAG_ICLASS_READER_CONF
){
207 printIclassDumpInfo(data
);
209 if (tagFound
&& !loop
) return 1;
211 if (verbose
) PrintAndLog("Command execute timeout");
218 int CmdHFiClassReader(const char *Cmd
) {
219 return HFiClassReader(Cmd
, true, true);
222 int CmdHFiClassReader_Replay(const char *Cmd
) {
223 uint8_t readerType
= 0;
224 uint8_t MAC
[4]={0x00, 0x00, 0x00, 0x00};
227 PrintAndLog("Usage: hf iclass replay <MAC>");
228 PrintAndLog(" sample: hf iclass replay 00112233");
232 if (param_gethex(Cmd
, 0, MAC
, 8)) {
233 PrintAndLog("MAC must include 8 HEX symbols");
237 UsbCommand c
= {CMD_READER_ICLASS_REPLAY
, {readerType
}};
238 memcpy(c
.d
.asBytes
, MAC
, 4);
244 int iclassEmlSetMem(uint8_t *data
, int blockNum
, int blocksCount
) {
245 UsbCommand c
= {CMD_MIFARE_EML_MEMSET
, {blockNum
, blocksCount
, 0}};
246 memcpy(c
.d
.asBytes
, data
, blocksCount
* 16);
251 int hf_iclass_eload_usage(void) {
252 PrintAndLog("Loads iclass tag-dump into emulator memory on device");
253 PrintAndLog("Usage: hf iclass eload f <filename>");
255 PrintAndLog("Example: hf iclass eload f iclass_tagdump-aa162d30f8ff12f1.bin");
259 int CmdHFiClassELoad(const char *Cmd
) {
261 char opt
= param_getchar(Cmd
, 0);
262 if (strlen(Cmd
)<1 || opt
== 'h')
263 return hf_iclass_eload_usage();
265 //File handling and reading
267 char filename
[FILE_PATH_SIZE
];
268 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0)
270 f
= fopen(filename
, "rb");
272 return hf_iclass_eload_usage();
276 PrintAndLog("Failed to read from file '%s'", filename
);
280 fseek(f
, 0, SEEK_END
);
281 long fsize
= ftell(f
);
282 fseek(f
, 0, SEEK_SET
);
285 PrintAndLog("Error, when getting filesize");
290 uint8_t *dump
= malloc(fsize
);
292 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
295 printIclassDumpInfo(dump
);
298 if (bytes_read
< fsize
)
300 prnlog("Error, could only read %d bytes (should be %d)",bytes_read
, fsize
);
305 uint32_t bytes_sent
= 0;
306 uint32_t bytes_remaining
= bytes_read
;
308 while(bytes_remaining
> 0){
309 uint32_t bytes_in_packet
= MIN(USB_CMD_DATA_SIZE
, bytes_remaining
);
310 UsbCommand c
= {CMD_ICLASS_EML_MEMSET
, {bytes_sent
,bytes_in_packet
,0}};
311 memcpy(c
.d
.asBytes
, dump
, bytes_in_packet
);
313 bytes_remaining
-= bytes_in_packet
;
314 bytes_sent
+= bytes_in_packet
;
317 PrintAndLog("Sent %d bytes of data to device emulator memory", bytes_sent
);
321 static int readKeyfile(const char *filename
, size_t len
, uint8_t* buffer
) {
322 FILE *f
= fopen(filename
, "rb");
324 PrintAndLog("Failed to read from file '%s'", filename
);
327 fseek(f
, 0, SEEK_END
);
328 long fsize
= ftell(f
);
329 fseek(f
, 0, SEEK_SET
);
330 size_t bytes_read
= fread(buffer
, 1, len
, f
);
334 PrintAndLog("Warning, file size is %d, expected %d", fsize
, len
);
337 if(bytes_read
!= len
)
339 PrintAndLog("Warning, could only read %d bytes, expected %d" ,bytes_read
, len
);
345 int usage_hf_iclass_decrypt(void) {
346 PrintAndLog("Usage: hf iclass decrypt f <tagdump>");
348 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
349 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
351 PrintAndLog("example: hf iclass decrypt f tagdump_12312342343.bin");
353 PrintAndLog("OBS! This is pretty stupid implementation, it tries to decrypt every block after block 6. ");
354 PrintAndLog("Correct behaviour would be to decrypt only the application areas where the key is valid,");
355 PrintAndLog("which is defined by the configuration block.");
359 int CmdHFiClassDecrypt(const char *Cmd
) {
360 uint8_t key
[16] = { 0 };
361 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
363 usage_hf_iclass_decrypt();
366 PrintAndLog("Decryption file found... ");
367 char opt
= param_getchar(Cmd
, 0);
368 if (strlen(Cmd
)<1 || opt
== 'h')
369 return usage_hf_iclass_decrypt();
371 //Open the tagdump-file
373 char filename
[FILE_PATH_SIZE
];
374 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0) {
375 f
= fopen(filename
, "rb");
377 PrintAndLog("Could not find file %s", filename
);
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);
419 int usage_hf_iclass_encrypt(void) {
420 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
422 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
423 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
425 PrintAndLog("example: hf iclass encrypt 0102030405060708");
430 static int iClassEncryptBlkData(uint8_t *blkData
) {
431 uint8_t key
[16] = { 0 };
432 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
434 usage_hf_iclass_encrypt();
437 PrintAndLog("Decryption file found... ");
439 uint8_t encryptedData
[16];
440 uint8_t *encrypted
= encryptedData
;
441 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
442 des3_set2key_enc( &ctx
, key
);
444 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
445 //printvar("decrypted block", decrypted, 8);
446 memcpy(blkData
,encrypted
,8);
451 int CmdHFiClassEncryptBlk(const char *Cmd
) {
452 uint8_t blkData
[8] = {0};
453 char opt
= param_getchar(Cmd
, 0);
454 if (strlen(Cmd
)<1 || opt
== 'h')
455 return usage_hf_iclass_encrypt();
457 //get the bytes to encrypt
458 if (param_gethex(Cmd
, 0, blkData
, 16))
460 PrintAndLog("BlockData must include 16 HEX symbols");
463 if (!iClassEncryptBlkData(blkData
)) return 0;
465 printvar("encrypted block", blkData
, 8);
469 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
472 memcpy(WB
+ 1,data
,8);
473 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
474 //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]);
477 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
480 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
481 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
483 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
485 clearCommandBuffer();
487 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
489 PrintAndLog("Command execute timeout");
493 uint8_t isOK
= resp
.arg
[0] & 0xff;
494 uint8_t *data
= resp
.d
.asBytes
;
497 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
500 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
503 PrintAndLog("Failed to obtain CC! Aborting");
509 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
) {
510 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
511 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
513 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
518 memcpy(div_key
, KEY
, 8);
520 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
521 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]);
523 doMAC(CCNR
, div_key
, MAC
);
525 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
526 memcpy(d
.d
.asBytes
, MAC
, 4);
527 clearCommandBuffer();
529 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
531 PrintAndLog("Auth Command execute timeout");
534 uint8_t isOK
= resp
.arg
[0] & 0xff;
536 PrintAndLog("Authentication error");
542 int usage_hf_iclass_dump(void) {
543 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e|r\n");
544 PrintAndLog("Options:");
545 PrintAndLog(" f <filename> : specify a filename to save dump to");
546 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
547 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
548 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
549 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
550 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
551 PrintAndLog(" r : If 'r' is specified, the key is interpreted as raw block 3/4");
552 PrintAndLog(" NOTE: * = required");
553 PrintAndLog("Samples:");
554 PrintAndLog(" hf iclass dump k 001122334455667B");
555 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
556 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
560 int CmdHFiClassReader_Dump(const char *Cmd
) {
562 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
563 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
564 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
568 uint8_t app_areas
= 1;
570 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
571 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
574 uint8_t fileNameLen
= 0;
575 char filename
[FILE_PATH_SIZE
]={0};
576 char tempStr
[50] = {0};
577 bool have_debit_key
= false;
578 bool have_credit_key
= false;
579 bool use_credit_key
= false;
585 while(param_getchar(Cmd
, cmdp
) != 0x00)
587 switch(param_getchar(Cmd
, cmdp
))
591 return usage_hf_iclass_dump();
594 have_credit_key
= true;
595 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
597 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
598 } else if (dataLen
== 1) {
599 keyNbr
= param_get8(Cmd
, cmdp
+1);
600 if (keyNbr
< ICLASS_KEYS_MAX
) {
601 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
603 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
607 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
619 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
620 if (fileNameLen
< 1) {
621 PrintAndLog("No filename found after f");
628 have_debit_key
= true;
629 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
631 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
632 } else if (dataLen
== 1) {
633 keyNbr
= param_get8(Cmd
, cmdp
+1);
634 if (keyNbr
< ICLASS_KEYS_MAX
) {
635 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
637 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
641 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
652 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
656 if(errors
) return usage_hf_iclass_dump();
659 if (cmdp
< 2) return usage_hf_iclass_dump();
660 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
661 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
663 //get config and first 3 blocks
664 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
665 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
667 uint8_t tag_data
[255*8];
669 clearCommandBuffer();
671 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
672 PrintAndLog("Command execute timeout");
673 ul_switch_off_field();
676 uint8_t readStatus
= resp
.arg
[0] & 0xff;
677 uint8_t *data
= resp
.d
.asBytes
;
680 PrintAndLog("No tag found...");
681 ul_switch_off_field();
684 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
685 memcpy(tag_data
, data
, 8*3);
686 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
688 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
689 // large memory - not able to dump pages currently
690 if (numblks
> maxBlk
) numblks
= maxBlk
;
692 ul_switch_off_field();
693 // authenticate debit key and get div_key - later store in dump block 3
694 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
695 //try twice - for some reason it sometimes fails the first time...
696 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
697 ul_switch_off_field();
703 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
704 clearCommandBuffer();
706 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
707 PrintAndLog("Command execute time-out 1");
708 ul_switch_off_field();
711 uint32_t blocksRead
= resp
.arg
[1];
712 uint8_t isOK
= resp
.arg
[0] & 0xff;
713 if (!isOK
&& !blocksRead
) {
714 PrintAndLog("Read Block Failed");
715 ul_switch_off_field();
718 uint32_t startindex
= resp
.arg
[2];
719 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
720 PrintAndLog("Data exceeded Buffer size!");
721 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
723 // response ok - now get bigbuf content of the dump
724 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
725 WaitForResponse(CMD_ACK
,NULL
);
726 size_t gotBytes
= blocksRead
*8 + blockno
*8;
729 if (have_credit_key
) {
730 //turn off hf field before authenticating with different key
731 ul_switch_off_field();
733 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
734 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
735 //try twice - for some reason it sometimes fails the first time...
736 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
737 ul_switch_off_field();
741 // do we still need to read more block? (aa2 enabled?)
742 if (maxBlk
> blockno
+numblks
+1) {
743 // setup dump and start
744 w
.arg
[0] = blockno
+ blocksRead
;
745 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
746 clearCommandBuffer();
748 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
749 PrintAndLog("Command execute timeout 2");
750 ul_switch_off_field();
753 uint8_t isOK
= resp
.arg
[0] & 0xff;
754 blocksRead
= resp
.arg
[1];
755 if (!isOK
&& !blocksRead
) {
756 PrintAndLog("Read Block Failed 2");
757 ul_switch_off_field();
761 startindex
= resp
.arg
[2];
762 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
763 PrintAndLog("Data exceeded Buffer size!");
764 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
766 // get dumped data from bigbuf
767 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
768 WaitForResponse(CMD_ACK
,NULL
);
770 gotBytes
+= blocksRead
*8;
771 } else { //field is still on - turn it off...
772 ul_switch_off_field();
776 // add diversified keys to dump
777 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
778 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
780 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
781 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
782 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
784 if (filename
[0] == 0){
785 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
786 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
787 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
790 // save the dump to .bin file
791 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
792 saveFile(filename
, "bin", tag_data
, gotBytes
);
796 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
797 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
798 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
799 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, verbose
))
804 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
805 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
806 memcpy(w
.d
.asBytes
, bldata
, 8);
807 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
809 clearCommandBuffer();
811 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
813 PrintAndLog("Write Command execute timeout");
816 uint8_t isOK
= resp
.arg
[0] & 0xff;
818 PrintAndLog("Write Block Failed");
821 PrintAndLog("Write Block Successful");
825 int usage_hf_iclass_writeblock(void) {
826 PrintAndLog("Options:");
827 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
828 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
829 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
830 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
831 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
832 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
833 PrintAndLog("Samples:");
834 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
835 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
836 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
840 int CmdHFiClass_WriteBlock(const char *Cmd
) {
842 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
843 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
846 char tempStr
[50] = {0};
847 bool use_credit_key
= false;
852 while(param_getchar(Cmd
, cmdp
) != 0x00)
854 switch(param_getchar(Cmd
, cmdp
))
858 return usage_hf_iclass_writeblock();
861 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
862 PrintAndLog("Block No must include 2 HEX symbols\n");
869 use_credit_key
= true;
874 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
876 PrintAndLog("KEY must include 16 HEX symbols\n");
888 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
890 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
891 } else if (dataLen
== 1) {
892 keyNbr
= param_get8(Cmd
, cmdp
+1);
893 if (keyNbr
< ICLASS_KEYS_MAX
) {
894 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
896 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
900 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
911 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
915 if(errors
) return usage_hf_iclass_writeblock();
918 if (cmdp
< 6) return usage_hf_iclass_writeblock();
919 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, rawkey
, true);
920 ul_switch_off_field();
924 int usage_hf_iclass_clone(void) {
925 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> c e|r");
926 PrintAndLog("Options:");
927 PrintAndLog(" f <filename>: specify a filename to clone from");
928 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
929 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
930 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
931 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
932 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
933 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
934 PrintAndLog("Samples:");
935 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
936 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
937 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
941 int CmdHFiClassCloneTag(const char *Cmd
) {
942 char filename
[FILE_PATH_SIZE
] = {0};
943 char tempStr
[50]={0};
944 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
946 uint8_t fileNameLen
= 0;
947 uint8_t startblock
= 0;
948 uint8_t endblock
= 0;
950 bool use_credit_key
= false;
955 while(param_getchar(Cmd
, cmdp
) != 0x00)
957 switch(param_getchar(Cmd
, cmdp
))
961 return usage_hf_iclass_clone();
964 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
965 PrintAndLog("Start Block No must include 2 HEX symbols\n");
972 use_credit_key
= true;
982 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
983 if (fileNameLen
< 1) {
984 PrintAndLog("No filename found after f");
991 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
993 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
994 } else if (dataLen
== 1) {
995 keyNbr
= param_get8(Cmd
, cmdp
+1);
996 if (keyNbr
< ICLASS_KEYS_MAX
) {
997 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
999 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1003 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1010 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
1011 PrintAndLog("Start Block No must include 2 HEX symbols\n");
1022 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1026 if(errors
) return usage_hf_iclass_clone();
1029 if (cmdp
< 8) return usage_hf_iclass_clone();
1033 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1035 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1036 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1038 // file handling and reading
1039 f
= fopen(filename
,"rb");
1041 PrintAndLog("Failed to read from file '%s'", filename
);
1046 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 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
);
1320 PrintAndLog("Error, when getting filesize");
1325 uint8_t *dump
= malloc(fsize
);
1327 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1329 uint8_t *csn
= dump
;
1330 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]);
1331 // printIclassDumpInfo(dump);
1332 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1338 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1339 uint64_t new_div = 0x00;
1345 uint64_t hexarray_to_uint64(uint8_t *key) {
1348 for (int i = 0;i < 8;i++)
1349 sprintf(&temp[(i *2)],"%02X",key[i]);
1351 if (sscanf(temp,"%016"llx,&uint_key) < 1)
1356 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1357 uint8_t keytable
[128] = {0};
1358 uint8_t key_index
[8] = {0};
1360 uint8_t key_sel
[8] = { 0 };
1361 uint8_t key_sel_p
[8] = { 0 };
1362 hash2(KEY
, keytable
);
1363 hash1(CSN
, key_index
);
1364 for(uint8_t i
= 0; i
< 8 ; i
++)
1365 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1367 //Permute from iclass format to standard format
1368 permutekey_rev(key_sel
, key_sel_p
);
1369 diversifyKey(CSN
, key_sel_p
, div_key
);
1371 diversifyKey(CSN
, KEY
, div_key
);
1375 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1376 //calculate and return xor_div_key (ready for a key write command)
1377 //print all div_keys if verbose
1378 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1379 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1380 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1382 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1384 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1386 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1387 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1390 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1391 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1392 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1396 int usage_hf_iclass_calc_newkey(void) {
1397 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1398 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1399 PrintAndLog(" Options:");
1400 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1401 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1402 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1403 PrintAndLog(" e : specify new key as elite calc");
1404 PrintAndLog(" ee : specify old and new key as elite calc");
1405 PrintAndLog("Samples:");
1406 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1407 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1408 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1409 PrintAndLog("NOTE: * = required\n");
1414 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1415 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1416 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1417 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1418 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1419 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1421 uint8_t dataLen
= 0;
1422 char tempStr
[50] = {0};
1423 bool givenCSN
= false;
1424 bool oldElite
= false;
1426 bool errors
= false;
1428 while(param_getchar(Cmd
, cmdp
) != 0x00)
1430 switch(param_getchar(Cmd
, cmdp
))
1434 return usage_hf_iclass_calc_newkey();
1437 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1445 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1446 if (dataLen
== 16) {
1447 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1448 } else if (dataLen
== 1) {
1449 keyNbr
= param_get8(Cmd
, cmdp
+1);
1450 if (keyNbr
< ICLASS_KEYS_MAX
) {
1451 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1453 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1457 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1464 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1465 if (dataLen
== 16) {
1466 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1467 } else if (dataLen
== 1) {
1468 keyNbr
= param_get8(Cmd
, cmdp
+1);
1469 if (keyNbr
< ICLASS_KEYS_MAX
) {
1470 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1472 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1476 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1484 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1485 return usage_hf_iclass_calc_newkey();
1489 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1493 if(errors
) return usage_hf_iclass_calc_newkey();
1496 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1499 if (!select_only(CSN
, CCNR
, false, true))
1502 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1506 static int loadKeys(char *filename
) {
1508 f
= fopen(filename
,"rb");
1510 PrintAndLog("Failed to read from file '%s'", filename
);
1513 fseek(f
, 0, SEEK_END
);
1514 long fsize
= ftell(f
);
1515 fseek(f
, 0, SEEK_SET
);
1518 PrintAndLog("Error, when getting filesize");
1523 uint8_t *dump
= malloc(fsize
);
1525 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1527 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1528 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1533 for (; i
< bytes_read
/8; i
++){
1534 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1537 PrintAndLog("%u keys loaded", i
);
1541 static int saveKeys(char *filename
) {
1543 f
= fopen(filename
,"wb");
1545 printf("error opening file %s\n",filename
);
1548 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1549 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1550 PrintAndLog("save key failed to write to file: %s", filename
);
1558 static int printKeys(void) {
1560 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1561 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1567 int usage_hf_iclass_managekeys(void) {
1568 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1569 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1570 PrintAndLog(" Options:");
1571 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1572 PrintAndLog(" k <key> : set a key in memory");
1573 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1574 PrintAndLog(" s : save keys in memory to file specified by filename");
1575 PrintAndLog(" l : load keys to memory from file specified by filename");
1576 PrintAndLog(" p : print keys loaded into memory\n");
1577 PrintAndLog("Samples:");
1578 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1579 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1580 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1581 PrintAndLog(" print keys : hf iclass managekeys p\n");
1585 int CmdHFiClassManageKeys(const char *Cmd
) {
1587 uint8_t dataLen
= 0;
1588 uint8_t KEY
[8] = {0};
1589 char filename
[FILE_PATH_SIZE
];
1590 uint8_t fileNameLen
= 0;
1591 bool errors
= false;
1592 uint8_t operation
= 0;
1596 while(param_getchar(Cmd
, cmdp
) != 0x00)
1598 switch(param_getchar(Cmd
, cmdp
))
1602 return usage_hf_iclass_managekeys();
1605 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1606 if (fileNameLen
< 1) {
1607 PrintAndLog("No filename found after f");
1614 keyNbr
= param_get8(Cmd
, cmdp
+1);
1615 if (keyNbr
>= ICLASS_KEYS_MAX
) {
1616 PrintAndLog("Invalid block number");
1623 operation
+= 3; //set key
1624 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1625 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1626 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1628 PrintAndLog("\nERROR: Key is incorrect length\n");
1635 operation
+= 4; //print keys in memory
1640 operation
+= 5; //load keys from file
1645 operation
+= 6; //save keys to file
1649 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1653 if(errors
) return usage_hf_iclass_managekeys();
1655 if (operation
== 0){
1656 PrintAndLog("no operation specified (load, save, or print)\n");
1657 return usage_hf_iclass_managekeys();
1660 PrintAndLog("Too many operations specified\n");
1661 return usage_hf_iclass_managekeys();
1663 if (operation
> 4 && fileNameLen
== 0){
1664 PrintAndLog("You must enter a filename when loading or saving\n");
1665 return usage_hf_iclass_managekeys();
1669 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1670 case 4: return printKeys();
1671 case 5: return loadKeys(filename
);
1672 case 6: return saveKeys(filename
);
1678 static command_t CommandTable
[] =
1680 {"help", CmdHelp
, 1, "This help"},
1681 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1682 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1683 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1684 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1685 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1686 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1687 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1688 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1689 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1690 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1691 {"reader", CmdHFiClassReader
, 0, " Read an iClass tag"},
1692 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1693 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1694 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1695 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1696 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1697 {NULL
, NULL
, 0, NULL
}
1700 int CmdHFiClass(const char *Cmd
)
1702 CmdsParse(CommandTable
, Cmd
);
1706 int CmdHelp(const char *Cmd
)
1708 CmdsHelp(CommandTable
);