Adding support for standard USB Smartcard Readers (#769)
[proxmark3-svn] / client / emv / emvcore.h
1 //-----------------------------------------------------------------------------
2 // Copyright (C) 2017 Merlok
3 //
4 // This code is licensed to you under the terms of the GNU GPL, version 2 or,
5 // at your option, any later version. See the LICENSE.txt file for the text of
6 // the license.
7 //-----------------------------------------------------------------------------
8 // EMV core functionality
9 //-----------------------------------------------------------------------------
10
11 #ifndef EMVCORE_H__
12 #define EMVCORE_H__
13
14 #include <stdio.h>
15 #include <stdint.h>
16 #include <stdlib.h>
17 #include <inttypes.h>
18 #include <string.h>
19 #include <jansson.h>
20 #include "util.h"
21 #include "common.h"
22 #include "ui.h"
23 #include "cmdhf14a.h"
24 #include "apduinfo.h"
25 #include "tlv.h"
26 #include "dol.h"
27 #include "dump.h"
28 #include "emv_tags.h"
29 #include "emv_pk.h"
30 #include "emv_pki.h"
31
32 // maximum APDU lengths. Long APDUs not yet supported/needed
33 #define APDU_DATA_LEN 255
34 #define APDU_COMMAND_LEN (4 + 1 + APDU_DATA_LEN + 1)
35 #define APDU_RESPONSE_LEN (256 + 2)
36
37 typedef enum {
38 ECC_CONTACTLESS,
39 ECC_CONTACT
40 } EMVCommandChannel;
41
42 enum TransactionType {
43 TT_MSD,
44 TT_VSDC, // not standart for contactless!!!!
45 TT_QVSDCMCHIP,
46 TT_CDA,
47 };
48 extern char *TransactionTypeStr[];
49
50 enum CardPSVendor {
51 CV_NA,
52 CV_VISA,
53 CV_MASTERCARD,
54 CV_AMERICANEXPRESS,
55 CV_JCB,
56 CV_CB,
57 CV_OTHER,
58 };
59 extern enum CardPSVendor GetCardPSVendor(uint8_t * AID, size_t AIDlen);
60
61 extern bool TLVPrintFromBuffer(uint8_t *data, int datalen);
62 extern void TLVPrintFromTLV(struct tlvdb *tlv);
63 extern void TLVPrintFromTLVLev(struct tlvdb *tlv, int level);
64 extern void TLVPrintAIDlistFromSelectTLV(struct tlvdb *tlv);
65
66 extern struct tlvdb *GetPANFromTrack2(const struct tlv *track2);
67 extern struct tlvdb *GetdCVVRawFromTrack2(const struct tlv *track2);
68
69 extern void SetAPDULogging(bool logging);
70
71 // exchange
72 extern int EMVExchange(EMVCommandChannel channel, bool LeaveFieldON, uint8_t *APDU, int APDU_len, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
73
74 // search application
75 extern int EMVSearchPSE(EMVCommandChannel channel, bool ActivateField, bool LeaveFieldON, uint8_t PSENum, bool decodeTLV, struct tlvdb *tlv);
76 extern int EMVSearch(EMVCommandChannel channel, bool ActivateField, bool LeaveFieldON, bool decodeTLV, struct tlvdb *tlv);
77 extern int EMVSelectPSE(EMVCommandChannel channel, bool ActivateField, bool LeaveFieldON, uint8_t PSENum, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw);
78 extern int EMVSelect(EMVCommandChannel channel, bool ActivateField, bool LeaveFieldON, uint8_t *AID, size_t AIDLen, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
79 // select application
80 extern int EMVSelectApplication(struct tlvdb *tlv, uint8_t *AID, size_t *AIDlen);
81 // Get Processing Options
82 extern int EMVGPO(EMVCommandChannel channel, bool LeaveFieldON, uint8_t *PDOL, size_t PDOLLen, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
83 extern int EMVReadRecord(EMVCommandChannel channel, bool LeaveFieldON, uint8_t SFI, uint8_t SFIrec, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
84 // AC
85 extern int EMVGenerateChallenge(EMVCommandChannel channel, bool LeaveFieldON, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
86 extern int EMVAC(EMVCommandChannel channel, bool LeaveFieldON, uint8_t RefControl, uint8_t *CDOL, size_t CDOLLen, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
87 // DDA
88 extern int EMVInternalAuthenticate(EMVCommandChannel channel, bool LeaveFieldON, uint8_t *DDOL, size_t DDOLLen, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
89 // Mastercard
90 int MSCComputeCryptoChecksum(EMVCommandChannel channel, bool LeaveFieldON, uint8_t *UDOL, uint8_t UDOLlen, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
91 // Auth
92 extern int trSDA(struct tlvdb *tlv);
93 extern int trDDA(EMVCommandChannel channel, bool decodeTLV, struct tlvdb *tlv);
94 extern int trCDA(struct tlvdb *tlv, struct tlvdb *ac_tlv, struct tlv *pdol_data_tlv, struct tlv *ac_data_tlv);
95
96 extern int RecoveryCertificates(struct tlvdb *tlvRoot, json_t *root);
97
98 extern struct emv_pk *get_ca_pk(struct tlvdb *db);
99 #endif
100
101
102
103
Impressum, Datenschutz