#include #include "../helpers/iso7816.h" #include "mrtd.h" #define TAG "Mrtd" //TODO: Check EF.DIR first? Before LDS1 //TODO: ICAO 9303 p11 ยง4.2 steps //- Read EF.CardAccess (REQUIRED) // If not available or does not contain PACE params, try BAC //- Read EF.DIR (OPTIONAL) // Check list of applications present //- PACE (CONDITIONAL) //- BAC (CONDITIONAL) //TODO: idea - generalize ISO7816 reading. List available apps static void hexdump(FuriLogLevel level, char* prefix, void* data, size_t length) { if(furi_log_get_level() >= level) { printf("%s ", prefix); for(size_t i = 0; i < length; i++) { printf("%02X ", ((uint8_t*)data)[i]); } printf("\r\n"); } } static void mrtd_trace(MrtdApplication* app) { FuriHalNfcTxRxContext* tx_rx = app->tx_rx; if(furi_log_get_level() == FuriLogLevelTrace) { printf("TX: "); for(size_t i = 0; i < tx_rx->tx_bits / 8; i++) { printf("%02X ", tx_rx->tx_data[i]); } printf("\r\nRX: "); for(size_t i = 0; i < tx_rx->rx_bits / 8; i++) { printf("%02X ", tx_rx->rx_data[i]); } printf("\r\n"); } } uint16_t mrtd_decode_response(uint8_t* buffer, size_t len) { // Last two bytes are return code return (buffer[len-2] << 8) | buffer[len-1]; } EFFile EFNone = {.name = NULL, .file_id = 0x0000, .short_id = 0x00, .tag = 0x00 }; struct EFFormat EF = { .ATR = {.name = "ATR", .file_id = 0x2F01, .short_id = 0x01 }, .DIR = {.name = "DIR", .file_id = 0x2F00, .short_id = 0x1E }, .CardAccess = {.name = "CardAccess", .file_id = 0x011C, .short_id = 0x1C }, .CardSecurity = {.name = "CardSecurity", .file_id = 0x011D, .short_id = 0x1D }, .COM = {.name = "COM", .file_id = 0x011E, .short_id = 0x1E, .tag = 0x60 }, .SOD = {.name = "SOD", .file_id = 0X011D, .short_id = 0X1D, .tag = 0x77 }, .DG1 = {.name = "DG1", .file_id = 0X0101, .short_id = 0X01, .tag = 0x61 }, .DG2 = {.name = "DG2", .file_id = 0X0102, .short_id = 0X02, .tag = 0x75 }, .DG3 = {.name = "DG3", .file_id = 0X0103, .short_id = 0X03, .tag = 0x63 }, .DG4 = {.name = "DG4", .file_id = 0X0104, .short_id = 0X04, .tag = 0x76 }, .DG5 = {.name = "DG5", .file_id = 0X0105, .short_id = 0X05, .tag = 0x65 }, .DG6 = {.name = "DG6", .file_id = 0X0106, .short_id = 0X06, .tag = 0x66 }, .DG7 = {.name = "DG7", .file_id = 0X0107, .short_id = 0X07, .tag = 0x67 }, .DG8 = {.name = "DG8", .file_id = 0X0108, .short_id = 0X08, .tag = 0x68 }, .DG9 = {.name = "DG9", .file_id = 0X0109, .short_id = 0X09, .tag = 0x69 }, .DG10 = {.name = "DG10", .file_id = 0X010A, .short_id = 0X0A, .tag = 0x6a }, .DG11 = {.name = "DG11", .file_id = 0X010B, .short_id = 0X0B, .tag = 0x6b }, .DG12 = {.name = "DG12", .file_id = 0X010C, .short_id = 0X0C, .tag = 0x6c }, .DG13 = {.name = "DG13", .file_id = 0X010D, .short_id = 0X0D, .tag = 0x6d }, .DG14 = {.name = "DG14", .file_id = 0X010E, .short_id = 0X0E, .tag = 0x6e }, .DG15 = {.name = "DG15", .file_id = 0X010F, .short_id = 0X0F, .tag = 0x6f }, .DG16 = {.name = "DG16", .file_id = 0X0110, .short_id = 0X10, .tag = 0x70 }, }; struct AIDSet AID = { .eMRTDApplication = {0xA0, 0x00, 0x00, 0x02, 0x47, 0x10, 0x01}, .TravelRecords = {0xA0, 0x00, 0x00, 0x02, 0x47, 0x20, 0x01}, .VisaRecords = {0xA0, 0x00, 0x00, 0x02, 0x47, 0x20, 0x02}, .AdditionalBiometrics = {0xA0, 0x00, 0x00, 0x02, 0x47, 0x20, 0x03}, }; EFFile* mrtd_tag_to_file(uint8_t tag) { //TODO: generate this code with macros? switch(tag) { case 0x60: return &EF.COM; case 0x77: return &EF.SOD; case 0x61: return &EF.DG1; case 0x75: return &EF.DG2; case 0x63: return &EF.DG3; case 0x76: return &EF.DG4; case 0x65: return &EF.DG5; case 0x66: return &EF.DG6; case 0x67: return &EF.DG7; case 0x68: return &EF.DG8; case 0x69: return &EF.DG9; case 0x6a: return &EF.DG10; case 0x6b: return &EF.DG11; case 0x6c: return &EF.DG12; case 0x6d: return &EF.DG13; case 0x6e: return &EF.DG14; case 0x6f: return &EF.DG15; case 0x70: return &EF.DG16; default: furi_assert(false); return &EFNone; } }; //TODO: rename to transceive? bool mrtd_send_apdu(MrtdApplication* app, uint8_t cla, uint8_t ins, uint8_t p1, uint8_t p2, uint8_t lc, const void* data, int16_t le, uint8_t* output) { FuriHalNfcTxRxContext* tx_rx = app->tx_rx; size_t idx = 0; FURI_LOG_D(TAG, "Send APDU, lc: %d, le: %d", lc, le); if(app->secure_messaging) { FURI_LOG_D(TAG, "Protect APDU"); app->ssc_long++; idx = mrtd_protect_apdu(cla, ins, p1, p2, lc, data, le, app->ksenc, app->ksmac, app->ssc_long, tx_rx->tx_data); } else { tx_rx->tx_data[idx++] = cla; tx_rx->tx_data[idx++] = ins; tx_rx->tx_data[idx++] = p1; tx_rx->tx_data[idx++] = p2; if(lc > 0) { tx_rx->tx_data[idx++] = lc; memcpy(tx_rx->tx_data + idx, data, lc); idx += lc; } if(le >= 0) { tx_rx->tx_data[idx++] = le&0xff; } } tx_rx->tx_bits = idx * 8; tx_rx->tx_rx_type = FuriHalNfcTxRxTypeDefault; //TODO: timeout as param? if(furi_hal_nfc_tx_rx(tx_rx, 300)) { mrtd_trace(app); uint16_t ret_code = mrtd_decode_response(tx_rx->rx_data, tx_rx->rx_bits / 8); if(app->secure_messaging && ret_code == 0x9000) { app->ssc_long++; mrtd_bac_decrypt_verify_sm(tx_rx->rx_data, tx_rx->rx_bits / 8 - 2, app->ksenc, app->ksmac, app->ssc_long, output, &ret_code); } //TODO: handle other return codes? if(ret_code == 0x9000) { if(!app->secure_messaging && le > 0) { // Secure Messaging sets output while decrypting memcpy(output, tx_rx->rx_data, le); } return true; } else { FURI_LOG_I(TAG, "APDU answer is not 0x9000, but 0x%04X", ret_code); switch(ret_code) { case 0x6987: FURI_LOG_I(TAG, "'expected secure messaging data objects are missing'"); app->secure_messaging = false; break; case 0x6988: FURI_LOG_I(TAG, "'secure messaging data objects are incorrect'"); app->secure_messaging = false; break; } return false; } } return false; } //TODO: rename commands to "mrtd_cmd_..." bool mrtd_select_app(MrtdApplication* app, AIDValue aid) { FURI_LOG_D(TAG, "Send select App: %02X %02X %02X %02X %02X %02X %02X", aid[0], aid[1], aid[2], aid[3], aid[4], aid[5], aid[6]); if(!mrtd_send_apdu(app, 0x00, 0xA4, 0x04, 0x0C, 0x07, aid, -1, NULL)) { FURI_LOG_W(TAG, "Failed select App"); return false; } return true; } bool mrtd_get_challenge(MrtdApplication* app, uint8_t challenge[8]) { FURI_LOG_D(TAG, "Send Get Challenge"); if(!mrtd_send_apdu(app, 0x00, 0x84, 0x00, 0x00, 0x00, NULL, 0x08, challenge)) { FURI_LOG_W(TAG, "Failed get challenge"); return false; } return true; } bool mrtd_external_authenticate(MrtdApplication* app, uint8_t* cmd_data, size_t cmd_size, uint8_t* out_data, size_t out_size) { furi_assert(cmd_size == 0x28); furi_assert(out_size >= 0x28); FURI_LOG_D(TAG, "Send External Authenticate"); if(!mrtd_send_apdu(app, 0x00, 0x82, 0x00, 0x00, cmd_size, cmd_data, 0x28, out_data)) { FURI_LOG_W(TAG, "Failed External Authenticate"); return false; } return true; } bool mrtd_select_file(MrtdApplication* app, EFFile file) { uint8_t data[] = {file.file_id >> 8, file.file_id & 0xff}; FURI_LOG_D(TAG, "Send select EF: 0x%04X", file.file_id); if(!mrtd_send_apdu(app, 0x00, 0xA4, 0x02, 0x0C, 0x02, data, -1, NULL)) { FURI_LOG_E(TAG, "Failed select EF 0x%04X", file.file_id); return false; } return true; } //TODO: use out parameter to point to rx_data buffer instead of require allocating another size_t mrtd_read_binary(MrtdApplication* app, uint8_t* buffer, size_t bufsize, size_t offset) { UNUSED(buffer); UNUSED(bufsize); // 00 B0 offst - FURI_LOG_D(TAG, "Read binary, offset: %d", offset); //TODO: read first 4 bytes, determine length, iterate through file //TODO: limit reading/buffer fill to max bufsize int16_t max_read = 0; // 0 = 'everything', -1 = 'nothing' if(!mrtd_send_apdu(app, 0x00, 0xB0, offset>>8, offset&0xff, 0x00, NULL, max_read, buffer)) { FURI_LOG_E(TAG, "Failed to read"); return 0; } //TODO: return read amount return 0; } //TODO: use short id to read, because it's mandatory for eMRTD //TODO: check for support of extended length in EF.ATR/INFO, see ISO7816-4 void mrtd_read_dump(MrtdApplication* app, EFFile file, const char* descr) { FURI_LOG_D(TAG, "Read and dump %s:", descr); if(!mrtd_select_file(app, file)) { return; } uint8_t data[2048]; size_t read = 0; do { read = mrtd_read_binary(app, data + read, sizeof(data) - read, read); } while(read > 0); } void parse_ef_dir(EF_DIR_contents* EF_DIR, const uint8_t* data, size_t length) { size_t offset = 0; uint8_t app_idx = 0; memset(EF_DIR->applications, 0x00, sizeof(EF_DIR->applications)); EF_DIR->applications_count = 0; while(offset < length) { TlvInfo tlv = iso7816_tlv_parse(data + offset); if(tlv.tag != 0x61 || tlv.length != 0x09) { FURI_LOG_E(TAG, "Invalid EF.DIR, tag at offset %d must be '61' and length 9. Got '%02X' and %d", offset, tlv.tag, tlv.length); return; } tlv = iso7816_tlv_parse(tlv.value); if(tlv.tag != 0x4F || tlv.length != 0x07) { FURI_LOG_E(TAG, "Invalid EF.DIR, subtag at offset %d must be '4F' and length 7", offset); return; } memcpy(EF_DIR->applications[app_idx], tlv.value, tlv.length); EF_DIR->applications_count = ++app_idx; offset = tlv.next - data; } //TODO: remove testing block: FURI_LOG_D(TAG, "EF.DIR applications: %d", EF_DIR->applications_count); if(furi_log_get_level() >= FuriLogLevelDebug) { for(uint8_t i=0; iapplications_count; ++i) { printf("- "); for(uint8_t n=0; napplications[i][n]); } printf("\r\n"); } } } void parse_ef_com(EF_COM_contents* EF_COM, const uint8_t* data, size_t length) { UNUSED(EF_COM); //TODO UNUSED(length); //TODO size_t offset = 0; TlvInfo tlv = iso7816_tlv_parse(data + offset); UNUSED(tlv); //TODO } //TODO: remove testing function void mrtd_test(MrtdApplication* app, MrtdData* mrtd_data) { FuriHalNfcTxRxContext* tx_rx = app->tx_rx; FURI_LOG_D(TAG, "Mrtd Test"); mrtd_read_dump(app, EF.ATR, "EF.ATR"); mrtd_read_dump(app, EF.COM, "EF.COM"); mrtd_read_dump(app, EF.DIR, "EF.DIR"); parse_ef_dir(&app->files.EF_DIR, tx_rx->rx_data, tx_rx->rx_bits / 8 - 2); // bits to bytes, and exclude the 2 byte return code mrtd_read_dump(app, EF.CardAccess, "EF.CardAccess"); mrtd_read_dump(app, EF.CardSecurity, "EF.CardSecurity"); mrtd_select_app(app, AID.eMRTDApplication); //TODO: remove details /* mrtd_data->auth.birth_date = (MrtdDate){.year=69, .month=8, .day=6}; mrtd_data->auth.expiry_date = (MrtdDate){.year=94, .month=6, .day=23}; memcpy(mrtd_data->auth.doc_number, "L898902C<", 9); */ MrtdAuthMethod method = mrtd_data->auth.method; mrtd_data->auth_success = false; FURI_LOG_D(TAG, "Auth method: %d", method); switch(method) { case MrtdAuthMethodAny: //TODO: try PACE, then BAC case MrtdAuthMethodBac: mrtd_data->auth_success = mrtd_bac(app, &mrtd_data->auth); break; case MrtdAuthMethodPace: FURI_LOG_E(TAG, "Auth method PACE not implemented"); break; case MrtdAuthMethodNone: default: break; } if(!mrtd_data->auth_success) { return; } mrtd_read_dump(app, EF.COM, "EF.COM"); } MrtdApplication* mrtd_alloc_init(FuriHalNfcTxRxContext* tx_rx) { MrtdApplication* app = malloc(sizeof(MrtdApplication)); app->tx_rx = tx_rx; return app; } void mrtd_free(MrtdApplication* app) { furi_assert(app); free(app); } bool mrtd_bac(MrtdApplication* app, MrtdAuthData* auth) { UNUSED(app); static bool rand_generator_inited = false; uint8_t rnd_ic[8]; uint8_t rnd_ifd[8]; uint8_t k_ifd[16]; if(!rand_generator_inited) { // TODO: should random initialization maybe be system wide? srand(DWT->CYCCNT); rand_generator_inited = true; } mrtd_get_challenge(app, rnd_ic); //TODO: remove memcpy rnd_ic //memcpy(rnd_ic, "\x46\x08\xF9\x19\x88\x70\x22\x12", 8); furi_hal_random_fill_buf(rnd_ifd, 8); furi_hal_random_fill_buf(k_ifd, 16); //TODO: remove testing code: //memcpy(rnd_ifd, "\x78\x17\x23\x86\x0C\x06\xC2\x26", 8); //memcpy(k_ifd, "\x0B\x79\x52\x40\xCB\x70\x49\xB0\x1C\x19\xB3\x3E\x32\x80\x4F\x0B", 16); hexdump(FuriLogLevelDebug, "rnd_ifd:", rnd_ifd, 8); hexdump(FuriLogLevelDebug, "k_ifd:", k_ifd, 16); uint8_t kenc[16]; uint8_t kmac[16]; if(!mrtd_bac_keys(auth, kenc, kmac)) { FURI_LOG_E(TAG, "Failed to calculate BAC keys"); return false; } uint8_t S[32]; memcpy(S, rnd_ifd, 8); memcpy(S+8, rnd_ic, 8); memcpy(S+16, k_ifd, 16); hexdump(FuriLogLevelDebug, "S:", S, 32); uint8_t cmd_data[40]; uint8_t *eifd = cmd_data; uint8_t *mifd = cmd_data+32; mrtd_bac_encrypt(S, 32, kenc, eifd); mrtd_bac_padded_mac(eifd, 32, kmac, mifd); uint8_t response[40]; if(!mrtd_external_authenticate(app, cmd_data, 40, response, 40)) { FURI_LOG_E(TAG, "BAC External Authenticate failed"); return false; } uint8_t buffer[32]; // Received R = RND.IC (8) || RND.IFD (8) || KIC (16) if(!mrtd_bac_decrypt_verify(response, 40, kenc, kmac, buffer)) { FURI_LOG_W(TAG, "BAC DecryptVerify failed"); } uint8_t *rnd_ifd_recv = buffer + 8; uint8_t *kic = buffer + 16; hexdump(FuriLogLevelDebug, "kic:", kic, 16); if(memcmp(rnd_ifd, rnd_ifd_recv, 8)) { FURI_LOG_W(TAG, "BAC RND.IFD sent and received mismatch."); } uint8_t kseed[16]; for(uint8_t i=0; i<16; ++i) { kseed[i] = k_ifd[i] ^ kic[i]; printf("seed %2d = %02X ^ %02X = %02X\r\n", i, k_ifd[i], kic[i], kseed[i]); } hexdump(FuriLogLevelDebug, "kseed:", kseed, 16); if(!mrtd_bac_keys_from_seed(kseed, app->ksenc, app->ksmac)) { FURI_LOG_E(TAG, "BAC error, could not derive KSenc and KSmac"); return false; } hexdump(FuriLogLevelDebug, "ksenc:", app->ksenc, 16); hexdump(FuriLogLevelDebug, "ksmac:", app->ksmac, 16); hexdump(FuriLogLevelTrace, "RND.IC:", rnd_ic, 8); hexdump(FuriLogLevelTrace, "RND.IFS:", rnd_ifd, 8); app->ssc_long = mrtd_ssc_from_data(rnd_ic, rnd_ifd); FURI_LOG_D(TAG, "SSC: %01llX", app->ssc_long); app->secure_messaging = true; return true; }