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"
37 static int CmdHelp(const char *Cmd
);
39 #define ICLASS_KEYS_MAX 8
40 static uint8_t iClass_Key_Table
[ICLASS_KEYS_MAX
][8] = {
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 },
48 { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }
51 typedef struct iclass_block
{
55 int xorbits_8(uint8_t val
) {
56 uint8_t res
= val
^ (val
>> 1); //1st pass
57 res
= res
^ (res
>> 1); // 2nd pass
58 res
= res
^ (res
>> 2); // 3rd pass
59 res
= res
^ (res
>> 4); // 4th pass
63 int CmdHFiClassList(const char *Cmd
) {
64 //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) {
271 f
= fopen(filename
, "rb");
273 return hf_iclass_eload_usage();
277 PrintAndLog("Failed to read from file '%s'", filename
);
281 fseek(f
, 0, SEEK_END
);
282 long fsize
= ftell(f
);
283 fseek(f
, 0, SEEK_SET
);
286 prnlog("Error, when getting filesize");
291 uint8_t *dump
= malloc(fsize
);
293 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
296 printIclassDumpInfo(dump
);
299 if (bytes_read
< fsize
)
301 prnlog("Error, could only read %d bytes (should be %d)",bytes_read
, fsize
);
306 uint32_t bytes_sent
= 0;
307 uint32_t bytes_remaining
= bytes_read
;
309 while(bytes_remaining
> 0){
310 uint32_t bytes_in_packet
= MIN(USB_CMD_DATA_SIZE
, bytes_remaining
);
311 UsbCommand c
= {CMD_ICLASS_EML_MEMSET
, {bytes_sent
,bytes_in_packet
,0}};
312 memcpy(c
.d
.asBytes
, dump
, bytes_in_packet
);
314 bytes_remaining
-= bytes_in_packet
;
315 bytes_sent
+= bytes_in_packet
;
318 PrintAndLog("Sent %d bytes of data to device emulator memory", bytes_sent
);
322 static int readKeyfile(const char *filename
, size_t len
, uint8_t* buffer
) {
323 FILE *f
= fopen(filename
, "rb");
325 PrintAndLog("Failed to read from file '%s'", filename
);
328 fseek(f
, 0, SEEK_END
);
329 long fsize
= ftell(f
);
330 fseek(f
, 0, SEEK_SET
);
331 size_t bytes_read
= fread(buffer
, 1, len
, f
);
335 PrintAndLog("Warning, file size is %d, expected %d", fsize
, len
);
338 if(bytes_read
!= len
)
340 PrintAndLog("Warning, could only read %d bytes, expected %d" ,bytes_read
, len
);
346 int usage_hf_iclass_decrypt(void) {
347 PrintAndLog("Usage: hf iclass decrypt f <tagdump>");
349 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
350 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
352 PrintAndLog("example: hf iclass decrypt f tagdump_12312342343.bin");
354 PrintAndLog("OBS! This is pretty stupid implementation, it tries to decrypt every block after block 6. ");
355 PrintAndLog("Correct behaviour would be to decrypt only the application areas where the key is valid,");
356 PrintAndLog("which is defined by the configuration block.");
360 int CmdHFiClassDecrypt(const char *Cmd
) {
361 uint8_t key
[16] = { 0 };
362 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
364 usage_hf_iclass_decrypt();
367 PrintAndLog("Decryption file found... ");
368 char opt
= param_getchar(Cmd
, 0);
369 if (strlen(Cmd
)<1 || opt
== 'h')
370 return usage_hf_iclass_decrypt();
372 //Open the tagdump-file
374 char filename
[FILE_PATH_SIZE
];
375 if(opt
== 'f' && param_getstr(Cmd
, 1, filename
) > 0) {
376 if ( (f
= fopen(filename
, "rb")) == NULL
) {
377 PrintAndLog("Could not find file %s", filename
);
382 return usage_hf_iclass_decrypt();
385 fseek(f
, 0, SEEK_END
);
386 long fsize
= ftell(f
);
387 fseek(f
, 0, SEEK_SET
);
388 uint8_t enc_dump
[8] = {0};
389 uint8_t *decrypted
= malloc(fsize
);
390 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
391 des3_set2key_dec( &ctx
, key
);
392 size_t bytes_read
= fread(enc_dump
, 1, 8, f
);
394 //Use the first block (CSN) for filename
395 char outfilename
[FILE_PATH_SIZE
] = { 0 };
396 snprintf(outfilename
,FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x-decrypted",
397 enc_dump
[0],enc_dump
[1],enc_dump
[2],enc_dump
[3],
398 enc_dump
[4],enc_dump
[5],enc_dump
[6],enc_dump
[7]);
401 while(bytes_read
== 8)
405 memcpy(decrypted
+(blocknum
*8), enc_dump
, 8);
407 des3_crypt_ecb(&ctx
, enc_dump
,decrypted
+(blocknum
*8) );
409 printvar("decrypted block", decrypted
+(blocknum
*8), 8);
410 bytes_read
= fread(enc_dump
, 1, 8, f
);
415 saveFile(outfilename
,"bin", decrypted
, blocknum
*8);
421 int usage_hf_iclass_encrypt(void) {
422 PrintAndLog("Usage: hf iclass encrypt <BlockData>");
424 PrintAndLog("OBS! In order to use this function, the file 'iclass_decryptionkey.bin' must reside");
425 PrintAndLog("in the working directory. The file should be 16 bytes binary data");
427 PrintAndLog("example: hf iclass encrypt 0102030405060708");
432 static int iClassEncryptBlkData(uint8_t *blkData
) {
433 uint8_t key
[16] = { 0 };
434 if(readKeyfile("iclass_decryptionkey.bin", 16, key
))
436 usage_hf_iclass_encrypt();
439 PrintAndLog("Decryption file found... ");
441 uint8_t encryptedData
[16];
442 uint8_t *encrypted
= encryptedData
;
443 des3_context ctx
= { DES_DECRYPT
,{ 0 } };
444 des3_set2key_enc( &ctx
, key
);
446 des3_crypt_ecb(&ctx
, blkData
,encrypted
);
447 //printvar("decrypted block", decrypted, 8);
448 memcpy(blkData
,encrypted
,8);
453 int CmdHFiClassEncryptBlk(const char *Cmd
) {
454 uint8_t blkData
[8] = {0};
455 char opt
= param_getchar(Cmd
, 0);
456 if (strlen(Cmd
)<1 || opt
== 'h')
457 return usage_hf_iclass_encrypt();
459 //get the bytes to encrypt
460 if (param_gethex(Cmd
, 0, blkData
, 16))
462 PrintAndLog("BlockData must include 16 HEX symbols");
465 if (!iClassEncryptBlkData(blkData
)) return 0;
467 printvar("encrypted block", blkData
, 8);
471 void Calc_wb_mac(uint8_t blockno
, uint8_t *data
, uint8_t *div_key
, uint8_t MAC
[4]) {
474 memcpy(WB
+ 1,data
,8);
475 doMAC_N(WB
,sizeof(WB
),div_key
,MAC
);
476 //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]);
479 static bool select_only(uint8_t *CSN
, uint8_t *CCNR
, bool use_credit_key
, bool verbose
) {
482 UsbCommand c
= {CMD_READER_ICLASS
, {0}};
483 c
.arg
[0] = FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_CC
| FLAG_ICLASS_READER_ONE_TRY
;
485 c
.arg
[0] |= FLAG_ICLASS_READER_CEDITKEY
;
487 clearCommandBuffer();
489 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
491 PrintAndLog("Command execute timeout");
495 uint8_t isOK
= resp
.arg
[0] & 0xff;
496 uint8_t *data
= resp
.d
.asBytes
;
499 if (CCNR
!=NULL
)memcpy(CCNR
,data
+16,8);
502 if (verbose
) PrintAndLog("CSN: %s",sprint_hex(CSN
,8));
505 PrintAndLog("Failed to obtain CC! Aborting");
511 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
) {
512 uint8_t CSN
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
513 uint8_t CCNR
[12]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
515 if (!select_only(CSN
, CCNR
, use_credit_key
, verbose
))
520 memcpy(div_key
, KEY
, 8);
522 HFiClassCalcDivKey(CSN
, KEY
, div_key
, elite
);
523 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]);
525 doMAC(CCNR
, div_key
, MAC
);
527 UsbCommand d
= {CMD_ICLASS_AUTHENTICATION
, {0}};
528 memcpy(d
.d
.asBytes
, MAC
, 4);
529 clearCommandBuffer();
531 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
533 PrintAndLog("Auth Command execute timeout");
536 uint8_t isOK
= resp
.arg
[0] & 0xff;
538 PrintAndLog("Authentication error");
544 int usage_hf_iclass_dump(void) {
545 PrintAndLog("Usage: hf iclass dump f <fileName> k <Key> c <CreditKey> e|r\n");
546 PrintAndLog("Options:");
547 PrintAndLog(" f <filename> : specify a filename to save dump to");
548 PrintAndLog(" k <Key> : *Access Key as 16 hex symbols or 1 hex to select key from memory");
549 PrintAndLog(" c <CreditKey>: Credit Key as 16 hex symbols or 1 hex to select key from memory");
550 PrintAndLog(" e : If 'e' is specified, the key is interpreted as the 16 byte");
551 PrintAndLog(" Custom Key (KCus), which can be obtained via reader-attack");
552 PrintAndLog(" See 'hf iclass sim 2'. This key should be on iclass-format");
553 PrintAndLog(" r : If 'r' is specified, the key is interpreted as raw block 3/4");
554 PrintAndLog(" NOTE: * = required");
555 PrintAndLog("Samples:");
556 PrintAndLog(" hf iclass dump k 001122334455667B");
557 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA c 001122334455667B");
558 PrintAndLog(" hf iclass dump k AAAAAAAAAAAAAAAA e");
562 int CmdHFiClassReader_Dump(const char *Cmd
) {
564 uint8_t MAC
[4] = {0x00,0x00,0x00,0x00};
565 uint8_t div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
566 uint8_t c_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
570 uint8_t app_areas
= 1;
572 uint8_t KEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
573 uint8_t CreditKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
576 uint8_t fileNameLen
= 0;
577 char filename
[FILE_PATH_SIZE
]={0};
578 char tempStr
[50] = {0};
579 bool have_debit_key
= false;
580 bool have_credit_key
= false;
581 bool use_credit_key
= false;
587 while(param_getchar(Cmd
, cmdp
) != 0x00)
589 switch(param_getchar(Cmd
, cmdp
))
593 return usage_hf_iclass_dump();
596 have_credit_key
= true;
597 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
599 errors
= param_gethex(tempStr
, 0, CreditKEY
, dataLen
);
600 } else if (dataLen
== 1) {
601 keyNbr
= param_get8(Cmd
, cmdp
+1);
602 if (keyNbr
< ICLASS_KEYS_MAX
) {
603 memcpy(CreditKEY
, iClass_Key_Table
[keyNbr
], 8);
605 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
609 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
621 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
622 if (fileNameLen
< 1) {
623 PrintAndLog("No filename found after f");
630 have_debit_key
= true;
631 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
633 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
634 } else if (dataLen
== 1) {
635 keyNbr
= param_get8(Cmd
, cmdp
+1);
636 if (keyNbr
< ICLASS_KEYS_MAX
) {
637 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
639 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
643 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
654 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
658 if(errors
) return usage_hf_iclass_dump();
661 if (cmdp
< 2) return usage_hf_iclass_dump();
662 // if no debit key given try credit key on AA1 (not for iclass but for some picopass this will work)
663 if (!have_debit_key
&& have_credit_key
) use_credit_key
= true;
665 //get config and first 3 blocks
666 UsbCommand c
= {CMD_READER_ICLASS
, {FLAG_ICLASS_READER_CSN
|
667 FLAG_ICLASS_READER_CONF
| FLAG_ICLASS_READER_ONLY_ONCE
| FLAG_ICLASS_READER_ONE_TRY
}};
669 uint8_t tag_data
[255*8];
671 clearCommandBuffer();
673 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
674 PrintAndLog("Command execute timeout");
675 ul_switch_off_field();
678 uint8_t readStatus
= resp
.arg
[0] & 0xff;
679 uint8_t * data
= resp
.d
.asBytes
;
682 PrintAndLog("No tag found...");
683 ul_switch_off_field();
686 if( readStatus
& (FLAG_ICLASS_READER_CSN
|FLAG_ICLASS_READER_CONF
|FLAG_ICLASS_READER_CC
)){
687 memcpy(tag_data
, data
, 8*3);
688 blockno
+=2; // 2 to force re-read of block 2 later. (seems to respond differently..)
690 getMemConfig(data
[13], data
[12], &maxBlk
, &app_areas
, &kb
);
691 // large memory - not able to dump pages currently
692 if (numblks
> maxBlk
) numblks
= maxBlk
;
694 ul_switch_off_field();
695 // authenticate debit key and get div_key - later store in dump block 3
696 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
697 //try twice - for some reason it sometimes fails the first time...
698 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, false)){
699 ul_switch_off_field();
705 UsbCommand w
= {CMD_ICLASS_DUMP
, {blockno
, numblks
-blockno
+1}};
706 clearCommandBuffer();
708 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
709 PrintAndLog("Command execute time-out 1");
710 ul_switch_off_field();
713 uint32_t blocksRead
= resp
.arg
[1];
714 uint8_t isOK
= resp
.arg
[0] & 0xff;
715 if (!isOK
&& !blocksRead
) {
716 PrintAndLog("Read Block Failed");
717 ul_switch_off_field();
720 uint32_t startindex
= resp
.arg
[2];
721 if (blocksRead
*8 > sizeof(tag_data
)-(blockno
*8)) {
722 PrintAndLog("Data exceeded Buffer size!");
723 blocksRead
= (sizeof(tag_data
)/8) - blockno
;
725 // response ok - now get bigbuf content of the dump
726 GetFromBigBuf(tag_data
+(blockno
*8), blocksRead
*8, startindex
);
727 WaitForResponse(CMD_ACK
,NULL
);
728 size_t gotBytes
= blocksRead
*8 + blockno
*8;
731 if (have_credit_key
) {
732 //turn off hf field before authenticating with different key
733 ul_switch_off_field();
735 // AA2 authenticate credit key and git c_div_key - later store in dump block 4
736 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
737 //try twice - for some reason it sometimes fails the first time...
738 if (!select_and_auth(CreditKEY
, MAC
, c_div_key
, true, false, false, false)){
739 ul_switch_off_field();
743 // do we still need to read more block? (aa2 enabled?)
744 if (maxBlk
> blockno
+numblks
+1) {
745 // setup dump and start
746 w
.arg
[0] = blockno
+ blocksRead
;
747 w
.arg
[1] = maxBlk
- (blockno
+ blocksRead
);
748 clearCommandBuffer();
750 if (!WaitForResponseTimeout(CMD_ACK
, &resp
, 4500)) {
751 PrintAndLog("Command execute timeout 2");
752 ul_switch_off_field();
755 uint8_t isOK
= resp
.arg
[0] & 0xff;
756 blocksRead
= resp
.arg
[1];
757 if (!isOK
&& !blocksRead
) {
758 PrintAndLog("Read Block Failed 2");
759 ul_switch_off_field();
763 startindex
= resp
.arg
[2];
764 if (blocksRead
*8 > sizeof(tag_data
)-gotBytes
) {
765 PrintAndLog("Data exceeded Buffer size!");
766 blocksRead
= (sizeof(tag_data
) - gotBytes
)/8;
768 // get dumped data from bigbuf
769 GetFromBigBuf(tag_data
+gotBytes
, blocksRead
*8, startindex
);
770 WaitForResponse(CMD_ACK
,NULL
);
772 gotBytes
+= blocksRead
*8;
773 } else { //field is still on - turn it off...
774 ul_switch_off_field();
778 // add diversified keys to dump
779 if (have_debit_key
) memcpy(tag_data
+(3*8),div_key
,8);
780 if (have_credit_key
) memcpy(tag_data
+(4*8),c_div_key
,8);
782 printf("CSN |00| %02X %02X %02X %02X %02X %02X %02X %02X |\n",tag_data
[0],tag_data
[1],tag_data
[2]
783 ,tag_data
[3],tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
784 printIclassDumpContents(tag_data
, 1, (gotBytes
/8)-1, gotBytes
-8);
786 if (filename
[0] == 0){
787 snprintf(filename
, FILE_PATH_SIZE
,"iclass_tagdump-%02x%02x%02x%02x%02x%02x%02x%02x",
788 tag_data
[0],tag_data
[1],tag_data
[2],tag_data
[3],
789 tag_data
[4],tag_data
[5],tag_data
[6],tag_data
[7]);
792 // save the dump to .bin file
793 PrintAndLog("Saving dump file - %d blocks read", gotBytes
/8);
794 saveFile(filename
, "bin", tag_data
, gotBytes
);
798 static int WriteBlock(uint8_t blockno
, uint8_t *bldata
, uint8_t *KEY
, bool use_credit_key
, bool elite
, bool rawkey
, bool verbose
) {
799 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
800 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
801 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, verbose
))
806 Calc_wb_mac(blockno
,bldata
,div_key
,MAC
);
807 UsbCommand w
= {CMD_ICLASS_WRITEBLOCK
, {blockno
}};
808 memcpy(w
.d
.asBytes
, bldata
, 8);
809 memcpy(w
.d
.asBytes
+ 8, MAC
, 4);
811 clearCommandBuffer();
813 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
815 PrintAndLog("Write Command execute timeout");
818 uint8_t isOK
= resp
.arg
[0] & 0xff;
820 PrintAndLog("Write Block Failed");
823 PrintAndLog("Write Block Successful");
827 int usage_hf_iclass_writeblock(void) {
828 PrintAndLog("Options:");
829 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
830 PrintAndLog(" d <data> : Set the Data to write as 16 hex symbols");
831 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
832 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
833 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
834 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
835 PrintAndLog("Samples:");
836 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA k 001122334455667B");
837 PrintAndLog(" hf iclass writeblk b 1B d AAAAAAAAAAAAAAAA k 001122334455667B c");
838 PrintAndLog(" hf iclass writeblk b 0A d AAAAAAAAAAAAAAAA n 0");
842 int CmdHFiClass_WriteBlock(const char *Cmd
) {
844 uint8_t bldata
[8]={0,0,0,0,0,0,0,0};
845 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
848 char tempStr
[50] = {0};
849 bool use_credit_key
= false;
854 while(param_getchar(Cmd
, cmdp
) != 0x00)
856 switch(param_getchar(Cmd
, cmdp
))
860 return usage_hf_iclass_writeblock();
863 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
864 PrintAndLog("Block No must include 2 HEX symbols\n");
871 use_credit_key
= true;
876 if (param_gethex(Cmd
, cmdp
+1, bldata
, 16))
878 PrintAndLog("KEY must include 16 HEX symbols\n");
890 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
892 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
893 } else if (dataLen
== 1) {
894 keyNbr
= param_get8(Cmd
, cmdp
+1);
895 if (keyNbr
< ICLASS_KEYS_MAX
) {
896 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
898 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
902 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
913 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
917 if(errors
) return usage_hf_iclass_writeblock();
920 if (cmdp
< 6) return usage_hf_iclass_writeblock();
921 int ans
= WriteBlock(blockno
, bldata
, KEY
, use_credit_key
, elite
, rawkey
, true);
922 ul_switch_off_field();
926 int usage_hf_iclass_clone(void) {
927 PrintAndLog("Usage: hf iclass clone f <tagfile.bin> b <first block> l <last block> k <KEY> c e|r");
928 PrintAndLog("Options:");
929 PrintAndLog(" f <filename>: specify a filename to clone from");
930 PrintAndLog(" b <Block> : The first block to clone as 2 hex symbols");
931 PrintAndLog(" l <Last Blk>: Set the Data to write as 16 hex symbols");
932 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
933 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
934 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
935 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
936 PrintAndLog("Samples:");
937 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 1A k 1122334455667788 e");
938 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 05 l 19 k 0");
939 PrintAndLog(" hf iclass clone f iclass_tagdump-121345.bin b 06 l 19 k 0 e");
943 int CmdHFiClassCloneTag(const char *Cmd
) {
944 char filename
[FILE_PATH_SIZE
] = { 0x00 };
945 char tempStr
[50]={0};
946 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
948 uint8_t fileNameLen
= 0;
949 uint8_t startblock
= 0;
950 uint8_t endblock
= 0;
952 bool use_credit_key
= false;
957 while(param_getchar(Cmd
, cmdp
) != 0x00)
959 switch(param_getchar(Cmd
, cmdp
))
963 return usage_hf_iclass_clone();
966 if (param_gethex(Cmd
, cmdp
+1, &startblock
, 2)) {
967 PrintAndLog("Start Block No must include 2 HEX symbols\n");
974 use_credit_key
= true;
984 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
985 if (fileNameLen
< 1) {
986 PrintAndLog("No filename found after f");
993 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
995 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
996 } else if (dataLen
== 1) {
997 keyNbr
= param_get8(Cmd
, cmdp
+1);
998 if (keyNbr
< ICLASS_KEYS_MAX
) {
999 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1001 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1005 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1012 if (param_gethex(Cmd
, cmdp
+1, &endblock
, 2)) {
1013 PrintAndLog("Start Block No must include 2 HEX symbols\n");
1024 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1028 if(errors
) return usage_hf_iclass_clone();
1031 if (cmdp
< 8) return usage_hf_iclass_clone();
1035 iclass_block_t tag_data
[USB_CMD_DATA_SIZE
/12];
1037 if ((endblock
-startblock
+1)*12 > USB_CMD_DATA_SIZE
) {
1038 PrintAndLog("Trying to write too many blocks at once. Max: %d", USB_CMD_DATA_SIZE
/8);
1040 // file handling and reading
1041 f
= fopen(filename
,"rb");
1043 PrintAndLog("Failed to read from file '%s'", filename
);
1048 PrintAndLog("You cannot write key blocks this way. yet... make your start block > 4");
1052 // now read data from the file from block 6 --- 19
1053 // ok we will use this struct [data 8 bytes][MAC 4 bytes] for each block calculate all mac number for each data
1054 // 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,
1055 // else we have to create a share memory
1057 fseek(f
,startblock
*8,SEEK_SET
);
1058 if ( fread(tag_data
,sizeof(iclass_block_t
),endblock
- startblock
+ 1,f
) == 0){
1059 PrintAndLog("File reading error.");
1064 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1065 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1067 if (!select_and_auth(KEY
, MAC
, div_key
, use_credit_key
, elite
, rawkey
, true))
1070 UsbCommand w
= {CMD_ICLASS_CLONE
,{startblock
,endblock
}};
1072 // calculate all mac for every the block we will write
1073 for (i
= startblock
; i
<= endblock
; i
++){
1074 Calc_wb_mac(i
,tag_data
[i
- startblock
].d
,div_key
,MAC
);
1075 // usb command d start pointer = d + (i - 6) * 12
1076 // memcpy(pointer,tag_data[i - 6],8) 8 bytes
1077 // memcpy(pointer + 8,mac,sizoof(mac) 4 bytes;
1079 ptr
= w
.d
.asBytes
+ (i
- startblock
) * 12;
1080 memcpy(ptr
, &(tag_data
[i
- startblock
].d
[0]), 8);
1081 memcpy(ptr
+ 8,MAC
, 4);
1084 for (i
= 0; i
<= endblock
- startblock
;i
++){
1085 memcpy(p
,w
.d
.asBytes
+ (i
* 12),12);
1086 printf("Block |%02x|",i
+ startblock
);
1087 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]);
1088 printf(" MAC |%02x%02x%02x%02x|\n",p
[8],p
[9],p
[10],p
[11]);
1092 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1094 PrintAndLog("Command execute timeout");
1100 static int ReadBlock(uint8_t *KEY
, uint8_t blockno
, uint8_t keyType
, bool elite
, bool rawkey
, bool verbose
) {
1101 uint8_t MAC
[4]={0x00,0x00,0x00,0x00};
1102 uint8_t div_key
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1104 if (!select_and_auth(KEY
, MAC
, div_key
, (keyType
==0x18), elite
, rawkey
, verbose
))
1108 UsbCommand w
= {CMD_ICLASS_READBLOCK
, {blockno
}};
1109 clearCommandBuffer();
1111 if (!WaitForResponseTimeout(CMD_ACK
,&resp
,4500))
1113 PrintAndLog("Command execute timeout");
1116 uint8_t isOK
= resp
.arg
[0] & 0xff;
1118 PrintAndLog("Read Block Failed");
1121 //data read is stored in: resp.d.asBytes[0-15]
1122 if (verbose
) PrintAndLog("Block %02X: %s\n",blockno
, sprint_hex(resp
.d
.asBytes
,8));
1126 int usage_hf_iclass_readblock(void) {
1127 PrintAndLog("Usage: hf iclass readblk b <Block> k <Key> c e|r\n");
1128 PrintAndLog("Options:");
1129 PrintAndLog(" b <Block> : The block number as 2 hex symbols");
1130 PrintAndLog(" k <Key> : Access Key as 16 hex symbols or 1 hex to select key from memory");
1131 PrintAndLog(" c : If 'c' is specified, the key set is assumed to be the credit key\n");
1132 PrintAndLog(" e : If 'e' is specified, elite computations applied to key");
1133 PrintAndLog(" r : If 'r' is specified, no computations applied to key");
1134 PrintAndLog("Samples:");
1135 PrintAndLog(" hf iclass readblk b 06 k 0011223344556677");
1136 PrintAndLog(" hf iclass readblk b 1B k 0011223344556677 c");
1137 PrintAndLog(" hf iclass readblk b 0A k 0");
1141 int CmdHFiClass_ReadBlock(const char *Cmd
) {
1143 uint8_t keyType
= 0x88; //debit key
1144 uint8_t KEY
[8]={0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1146 uint8_t dataLen
= 0;
1147 char tempStr
[50] = {0};
1149 bool rawkey
= false;
1150 bool errors
= false;
1152 while(param_getchar(Cmd
, cmdp
) != 0x00)
1154 switch(param_getchar(Cmd
, cmdp
))
1158 return usage_hf_iclass_readblock();
1161 if (param_gethex(Cmd
, cmdp
+1, &blockno
, 2)) {
1162 PrintAndLog("Block No must include 2 HEX symbols\n");
1179 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1180 if (dataLen
== 16) {
1181 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1182 } else if (dataLen
== 1) {
1183 keyNbr
= param_get8(Cmd
, cmdp
+1);
1184 if (keyNbr
< ICLASS_KEYS_MAX
) {
1185 memcpy(KEY
, iClass_Key_Table
[keyNbr
], 8);
1187 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1191 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1202 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1206 if(errors
) return usage_hf_iclass_readblock();
1209 if (cmdp
< 4) return usage_hf_iclass_readblock();
1211 return ReadBlock(KEY
, blockno
, keyType
, elite
, rawkey
, true);
1214 int CmdHFiClass_loclass(const char *Cmd
) {
1215 char opt
= param_getchar(Cmd
, 0);
1217 if (strlen(Cmd
)<1 || opt
== 'h') {
1218 PrintAndLog("Usage: hf iclass loclass [options]");
1219 PrintAndLog("Options:");
1220 PrintAndLog("h Show this help");
1221 PrintAndLog("t Perform self-test");
1222 PrintAndLog("f <filename> Bruteforce iclass dumpfile");
1223 PrintAndLog(" An iclass dumpfile is assumed to consist of an arbitrary number of");
1224 PrintAndLog(" malicious CSNs, and their protocol responses");
1225 PrintAndLog(" The the binary format of the file is expected to be as follows: ");
1226 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1227 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1228 PrintAndLog(" <8 byte CSN><8 byte CC><4 byte NR><4 byte MAC>");
1229 PrintAndLog(" ... totalling N*24 bytes");
1232 char fileName
[255] = {0};
1235 if(param_getstr(Cmd
, 1, fileName
) > 0)
1237 return bruteforceFileNoKeys(fileName
);
1240 PrintAndLog("You must specify a filename");
1245 int errors
= testCipherUtils();
1246 errors
+= testMAC();
1247 errors
+= doKeyTests(0);
1248 errors
+= testElite();
1251 prnlog("OBS! There were errors!!!");
1259 void printIclassDumpContents(uint8_t *iclass_dump
, uint8_t startblock
, uint8_t endblock
, size_t filesize
) {
1260 uint8_t blockdata
[8];
1262 memcpy(&mem_config
, iclass_dump
+ 13,1);
1263 uint8_t maxmemcount
;
1264 uint8_t filemaxblock
= filesize
/ 8;
1265 if (mem_config
& 0x80)
1269 //PrintAndLog ("endblock: %d, filesize: %d, maxmemcount: %d, filemaxblock: %d", endblock,filesize, maxmemcount, filemaxblock);
1271 if (startblock
== 0)
1273 if ((endblock
> maxmemcount
) || (endblock
== 0))
1274 endblock
= maxmemcount
;
1275 if (endblock
> filemaxblock
)
1276 endblock
= filemaxblock
;
1279 while (i
<= endblock
){
1280 printf("Block |%02X| ",i
);
1281 memcpy(blockdata
,iclass_dump
+ (i
* 8),8);
1282 for (j
= 0;j
< 8;j
++)
1283 printf("%02X ",blockdata
[j
]);
1289 int usage_hf_iclass_readtagfile() {
1290 PrintAndLog("Usage: hf iclass readtagfile <filename> [startblock] [endblock]");
1294 int CmdHFiClassReadTagFile(const char *Cmd
) {
1299 char filename
[FILE_PATH_SIZE
];
1300 if (param_getstr(Cmd
, 0, filename
) < 1)
1301 return usage_hf_iclass_readtagfile();
1302 if (param_getstr(Cmd
,1,(char *)&tempnum
) < 1)
1305 sscanf(tempnum
,"%d",&startblock
);
1307 if (param_getstr(Cmd
,2,(char *)&tempnum
) < 1)
1310 sscanf(tempnum
,"%d",&endblock
);
1311 // file handling and reading
1312 f
= fopen(filename
,"rb");
1314 PrintAndLog("Failed to read from file '%s'", filename
);
1317 fseek(f
, 0, SEEK_END
);
1318 long fsize
= ftell(f
);
1319 fseek(f
, 0, SEEK_SET
);
1322 PrintAndLog("Error, when getting filesize");
1327 uint8_t *dump
= malloc(fsize
);
1329 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1331 uint8_t *csn
= dump
;
1332 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]);
1333 // printIclassDumpInfo(dump);
1334 printIclassDumpContents(dump
,startblock
,endblock
,bytes_read
);
1340 uint64_t xorcheck(uint64_t sdiv,uint64_t hdiv) {
1341 uint64_t new_div = 0x00;
1347 uint64_t hexarray_to_uint64(uint8_t *key) {
1350 for (int i = 0;i < 8;i++)
1351 sprintf(&temp[(i *2)],"%02X",key[i]);
1353 if (sscanf(temp,"%016"llX,&uint_key) < 1)
1358 void HFiClassCalcDivKey(uint8_t *CSN
, uint8_t *KEY
, uint8_t *div_key
, bool elite
){
1359 uint8_t keytable
[128] = {0};
1360 uint8_t key_index
[8] = {0};
1362 uint8_t key_sel
[8] = { 0 };
1363 uint8_t key_sel_p
[8] = { 0 };
1364 hash2(KEY
, keytable
);
1365 hash1(CSN
, key_index
);
1366 for(uint8_t i
= 0; i
< 8 ; i
++)
1367 key_sel
[i
] = keytable
[key_index
[i
]] & 0xFF;
1369 //Permute from iclass format to standard format
1370 permutekey_rev(key_sel
, key_sel_p
);
1371 diversifyKey(CSN
, key_sel_p
, div_key
);
1373 diversifyKey(CSN
, KEY
, div_key
);
1377 //when told CSN, oldkey, newkey, if new key is elite (elite), and if old key was elite (oldElite)
1378 //calculate and return xor_div_key (ready for a key write command)
1379 //print all div_keys if verbose
1380 static void HFiClassCalcNewKey(uint8_t *CSN
, uint8_t *OLDKEY
, uint8_t *NEWKEY
, uint8_t *xor_div_key
, bool elite
, bool oldElite
, bool verbose
){
1381 uint8_t old_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1382 uint8_t new_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1384 HFiClassCalcDivKey(CSN
, OLDKEY
, old_div_key
, oldElite
);
1386 HFiClassCalcDivKey(CSN
, NEWKEY
, new_div_key
, elite
);
1388 for (uint8_t i
= 0; i
< sizeof(old_div_key
); i
++){
1389 xor_div_key
[i
] = old_div_key
[i
] ^ new_div_key
[i
];
1392 printf("Old Div Key : %s\n",sprint_hex(old_div_key
,8));
1393 printf("New Div Key : %s\n",sprint_hex(new_div_key
,8));
1394 printf("Xor Div Key : %s\n",sprint_hex(xor_div_key
,8));
1398 int usage_hf_iclass_calc_newkey(void) {
1399 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1400 PrintAndLog("Usage: hf iclass calc_newkey o <Old key> n <New key> s [csn] e");
1401 PrintAndLog(" Options:");
1402 PrintAndLog(" o <oldkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1403 PrintAndLog(" n <newkey> : *specify a key as 16 hex symbols or a key number as 1 symbol");
1404 PrintAndLog(" s <csn> : specify a card Serial number to diversify the key (if omitted will attempt to read a csn)");
1405 PrintAndLog(" e : specify new key as elite calc");
1406 PrintAndLog(" ee : specify old and new key as elite calc");
1407 PrintAndLog("Samples:");
1408 PrintAndLog(" e key to e key given csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899 s deadbeafdeadbeaf ee");
1409 PrintAndLog(" std key to e key read csn: hf iclass calcnewkey o 1122334455667788 n 2233445566778899 e");
1410 PrintAndLog(" std to std read csn : hf iclass calcnewkey o 1122334455667788 n 2233445566778899");
1411 PrintAndLog("NOTE: * = required\n");
1416 int CmdHFiClassCalcNewKey(const char *Cmd
) {
1417 uint8_t OLDKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1418 uint8_t NEWKEY
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1419 uint8_t xor_div_key
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1420 uint8_t CSN
[8] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1421 uint8_t CCNR
[12] = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00};
1423 uint8_t dataLen
= 0;
1424 char tempStr
[50] = {0};
1425 bool givenCSN
= false;
1426 bool oldElite
= false;
1428 bool errors
= false;
1430 while(param_getchar(Cmd
, cmdp
) != 0x00)
1432 switch(param_getchar(Cmd
, cmdp
))
1436 return usage_hf_iclass_calc_newkey();
1439 dataLen
= param_getstr(Cmd
, cmdp
, tempStr
);
1447 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1448 if (dataLen
== 16) {
1449 errors
= param_gethex(tempStr
, 0, NEWKEY
, dataLen
);
1450 } else if (dataLen
== 1) {
1451 keyNbr
= param_get8(Cmd
, cmdp
+1);
1452 if (keyNbr
< ICLASS_KEYS_MAX
) {
1453 memcpy(NEWKEY
, iClass_Key_Table
[keyNbr
], 8);
1455 PrintAndLog("\nERROR: NewKey Nbr is invalid\n");
1459 PrintAndLog("\nERROR: NewKey is incorrect length\n");
1466 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1467 if (dataLen
== 16) {
1468 errors
= param_gethex(tempStr
, 0, OLDKEY
, dataLen
);
1469 } else if (dataLen
== 1) {
1470 keyNbr
= param_get8(Cmd
, cmdp
+1);
1471 if (keyNbr
< ICLASS_KEYS_MAX
) {
1472 memcpy(OLDKEY
, iClass_Key_Table
[keyNbr
], 8);
1474 PrintAndLog("\nERROR: Credit KeyNbr is invalid\n");
1478 PrintAndLog("\nERROR: Credit Key is incorrect length\n");
1486 if (param_gethex(Cmd
, cmdp
+1, CSN
, 16))
1487 return usage_hf_iclass_calc_newkey();
1491 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1495 if(errors
) return usage_hf_iclass_calc_newkey();
1498 if (cmdp
< 4) return usage_hf_iclass_calc_newkey();
1501 if (!select_only(CSN
, CCNR
, false, true))
1504 HFiClassCalcNewKey(CSN
, OLDKEY
, NEWKEY
, xor_div_key
, elite
, oldElite
, true);
1508 static int loadKeys(char *filename
) {
1510 f
= fopen(filename
,"rb");
1512 PrintAndLog("Failed to read from file '%s'", filename
);
1515 fseek(f
, 0, SEEK_END
);
1516 long fsize
= ftell(f
);
1517 fseek(f
, 0, SEEK_SET
);
1520 PrintAndLog("Error, when getting filesize");
1525 uint8_t *dump
= malloc(fsize
);
1527 size_t bytes_read
= fread(dump
, 1, fsize
, f
);
1529 if (bytes_read
> ICLASS_KEYS_MAX
* 8){
1530 PrintAndLog("File is too long to load - bytes: %u", bytes_read
);
1535 for (; i
< bytes_read
/8; i
++){
1536 memcpy(iClass_Key_Table
[i
],dump
+(i
*8),8);
1539 PrintAndLog("%u keys loaded", i
);
1543 static int saveKeys(char *filename
) {
1545 f
= fopen(filename
,"wb");
1547 printf("error opening file %s\n",filename
);
1550 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1551 if (fwrite(iClass_Key_Table
[i
],8,1,f
) != 1){
1552 PrintAndLog("save key failed to write to file: %s", filename
);
1560 static int printKeys(void) {
1562 for (uint8_t i
= 0; i
< ICLASS_KEYS_MAX
; i
++){
1563 PrintAndLog("%u: %s",i
,sprint_hex(iClass_Key_Table
[i
],8));
1569 int usage_hf_iclass_managekeys(void) {
1570 PrintAndLog("HELP : Manage iClass Keys in client memory:\n");
1571 PrintAndLog("Usage: hf iclass managekeys n [keynbr] k [key] f [filename] s l p\n");
1572 PrintAndLog(" Options:");
1573 PrintAndLog(" n <keynbr> : specify the keyNbr to set in memory");
1574 PrintAndLog(" k <key> : set a key in memory");
1575 PrintAndLog(" f <filename>: specify a filename to use with load or save operations");
1576 PrintAndLog(" s : save keys in memory to file specified by filename");
1577 PrintAndLog(" l : load keys to memory from file specified by filename");
1578 PrintAndLog(" p : print keys loaded into memory\n");
1579 PrintAndLog("Samples:");
1580 PrintAndLog(" set key : hf iclass managekeys n 0 k 1122334455667788");
1581 PrintAndLog(" save key file: hf iclass managekeys f mykeys.bin s");
1582 PrintAndLog(" load key file: hf iclass managekeys f mykeys.bin l");
1583 PrintAndLog(" print keys : hf iclass managekeys p\n");
1587 int CmdHFiClassManageKeys(const char *Cmd
) {
1589 uint8_t dataLen
= 0;
1590 uint8_t KEY
[8] = {0};
1591 char filename
[FILE_PATH_SIZE
];
1592 uint8_t fileNameLen
= 0;
1593 bool errors
= false;
1594 uint8_t operation
= 0;
1598 while(param_getchar(Cmd
, cmdp
) != 0x00)
1600 switch(param_getchar(Cmd
, cmdp
))
1604 return usage_hf_iclass_managekeys();
1607 fileNameLen
= param_getstr(Cmd
, cmdp
+1, filename
);
1608 if (fileNameLen
< 1) {
1609 PrintAndLog("No filename found after f");
1616 keyNbr
= param_get8(Cmd
, cmdp
+1);
1618 PrintAndLog("Wrong block number");
1625 operation
+= 3; //set key
1626 dataLen
= param_getstr(Cmd
, cmdp
+1, tempStr
);
1627 if (dataLen
== 16) { //ul-c or ev1/ntag key length
1628 errors
= param_gethex(tempStr
, 0, KEY
, dataLen
);
1630 PrintAndLog("\nERROR: Key is incorrect length\n");
1637 operation
+= 4; //print keys in memory
1642 operation
+= 5; //load keys from file
1647 operation
+= 6; //save keys to file
1651 PrintAndLog("Unknown parameter '%c'\n", param_getchar(Cmd
, cmdp
));
1655 if(errors
) return usage_hf_iclass_managekeys();
1657 if (operation
== 0){
1658 PrintAndLog("no operation specified (load, save, or print)\n");
1659 return usage_hf_iclass_managekeys();
1662 PrintAndLog("Too many operations specified\n");
1663 return usage_hf_iclass_managekeys();
1665 if (operation
> 4 && fileNameLen
== 0){
1666 PrintAndLog("You must enter a filename when loading or saving\n");
1667 return usage_hf_iclass_managekeys();
1671 case 3: memcpy(iClass_Key_Table
[keyNbr
], KEY
, 8); return 1;
1672 case 4: return printKeys();
1673 case 5: return loadKeys(filename
);
1674 case 6: return saveKeys(filename
);
1680 static command_t CommandTable
[] =
1682 {"help", CmdHelp
, 1, "This help"},
1683 {"calcnewkey", CmdHFiClassCalcNewKey
, 1, "[options..] Calc Diversified keys (blocks 3 & 4) to write new keys"},
1684 {"clone", CmdHFiClassCloneTag
, 0, "[options..] Authenticate and Clone from iClass bin file"},
1685 {"decrypt", CmdHFiClassDecrypt
, 1, "[f <fname>] Decrypt tagdump" },
1686 {"dump", CmdHFiClassReader_Dump
, 0, "[options..] Authenticate and Dump iClass tag's AA1"},
1687 {"eload", CmdHFiClassELoad
, 0, "[f <fname>] (experimental) Load data into iClass emulator memory"},
1688 {"encryptblk", CmdHFiClassEncryptBlk
, 1, "<BlockData> Encrypt given block data"},
1689 {"list", CmdHFiClassList
, 0, " (Deprecated) List iClass history"},
1690 {"loclass", CmdHFiClass_loclass
, 1, "[options..] Use loclass to perform bruteforce of reader attack dump"},
1691 {"managekeys", CmdHFiClassManageKeys
, 1, "[options..] Manage the keys to use with iClass"},
1692 {"readblk", CmdHFiClass_ReadBlock
, 0, "[options..] Authenticate and Read iClass block"},
1693 {"reader",CmdHFiClassReader
, 0, "Read an iClass tag"},
1694 {"readtagfile", CmdHFiClassReadTagFile
, 1, "[options..] Display Content from tagfile"},
1695 {"replay", CmdHFiClassReader_Replay
, 0, "<mac> Read an iClass tag via Reply Attack"},
1696 {"sim", CmdHFiClassSim
, 0, "[options..] Simulate iClass tag"},
1697 {"snoop", CmdHFiClassSnoop
, 0, " Eavesdrop iClass communication"},
1698 {"writeblk", CmdHFiClass_WriteBlock
, 0, "[options..] Authenticate and Write iClass block"},
1699 {NULL
, NULL
, 0, NULL
}
1702 int CmdHFiClass(const char *Cmd
)
1704 CmdsParse(CommandTable
, Cmd
);
1708 int CmdHelp(const char *Cmd
)
1710 CmdsHelp(CommandTable
);