git.zerfleddert.de Git - proxmark3-svn/blob - 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 #define APDU_RES_LEN 260
  33 #define APDU_AID_LEN 50
  34
  35 typedef enum {
  36         ECC_CONTACTLESS,
  37         ECC_CONTACT
  38 } EMVCommandChannel;
  39
  40 enum TransactionType {
  41         TT_MSD,
  42         TT_VSDC,        // not standart for contactless!!!!
  43         TT_QVSDCMCHIP,
  44         TT_CDA,
  45 };
  46 extern char *TransactionTypeStr[];
  47
  48 typedef struct {
  49         uint8_t CLA;
  50         uint8_t INS;
  51         uint8_t P1;
  52         uint8_t P2;
  53         uint8_t Lc;
  54         uint8_t *data;
  55 } sAPDU;
  56
  57 enum CardPSVendor {
  58         CV_NA,
  59         CV_VISA,
  60         CV_MASTERCARD,
  61         CV_AMERICANEXPRESS,
  62         CV_JCB,
  63         CV_CB,
  64         CV_OTHER,
  65 };
  66 extern enum CardPSVendor GetCardPSVendor(uint8_t * AID, size_t AIDlen);
  67
  68 extern bool TLVPrintFromBuffer(uint8_t *data, int datalen);
  69 extern void TLVPrintFromTLV(struct tlvdb *tlv);
  70 extern void TLVPrintFromTLVLev(struct tlvdb *tlv, int level);
  71 extern void TLVPrintAIDlistFromSelectTLV(struct tlvdb *tlv);
  72
  73 extern struct tlvdb *GetPANFromTrack2(const struct tlv *track2);
  74 extern struct tlvdb *GetdCVVRawFromTrack2(const struct tlv *track2);
  75
  76 extern void SetAPDULogging(bool logging);
  77
  78 // exchange
  79 extern int EMVExchange(EMVCommandChannel channel, bool LeaveFieldON, sAPDU apdu, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
  80
  81 // search application
  82 extern int EMVSearchPSE(EMVCommandChannel channel, bool ActivateField, bool LeaveFieldON, uint8_t PSENum, bool decodeTLV, struct tlvdb *tlv);
  83 extern int EMVSearch(EMVCommandChannel channel, bool ActivateField, bool LeaveFieldON, bool decodeTLV, struct tlvdb *tlv);
  84 extern int EMVSelectPSE(EMVCommandChannel channel, bool ActivateField, bool LeaveFieldON, uint8_t PSENum, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw);
  85 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);
  86 // select application
  87 extern int EMVSelectApplication(struct tlvdb *tlv, uint8_t *AID, size_t *AIDlen);
  88 // Get Processing Options
  89 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);
  90 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);
  91 // AC
  92 extern int EMVGenerateChallenge(EMVCommandChannel channel, bool LeaveFieldON, uint8_t *Result, size_t MaxResultLen, size_t *ResultLen, uint16_t *sw, struct tlvdb *tlv);
  93 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);
  94 // DDA
  95 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);
  96 // Mastercard
  97 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);
  98 // Auth
  99 extern int trSDA(struct tlvdb *tlv);
 100 extern int trDDA(EMVCommandChannel channel, bool decodeTLV, struct tlvdb *tlv);
 101 extern int trCDA(struct tlvdb *tlv, struct tlvdb *ac_tlv, struct tlv *pdol_data_tlv, struct tlv *ac_data_tlv);
 102
 103 extern int RecoveryCertificates(struct tlvdb *tlvRoot, json_t *root);
 104
 105 extern struct emv_pk *get_ca_pk(struct tlvdb *db);
 106 #endif
 107
 108
 109
 110