projects / proxmark3-svn / blob
? search:


80b4c29da8e8821438acf8a3d7fc42225e9b86f7
[proxmark3-svn] / client / emv / emv_tags.c
1 /*
2 * libopenemv - a library to work with EMV family of smart cards
3 * Copyright (C) 2015 Dmitry Eremin-Solenikov
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
9 *
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
14 */
15
16 #ifdef HAVE_CONFIG_H
17 #include <config.h>
18 #endif
19
20 #include "tlv.h"
21 #include "emv_tags.h"
22
23 #include <stdlib.h>
24 #include <string.h>
25
26 #define PRINT_INDENT(level) {for (int i = 0; i < (level); i++) fprintf(f, "\t");}
27
28 enum emv_tag_t {
29 EMV_TAG_GENERIC,
30 EMV_TAG_BITMASK,
31 EMV_TAG_DOL,
32 EMV_TAG_CVM_LIST,
33 EMV_TAG_AFL,
34 EMV_TAG_STRING,
35 EMV_TAG_NUMERIC,
36 EMV_TAG_YYMMDD,
37 EMV_TAG_CVR,
38 EMV_TAG_CID,
39 };
40
41 struct emv_tag {
42 tlv_tag_t tag;
43 char *name;
44 enum emv_tag_t type;
45 const void *data;
46 };
47
48 struct emv_tag_bit {
49 unsigned bit;
50 const char *name;
51 };
52
53 #define EMV_BIT(byte, bit) ((byte - 1) * 8 + (8 - bit))
54 #define EMV_BIT_FINISH { (~0), NULL }
55
56 static const struct emv_tag_bit EMV_AIP[] = {
57 { EMV_BIT(1, 7), "SDA supported" },
58 { EMV_BIT(1, 6), "DDA supported" },
59 { EMV_BIT(1, 5), "Cardholder verification is supported" },
60 { EMV_BIT(1, 4), "Terminal risk management is to be performed" },
61 { EMV_BIT(1, 3), "Issuer authentication is supported" },
62 { EMV_BIT(1, 2), "Reserved for use by the EMV Contactless Specifications" },
63 { EMV_BIT(1, 1), "CDA supported (Combined Dynamic Data Authentication / Application Cryptogram Generation)" },
64 { EMV_BIT(2, 8), "MSD is supported (Magnetic Stripe Data)" },
65 { EMV_BIT(2, 7), "Reserved for use by the EMV Contactless Specifications" },
66 { EMV_BIT(2, 6), "Reserved for use by the EMV Contactless Specifications" },
67 { EMV_BIT(2, 1), "Reserved for use by the EMV Contactless Specifications" },
68 EMV_BIT_FINISH,
69 };
70
71 static const struct emv_tag_bit EMV_AUC[] = {
72 { EMV_BIT(1, 8), "Valid for domestic cash transactions" },
73 { EMV_BIT(1, 7), "Valid for international cash transactions" },
74 { EMV_BIT(1, 6), "Valid for domestic goods" },
75 { EMV_BIT(1, 5), "Valid for international goods" },
76 { EMV_BIT(1, 4), "Valid for domestic services" },
77 { EMV_BIT(1, 3), "Valid for international services" },
78 { EMV_BIT(1, 2), "Valid for ATMs" },
79 { EMV_BIT(1, 1), "Valid at terminals other than ATMs" },
80 { EMV_BIT(2, 8), "Domestic cashback allowed" },
81 { EMV_BIT(2, 7), "International cashback allowed" },
82 EMV_BIT_FINISH,
83 };
84
85 static const struct emv_tag_bit EMV_TVR[] = {
86 { EMV_BIT(1, 8), "Offline data authentication was not performed" },
87 { EMV_BIT(1, 7), "SDA failed" },
88 { EMV_BIT(1, 6), "ICC data missing" },
89 { EMV_BIT(1, 5), "Card appears on terminal exception file" },
90 { EMV_BIT(1, 4), "DDA failed" },
91 { EMV_BIT(1, 3), "CDA failed" },
92 { EMV_BIT(1, 2), "SDA selected" },
93 { EMV_BIT(2, 8), "ICC and terminal have different application versions" },
94 { EMV_BIT(2, 7), "Expired application" },
95 { EMV_BIT(2, 6), "Application not yet effective" },
96 { EMV_BIT(2, 5), "Requested service not allowed for card product" },
97 { EMV_BIT(2, 4), "New card" },
98 { EMV_BIT(3, 8), "Cardholder verification was not successful" },
99 { EMV_BIT(3, 7), "Unrecognised CVM" },
100 { EMV_BIT(3, 6), "PIN Try Limit exceeded" },
101 { EMV_BIT(3, 5), "PIN entry required and PIN pad not present or not working" },
102 { EMV_BIT(3, 4), "PIN entry required, PIN pad present, but PIN was not entered" },
103 { EMV_BIT(3, 3), "Online PIN entered" },
104 { EMV_BIT(4, 8), "Transaction exceeds floor limit" },
105 { EMV_BIT(4, 7), "Lower consecutive offline limit exceeded" },
106 { EMV_BIT(4, 6), "Upper consecutive offline limit exceeded" },
107 { EMV_BIT(4, 5), "Transaction selected randomly for online processing" },
108 { EMV_BIT(4, 4), "Merchant forced transaction online" },
109 { EMV_BIT(5, 8), "Default TDOL used" },
110 { EMV_BIT(5, 7), "Issuer authentication failed" },
111 { EMV_BIT(5, 6), "Script processing failed before final GENERATE AC" },
112 { EMV_BIT(5, 5), "Script processing failed after final GENERATE AC" },
113 { EMV_BIT(5, 4), "Reserved for use by the EMV Contactless Specifications" },
114 { EMV_BIT(5, 3), "Reserved for use by the EMV Contactless Specifications" },
115 { EMV_BIT(5, 2), "Reserved for use by the EMV Contactless Specifications" },
116 { EMV_BIT(5, 1), "Reserved for use by the EMV Contactless Specifications" },
117 EMV_BIT_FINISH,
118 };
119
120 static const struct emv_tag_bit EMV_CTQ[] = {
121 { EMV_BIT(1, 8), "Online PIN Required" },
122 { EMV_BIT(1, 7), "Signature Required" },
123 { EMV_BIT(1, 6), "Go Online if Offline Data Authentication Fails and Reader is online capable" },
124 { EMV_BIT(1, 5), "Switch Interface if Offline Data Authentication fails and Reader supports VIS" },
125 { EMV_BIT(1, 4), "Go Online if Application Expired" },
126 { EMV_BIT(1, 3), "Switch Interface for Cash Transactions" },
127 { EMV_BIT(1, 2), "Switch Interface for Cashback Transactions" },
128 { EMV_BIT(2, 8), "Consumer Device CVM Performed" },
129 { EMV_BIT(2, 7), "Card supports Issuer Update Processing at the POS" },
130 EMV_BIT_FINISH,
131 };
132
133 static const struct emv_tag_bit EMV_TTQ[] = {
134 { EMV_BIT(1, 8), "MSD supported" },
135 { EMV_BIT(1, 7), "VSDC supported" },
136 { EMV_BIT(1, 6), "qVSDC supported" },
137 { EMV_BIT(1, 5), "EMV contact chip supported" },
138 { EMV_BIT(1, 4), "Offline-only reader" },
139 { EMV_BIT(1, 3), "Online PIN supported" },
140 { EMV_BIT(1, 2), "Signature supported" },
141 { EMV_BIT(1, 1), "Offline Data Authentication (ODA) for Online Authorizations supported\nWarning!!!! Readers compliant to this specification set TTQ byte 1 bit 1 (this field) to 0b" },
142 { EMV_BIT(2, 8), "Online cryptogram required" },
143 { EMV_BIT(2, 7), "CVM required" },
144 { EMV_BIT(2, 6), "(Contact Chip) Offline PIN supported" },
145 { EMV_BIT(3, 8), "Issuer Update Processing supported" },
146 { EMV_BIT(3, 7), "Mobile functionality supported (Consumer Device CVM)" },
147 EMV_BIT_FINISH,
148 };
149
150 static const struct emv_tag_bit EMV_CVR[] = {
151 // mask 0F 0F F0 0F
152 { EMV_BIT(1, 4), "CDA Performed" },
153 { EMV_BIT(1, 3), "Offline DDA Performed" },
154 { EMV_BIT(1, 2), "Issuer Authentication Not Performed" },
155 { EMV_BIT(1, 1), "Issuer Authentication performed and Failed" },
156 { EMV_BIT(2, 4), "Offline PIN Verification Performed" },
157 { EMV_BIT(2, 3), "Offline PIN Verification Performed and PIN Not Successfully Verified" },
158 { EMV_BIT(2, 2), "PIN Try Limit Exceeded" },
159 { EMV_BIT(2, 1), "Last Online Transaction Not Completed" },
160 { EMV_BIT(3, 8), "Lower Offline Transaction Count Limit Exceeded" },
161 { EMV_BIT(3, 7), "Upper Offline Transaction Count Limit Exceeded" },
162 { EMV_BIT(3, 6), "Lower Cumulative Offline Amount Limit Exceeded" },
163 { EMV_BIT(3, 5), "Upper Cumulative Offline Amount Limit Exceeded" },
164 { EMV_BIT(4, 4), "Issuer script processing failed on last transaction" },
165 { EMV_BIT(4, 3), "Offline data authentication failed on previous transaction and transaction declined offline" },
166 { EMV_BIT(4, 2), "Go Online on Next Transaction Was Set" },
167 { EMV_BIT(4, 1), "Unable to go Online" },
168 EMV_BIT_FINISH,
169 };
170
171 // All Data Elements by Tags used in TLV structure (according to the EMV 4.2 Standard )
172 // https://www.eftlab.co.uk/index.php/site-map/knowledge-base/145-emv-nfc-tags
173 // http://dexterous-programmer.blogspot.in/2012/05/emv-tags.html
174 static const struct emv_tag emv_tags[] = {
175 // internal
176 { 0x00 , "Unknown ???" },
177 { 0x01 , "", EMV_TAG_STRING }, // string for headers
178 { 0x02 , "Raw data", }, // data
179 { 0x20 , "Cardholder Verification Results (CVR)", EMV_TAG_CVR }, // not standard!
180
181 // EMV
182 { 0x41 , "Country code and national data" },
183 { 0x42 , "Issuer Identification Number (IIN)" },
184 { 0x4f , "Application Dedicated File (ADF) Name" },
185 { 0x50 , "Application Label", EMV_TAG_STRING },
186 { 0x56 , "Track 1 Data" },
187 { 0x57 , "Track 2 Equivalent Data" },
188 { 0x5a , "Application Primary Account Number (PAN)" },
189 { 0x5f20, "Cardholder Name", EMV_TAG_STRING },
190 { 0x5f24, "Application Expiration Date", EMV_TAG_YYMMDD },
191 { 0x5f25, "Application Effective Date", EMV_TAG_YYMMDD },
192 { 0x5f28, "Issuer Country Code", EMV_TAG_NUMERIC },
193 { 0x5f2a, "Transaction Currency Code", EMV_TAG_NUMERIC },
194 { 0x5f2d, "Language Preference", EMV_TAG_STRING },
195 { 0x5f30, "Service Code", EMV_TAG_NUMERIC },
196 { 0x5f34, "Application Primary Account Number (PAN) Sequence Number", EMV_TAG_NUMERIC },
197 { 0x61 , "Application Template" },
198 { 0x6f , "File Control Information (FCI) Template" },
199 { 0x70 , "READ RECORD Response Message Template" },
200 { 0x77 , "Response Message Template Format 2" },
201 { 0x80 , "Response Message Template Format 1" },
202 { 0x82 , "Application Interchange Profile", EMV_TAG_BITMASK, &EMV_AIP },
203 { 0x83 , "Command Template" },
204 { 0x84 , "Dedicated File (DF) Name" },
205 { 0x87 , "Application Priority Indicator" },
206 { 0x88 , "Short File Identifier (SFI)" },
207 { 0x8a , "Authorisation Response Code" },
208 { 0x8c , "Card Risk Management Data Object List 1 (CDOL1)", EMV_TAG_DOL },
209 { 0x8d , "Card Risk Management Data Object List 2 (CDOL2)", EMV_TAG_DOL },
210 { 0x8e , "Cardholder Verification Method (CVM) List", EMV_TAG_CVM_LIST },
211 { 0x8f , "Certification Authority Public Key Index" },
212 { 0x90 , "Issuer Public Key Certificate" },
213 { 0x91 , "Issuer Authentication Data" },
214 { 0x92 , "Issuer Public Key Remainder" },
215 { 0x93 , "Signed Static Application Data" },
216 { 0x94 , "Application File Locator (AFL)", EMV_TAG_AFL },
217 { 0x95 , "Terminal Verification Results" },
218 { 0x9a , "Transaction Date", EMV_TAG_YYMMDD },
219 { 0x9c , "Transaction Type" },
220 { 0x9f02, "Amount, Authorised (Numeric)", EMV_TAG_NUMERIC },
221 { 0x9f03, "Amount, Other (Numeric)", EMV_TAG_NUMERIC, },
222 { 0x9f06, "Application Identifier (AID), Terminal. ISO 7816-5" },
223 { 0x9f07, "Application Usage Control", EMV_TAG_BITMASK, &EMV_AUC },
224 { 0x9f08, "Application Version Number" },
225 { 0x9f0a, "Application Selection Registered Proprietary Data" }, // https://blog.ul-ts.com/posts/electronic-card-identifier-one-more-step-for-mif-compliance/
226 { 0x9f0d, "Issuer Action Code - Default", EMV_TAG_BITMASK, &EMV_TVR },
227 { 0x9f0e, "Issuer Action Code - Denial", EMV_TAG_BITMASK, &EMV_TVR },
228 { 0x9f0f, "Issuer Action Code - Online", EMV_TAG_BITMASK, &EMV_TVR },
229 { 0x9f10, "Issuer Application Data" },
230 { 0x9f11, "Issuer Code Table Index", EMV_TAG_NUMERIC },
231 { 0x9f12, "Application Preferred Name", EMV_TAG_STRING },
232 { 0x9f13, "Last Online Application Transaction Counter (ATC) Register" },
233 { 0x9f17, "Personal Identification Number (PIN) Try Counter" },
234 { 0x9f1a, "Terminal Country Code" },
235 { 0x9f1f, "Track 1 Discretionary Data", EMV_TAG_STRING },
236 { 0x9f21, "Transaction Time" },
237 { 0x9f26, "Application Cryptogram" },
238 { 0x9f27, "Cryptogram Information Data", EMV_TAG_CID },
239 { 0x9f2a, "Kernel Identifier" },
240 { 0x9f2d, "ICC PIN Encipherment Public Key Certificate" },
241 { 0x9f2e, "ICC PIN Encipherment Public Key Exponent" },
242 { 0x9f2f, "ICC PIN Encipherment Public Key Remainder" },
243 { 0x9f32, "Issuer Public Key Exponent" },
244 { 0x9f34, "Cardholder Verification Method (CVM) Results" },
245 { 0x9f35, "Terminal Type" },
246 { 0x9f36, "Application Transaction Counter (ATC)" },
247 { 0x9f37, "Unpredictable Number" },
248 { 0x9f38, "Processing Options Data Object List (PDOL)", EMV_TAG_DOL },
249 { 0x9f42, "Application Currency Code", EMV_TAG_NUMERIC },
250 { 0x9f44, "Application Currency Exponent", EMV_TAG_NUMERIC },
251 { 0x9f45, "Data Authentication Code" },
252 { 0x9f46, "ICC Public Key Certificate" },
253 { 0x9f47, "ICC Public Key Exponent" },
254 { 0x9f48, "ICC Public Key Remainder" },
255 { 0x9f49, "Dynamic Data Authentication Data Object List (DDOL)", EMV_TAG_DOL },
256 { 0x9f4a, "Static Data Authentication Tag List" },
257 { 0x9f4b, "Signed Dynamic Application Data" },
258 { 0x9f4c, "ICC Dynamic Number" },
259 { 0x9f4d, "Log Entry" },
260 { 0x9f4f, "Log Format", EMV_TAG_DOL },
261 { 0x9f60, "CVC3 (Track1)" },
262 { 0x9f61, "CVC3 (Track2)" },
263 { 0x9f62, "PCVC3(Track1)" },
264 { 0x9f63, "PUNATC(Track1)" },
265 { 0x9f64, "NATC(Track1)" },
266 { 0x9f65, "PCVC3(Track2)" },
267 { 0x9f66, "PUNATC(Track2) / Terminal Transaction Qualifiers (TTQ)", EMV_TAG_BITMASK, &EMV_TTQ },
268 { 0x9f67, "NATC(Track2) / MSD Offset" },
269 { 0x9f69, "Card Authentication Related Data" },
270 { 0x9f6a, "Unpredictable Number", EMV_TAG_NUMERIC },
271 { 0x9f6b, "Track 2 Data" },
272 { 0x9f6c, "Card Transaction Qualifiers (CTQ)", EMV_TAG_BITMASK, &EMV_CTQ },
273 { 0xa5 , "File Control Information (FCI) Proprietary Template" },
274 { 0xbf0c, "File Control Information (FCI) Issuer Discretionary Data" },
275 { 0xdf20, "Issuer Proprietary Bitmap (IPB)" },
276 };
277
278 static int emv_sort_tag(tlv_tag_t tag)
279 {
280 return (int)(tag >= 0x100 ? tag : tag << 8);
281 }
282
283 static int emv_tlv_compare(const void *a, const void *b)
284 {
285 const struct tlv *tlv = a;
286 const struct emv_tag *tag = b;
287
288 return emv_sort_tag(tlv->tag) - (emv_sort_tag(tag->tag));
289 }
290
291 static const struct emv_tag *emv_get_tag(const struct tlv *tlv)
292 {
293 struct emv_tag *tag = bsearch(tlv, emv_tags, sizeof(emv_tags)/sizeof(emv_tags[0]),
294 sizeof(emv_tags[0]), emv_tlv_compare);
295
296 return tag ? tag : &emv_tags[0];
297 }
298
299 static const char *bitstrings[] = {
300 ".......1",
301 "......1.",
302 ".....1..",
303 "....1...",
304 "...1....",
305 "..1.....",
306 ".1......",
307 "1.......",
308 };
309
310 static void emv_tag_dump_bitmask(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level)
311 {
312 const struct emv_tag_bit *bits = tag->data;
313 unsigned bit, byte;
314
315 for (byte = 1; byte <= tlv->len; byte ++) {
316 unsigned char val = tlv->value[byte - 1];
317 PRINT_INDENT(level);
318 fprintf(f, "\tByte %u (%02x)\n", byte, val);
319 for (bit = 8; bit > 0; bit--, val <<= 1) {
320 if (val & 0x80){
321 PRINT_INDENT(level);
322 fprintf(f, "\t\t%s - '%s'\n", bitstrings[bit - 1],
323 bits->bit == EMV_BIT(byte, bit) ? bits->name : "Unknown");
324 }
325 if (bits->bit == EMV_BIT(byte, bit))
326 bits ++;
327 }
328 }
329 }
330
331 static void emv_tag_dump_dol(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level)
332 {
333 const unsigned char *buf = tlv->value;
334 size_t left = tlv->len;
335
336 while (left) {
337 struct tlv doltlv;
338 const struct emv_tag *doltag;
339
340 if (!tlv_parse_tl(&buf, &left, &doltlv)) {
341 PRINT_INDENT(level);
342 fprintf(f, "Invalid Tag-Len\n");
343 continue;
344 }
345
346 doltag = emv_get_tag(&doltlv);
347
348 PRINT_INDENT(level);
349 fprintf(f, "\tTag %4hx len %02zx ('%s')\n", doltlv.tag, doltlv.len, doltag->name);
350 }
351 }
352
353 static void emv_tag_dump_string(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level)
354 {
355 fprintf(f, "\tString value '");
356 fwrite(tlv->value, 1, tlv->len, f);
357 fprintf(f, "'\n");
358 }
359
360 static unsigned long emv_value_numeric(const struct tlv *tlv, unsigned start, unsigned end)
361 {
362 unsigned long ret = 0;
363 int i;
364
365 if (end > tlv->len * 2)
366 return ret;
367 if (start >= end)
368 return ret;
369
370 if (start & 1) {
371 ret += tlv->value[start/2] & 0xf;
372 i = start + 1;
373 } else
374 i = start;
375
376 for (; i < end - 1; i += 2) {
377 ret *= 10;
378 ret += tlv->value[i/2] >> 4;
379 ret *= 10;
380 ret += tlv->value[i/2] & 0xf;
381 }
382
383 if (end & 1) {
384 ret *= 10;
385 ret += tlv->value[end/2] >> 4;
386 }
387
388 return ret;
389 }
390
391 static void emv_tag_dump_numeric(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level)
392 {
393 PRINT_INDENT(level);
394 fprintf(f, "\tNumeric value %lu\n", emv_value_numeric(tlv, 0, tlv->len * 2));
395 }
396
397 static void emv_tag_dump_yymmdd(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level)
398 {
399 PRINT_INDENT(level);
400 fprintf(f, "\tDate: 20%02ld.%ld.%ld\n",
401 emv_value_numeric(tlv, 0, 2),
402 emv_value_numeric(tlv, 2, 4),
403 emv_value_numeric(tlv, 4, 6));
404 }
405
406 static uint32_t emv_get_binary(const unsigned char *S)
407 {
408 return (S[0] << 24) | (S[1] << 16) | (S[2] << 8) | (S[3] << 0);
409 }
410
411 // https://github.com/binaryfoo/emv-bertlv/blob/master/src/main/resources/fields/visa-cvr.txt
412 static void emv_tag_dump_cvr(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level) {
413 if (!tlv || tlv->len < 1) {
414 PRINT_INDENT(level);
415 fprintf(f, "\tINVALID!\n");
416 return;
417 }
418
419 if (tlv->len != tlv->value[0] + 1) {
420 PRINT_INDENT(level);
421 fprintf(f, "\tINVALID length!\n");
422 return;
423 }
424
425 if (tlv->len >= 2) {
426 // AC1
427 PRINT_INDENT(level);
428 if ((tlv->value[1] & 0xC0) == 0x00) fprintf(f, "\tAC1: AAC (Transaction declined)\n");
429 if ((tlv->value[1] & 0xC0) == 0x40) fprintf(f, "\tAC1: TC (Transaction approved)\n");
430 if ((tlv->value[1] & 0xC0) == 0x80) fprintf(f, "\tAC1: ARQC (Online authorisation requested)\n");
431 if ((tlv->value[1] & 0xC0) == 0xC0) fprintf(f, "\tAC1: RFU\n");
432 // AC2
433 PRINT_INDENT(level);
434 if ((tlv->value[1] & 0x30) == 0x00) fprintf(f, "\tAC2: AAC (Transaction declined)\n");
435 if ((tlv->value[1] & 0x30) == 0x10) fprintf(f, "\tAC2: TC (Transaction approved)\n");
436 if ((tlv->value[1] & 0x30) == 0x20) fprintf(f, "\tAC2: not requested (ARQC)\n");
437 if ((tlv->value[1] & 0x30) == 0x30) fprintf(f, "\tAC2: RFU\n");
438 }
439 if (tlv->len >= 3 && (tlv->value[2] >> 4)) {
440 PRINT_INDENT(level);
441 fprintf(f, "\tPIN try: %x\n", tlv->value[2] >> 4);
442 }
443 if (tlv->len >= 4 && (tlv->value[3] & 0x0F)) {
444 PRINT_INDENT(level);
445 fprintf(f, "\tIssuer discretionary bits: %x\n", tlv->value[3] & 0x0F);
446 }
447 if (tlv->len >= 5 && (tlv->value[4] >> 4)) {
448 PRINT_INDENT(level);
449 fprintf(f, "\tSuccessfully processed issuer script commands: %x\n", tlv->value[4] >> 4);
450 }
451
452 // mask 0F 0F F0 0F
453 uint8_t data[20] = {0};
454 memcpy(data, &tlv->value[1], tlv->len - 1);
455 data[0] &= 0x0F;
456 data[1] &= 0x0F;
457 data[2] &= 0xF0;
458 data[3] &= 0x0F;
459 const struct tlv bit_tlv = {
460 .tag = tlv->tag,
461 .len = tlv->len - 1,
462 .value = data,
463 };
464 const struct emv_tag bit_tag = {
465 .tag = tag->tag,
466 .name = tag->name,
467 .type = EMV_TAG_BITMASK,
468 .data = EMV_CVR,
469 };
470
471 if (data[0] || data[1] || data[2] || data[3])
472 emv_tag_dump_bitmask(&bit_tlv, &bit_tag, f, level);
473
474 return;
475 }
476
477 // EMV Book 3
478 static void emv_tag_dump_cid(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level) {
479 if (!tlv || tlv->len < 1) {
480 PRINT_INDENT(level);
481 fprintf(f, "\tINVALID!\n");
482 return;
483 }
484
485 PRINT_INDENT(level);
486 if ((tlv->value[0] & 0xC0) == 0x00) fprintf(f, "\tAC1: AAC (Transaction declined)\n");
487 if ((tlv->value[0] & 0xC0) == 0x40) fprintf(f, "\tAC1: TC (Transaction approved)\n");
488 if ((tlv->value[0] & 0xC0) == 0x80) fprintf(f, "\tAC1: ARQC (Online authorisation requested)\n");
489 if ((tlv->value[0] & 0xC0) == 0xC0) fprintf(f, "\tAC1: RFU\n");
490
491 if ((tlv->value[0] & 0x08) != 0x00) {
492 PRINT_INDENT(level);
493 fprintf(f, "\tAdvice required!\n");
494 }
495
496 if ((tlv->value[0] & 0x07) != 0x00) {
497 PRINT_INDENT(level);
498 fprintf(f, "\tReason/advice/referral code: ");
499 switch((tlv->value[0] & 0x07)) {
500 case 0:
501 fprintf(f, "No information given\n");
502 break;
503 case 1:
504 fprintf(f, "Service not allowed\n");
505 break;
506 case 2:
507 fprintf(f, "PIN Try Limit exceeded\n");
508 break;
509 case 3:
510 fprintf(f, "Issuer authentication failed\n");
511 break;
512 default:
513 fprintf(f, "\tRFU: %2x\n", (tlv->value[0] & 0x07));
514 break;
515 }
516 }
517
518 return;
519 }
520
521 static void emv_tag_dump_cvm_list(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level)
522 {
523 uint32_t X, Y;
524 int i;
525
526 if (tlv->len < 10 || tlv->len % 2) {
527 PRINT_INDENT(level);
528 fprintf(f, "\tINVALID!\n");
529 return;
530 }
531
532 X = emv_get_binary(tlv->value);
533 Y = emv_get_binary(tlv->value + 4);
534
535 PRINT_INDENT(level);
536 fprintf(f, "\tX: %d\n", X);
537 PRINT_INDENT(level);
538 fprintf(f, "\tY: %d\n", Y);
539
540 for (i = 8; i < tlv->len; i+= 2) {
541 const char *method;
542 const char *condition;
543
544 switch (tlv->value[i] & 0x3f) {
545 case 0x0:
546 method = "Fail CVM processing";
547 break;
548 case 0x1:
549 method = "Plaintext PIN verification performed by ICC";
550 break;
551 case 0x2:
552 method = "Enciphered PIN verified online";
553 break;
554 case 0x3:
555 method = "Plaintext PIN verification performed by ICC and signature (paper)";
556 break;
557 case 0x4:
558 method = "Enciphered PIN verification performed by ICC";
559 break;
560 case 0x5:
561 method = "Enciphered PIN verification performed by ICC and signature (paper)";
562 break;
563 case 0x1e:
564 method = "Signature (paper)";
565 break;
566 case 0x1f:
567 method = "No CVM required";
568 break;
569 case 0x3f:
570 method = "NOT AVAILABLE!";
571 break;
572 default:
573 method = "Unknown";
574 break;
575 }
576
577 switch (tlv->value[i+1]) {
578 case 0x00:
579 condition = "Always";
580 break;
581 case 0x01:
582 condition = "If unattended cash";
583 break;
584 case 0x02:
585 condition = "If not unattended cash and not manual cash and not purchase with cashback";
586 break;
587 case 0x03:
588 condition = "If terminal supports the CVM";
589 break;
590 case 0x04:
591 condition = "If manual cash";
592 break;
593 case 0x05:
594 condition = "If purchase with cashback";
595 break;
596 case 0x06:
597 condition = "If transaction is in the application currency and is under X value";
598 break;
599 case 0x07:
600 condition = "If transaction is in the application currency and is over X value";
601 break;
602 case 0x08:
603 condition = "If transaction is in the application currency and is under Y value";
604 break;
605 case 0x09:
606 condition = "If transaction is in the application currency and is over Y value";
607 break;
608 default:
609 condition = "Unknown";
610 break;
611 }
612
613 PRINT_INDENT(level);
614 fprintf(f, "\t%02x %02x: '%s' '%s' and '%s' if this CVM is unsuccessful\n",
615 tlv->value[i], tlv->value[i+1],
616 method, condition, (tlv->value[i] & 0x40) ? "continue" : "fail");
617 }
618 }
619
620 static void emv_tag_dump_afl(const struct tlv *tlv, const struct emv_tag *tag, FILE *f, int level){
621 if (tlv->len < 4 || tlv->len % 4) {
622 PRINT_INDENT(level);
623 fprintf(f, "\tINVALID!\n");
624 return;
625 }
626
627 for (int i = 0; i < tlv->len / 4; i++) {
628 PRINT_INDENT(level);
629 fprintf(f, "SFI[%02x] start:%02x end:%02x offline:%02x\n", tlv->value[i * 4 + 0] >> 3, tlv->value[i * 4 + 1], tlv->value[i * 4 + 2], tlv->value[i * 4 + 3]);
630 }
631 }
632
633 bool emv_tag_dump(const struct tlv *tlv, FILE *f, int level)
634 {
635 if (!tlv) {
636 fprintf(f, "NULL\n");
637 return false;
638 }
639
640 const struct emv_tag *tag = emv_get_tag(tlv);
641
642 PRINT_INDENT(level);
643 fprintf(f, "--%2hx[%02zx] '%s':", tlv->tag, tlv->len, tag->name);
644
645 switch (tag->type) {
646 case EMV_TAG_GENERIC:
647 fprintf(f, "\n");
648 break;
649 case EMV_TAG_BITMASK:
650 fprintf(f, "\n");
651 emv_tag_dump_bitmask(tlv, tag, f, level);
652 break;
653 case EMV_TAG_DOL:
654 fprintf(f, "\n");
655 emv_tag_dump_dol(tlv, tag, f, level);
656 break;
657 case EMV_TAG_CVM_LIST:
658 fprintf(f, "\n");
659 emv_tag_dump_cvm_list(tlv, tag, f, level);
660 break;
661 case EMV_TAG_AFL:
662 fprintf(f, "\n");
663 emv_tag_dump_afl(tlv, tag, f, level);
664 break;
665 case EMV_TAG_STRING:
666 emv_tag_dump_string(tlv, tag, f, level);
667 break;
668 case EMV_TAG_NUMERIC:
669 emv_tag_dump_numeric(tlv, tag, f, level);
670 break;
671 case EMV_TAG_YYMMDD:
672 emv_tag_dump_yymmdd(tlv, tag, f, level);
673 break;
674 case EMV_TAG_CVR:
675 fprintf(f, "\n");
676 emv_tag_dump_cvr(tlv, tag, f, level);
677 break;
678 case EMV_TAG_CID:
679 fprintf(f, "\n");
680 emv_tag_dump_cid(tlv, tag, f, level);
681 break;
682 };
683
684 return true;
685 }
Proxmark3 GIT tracking
Impressum, Datenschutz