mirror of
https://github.com/sharevb/it-tools.git
synced 2026-11-20 21:23:08 +03:00
1 parent
3fc1614ce0
commit
5d8b28d36b
7 files changed
+400
No files matched your search
@@ -256,6 +256,7 @@
|
||||
"netstack.js": "^2.1.2",
|
||||
"nginx-config-formatter": "^1.4.5",
|
||||
"niceware": "^4.0.0",
|
||||
"node-emv": "^1.0.23",
|
||||
"node-forge": "^1.3.1",
|
||||
"openai-chat-tokens": "^0.2.8",
|
||||
"openpgp": "^6.2.0",
|
||||
|
||||
Generated
+8
@@ -656,6 +656,9 @@ importers:
|
||||
niceware:
|
||||
specifier: ^4.0.0
|
||||
version: 4.0.0
|
||||
node-emv:
|
||||
specifier: ^1.0.23
|
||||
version: 1.0.23
|
||||
node-forge:
|
||||
specifier: ^1.3.1
|
||||
version: 1.3.1
|
||||
@@ -8644,6 +8647,9 @@ packages:
|
||||
engines: {node: '>=10.5.0'}
|
||||
deprecated: Use your platform's native DOMException instead
|
||||
|
||||
node-emv@1.0.23:
|
||||
resolution: {integrity: sha512-mp4v4f9g7ZQ6+E/qlvIiomp4l8RmbJ0Sja67eJmsozmhfVF09wwtvNkm8FNANeo9HQsfBvnM6mY/tzzae++/KQ==}
|
||||
|
||||
node-fetch-native@1.6.4:
|
||||
resolution: {integrity: sha512-IhOigYzAKHd244OC0JIMIUrjzctirCmPkaIfhDeGcEETWof5zKYUW7e7MYvChGWh/4CJeXEgsRyGzuF334rOOQ==}
|
||||
|
||||
@@ -20202,6 +20208,8 @@ snapshots:
|
||||
|
||||
node-domexception@1.0.0: {}
|
||||
|
||||
node-emv@1.0.23: {}
|
||||
|
||||
node-fetch-native@1.6.4: {}
|
||||
|
||||
node-fetch@2.7.0:
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
<script setup lang="ts">
|
||||
import type { EmvTag } from 'node-emv';
|
||||
|
||||
defineProps<{
|
||||
tags: EmvTag[]
|
||||
title?: string
|
||||
}>();
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<NCollapse :default-expanded-names="['root']">
|
||||
<NCollapseItem :title="title" name="root">
|
||||
<NTable :bordered="true" :single-line="false">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Tag</th>
|
||||
<th>Length</th>
|
||||
<th>Value</th>
|
||||
<th>Description</th>
|
||||
<th>Bit-Level Interpretation</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<template v-for="(tag, index) in tags" :key="index">
|
||||
<tr>
|
||||
<td>{{ tag.tag }}</td>
|
||||
<td>{{ tag.length }}</td>
|
||||
<td>{{ Array.isArray(tag.value) ? 'has nested tags' : tag.value }}</td>
|
||||
<td>{{ tag.description }}</td>
|
||||
<td>
|
||||
<ul v-if="tag.bitDetails?.length">
|
||||
<li v-for="(bitDesc, i) in tag.bitDetails" :key="i">
|
||||
{{ bitDesc }}
|
||||
</li>
|
||||
</ul>
|
||||
<span v-else>—</span>
|
||||
</td>
|
||||
</tr>
|
||||
<tr v-if="Array.isArray(tag.value)">
|
||||
<td colspan="5" style="padding-left: 2em;">
|
||||
<TLVTagTree :tags="tag.value" :title="`Nested in ${tag.tag}`" />
|
||||
</td>
|
||||
</tr>
|
||||
</template>
|
||||
</tbody>
|
||||
</NTable>
|
||||
</NCollapseItem>
|
||||
</NCollapse>
|
||||
</template>
|
||||
@@ -0,0 +1,254 @@
|
||||
/* eslint-disable max-statements-per-line */
|
||||
import emv, { type EmvBitDescription, type EmvTag } from 'node-emv';
|
||||
|
||||
/**
|
||||
* Utility functions
|
||||
*/
|
||||
function hexToBytes(hex: string): number[] {
|
||||
const clean = hex.replace(/\s+/g, '');
|
||||
if (clean.length % 2 !== 0) {
|
||||
throw new Error(`Invalid hex length: ${clean.length}`);
|
||||
}
|
||||
const out: number[] = [];
|
||||
for (let i = 0; i < clean.length; i += 2) {
|
||||
out.push(Number.parseInt(clean.slice(i, i + 2), 16));
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function hasBit(byte: number, bitIndex: number): boolean {
|
||||
return (byte & (1 << bitIndex)) !== 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tag 9F10 – Issuer Application Data (IAD)
|
||||
*/
|
||||
export function parse9F10_IAD(hex: string): string[] {
|
||||
const bytes = hexToBytes(hex);
|
||||
const results: string[] = [];
|
||||
results.push(`IAD length: ${bytes.length} bytes`);
|
||||
results.push(`Raw IAD: ${hex}`);
|
||||
|
||||
// Heuristic scheme hint
|
||||
if (bytes.length === 22 || bytes.length === 24) { results.push('Likely Visa profile'); }
|
||||
else if (bytes.length === 32 || bytes.length === 34) { results.push('Likely Mastercard profile'); }
|
||||
else { results.push('Scheme unknown'); }
|
||||
|
||||
results.push(`First byte (ARC/IAD version): 0x${bytes[0].toString(16).padStart(2, '0')}`);
|
||||
|
||||
// Heuristic CVR extraction
|
||||
if (bytes.length >= 12) {
|
||||
const cvrBytes = bytes.slice(2, 6);
|
||||
results.push(`CVR (heuristic): ${cvrBytes.map(b => b.toString(16).padStart(2, '0')).join('')}`);
|
||||
}
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tag 9F33 – Terminal Capabilities
|
||||
*/
|
||||
export function parse9F33_TerminalCapabilities(hex: string): string[] {
|
||||
const bytes = hexToBytes(hex);
|
||||
if (bytes.length !== 3) { throw new Error('9F33 must be 3 bytes'); }
|
||||
const results: string[] = [];
|
||||
|
||||
if (hasBit(bytes[0], 7)) { results.push('Cash transaction supported'); }
|
||||
if (hasBit(bytes[0], 6)) { results.push('Goods purchase supported'); }
|
||||
if (hasBit(bytes[0], 5)) { results.push('Services purchase supported'); }
|
||||
if (hasBit(bytes[0], 4)) { results.push('Cashback supported'); }
|
||||
|
||||
if (hasBit(bytes[1], 7)) { results.push('Plaintext PIN for ICC supported'); }
|
||||
if (hasBit(bytes[1], 6)) { results.push('Enciphered PIN (online) supported'); }
|
||||
if (hasBit(bytes[1], 5)) { results.push('Signature supported'); }
|
||||
if (hasBit(bytes[1], 4)) { results.push('No CVM supported'); }
|
||||
|
||||
if (hasBit(bytes[2], 7)) { results.push('Terminal risk management supported'); }
|
||||
if (hasBit(bytes[2], 6)) { results.push('Issuer authentication supported'); }
|
||||
if (hasBit(bytes[2], 5)) { results.push('CDA supported'); }
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tag 9F34 – CVM Results
|
||||
*/
|
||||
export function parse9F34_CVMResults(hex: string): string[] {
|
||||
const bytes = hexToBytes(hex);
|
||||
if (bytes.length !== 3) { throw new Error('9F34 must be 3 bytes'); }
|
||||
const results: string[] = [];
|
||||
|
||||
results.push(`CVM Method Code: ${bytes[0]}`);
|
||||
results.push(`Condition Code: ${bytes[1]}`);
|
||||
|
||||
if (hasBit(bytes[2], 7)) { results.push('CVM performed'); }
|
||||
if (hasBit(bytes[2], 6)) { results.push('CVM failed'); }
|
||||
if (hasBit(bytes[2], 5)) { results.push('Bypass attested'); }
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tag 9F40 – Additional Terminal Capabilities
|
||||
*/
|
||||
export function parse9F40_AdditionalTerminalCapabilities(hex: string): string[] {
|
||||
const bytes = hexToBytes(hex);
|
||||
if (bytes.length < 4) { throw new Error('9F40 must be at least 4 bytes'); }
|
||||
const results: string[] = [];
|
||||
|
||||
if (hasBit(bytes[0], 7)) { results.push('Cash supported'); }
|
||||
if (hasBit(bytes[0], 6)) { results.push('Cashback supported'); }
|
||||
if (hasBit(bytes[0], 5)) { results.push('Purchase with cashback supported'); }
|
||||
if (hasBit(bytes[0], 4)) { results.push('Refund supported'); }
|
||||
|
||||
if (hasBit(bytes[1], 7)) { results.push('Offline plaintext PIN supported'); }
|
||||
if (hasBit(bytes[1], 6)) { results.push('Offline enciphered PIN supported'); }
|
||||
if (hasBit(bytes[1], 5)) { results.push('Online PIN supported'); }
|
||||
if (hasBit(bytes[1], 4)) { results.push('Signature supported'); }
|
||||
|
||||
if (hasBit(bytes[2], 7)) { results.push('SDA supported'); }
|
||||
if (hasBit(bytes[2], 6)) { results.push('DDA supported'); }
|
||||
if (hasBit(bytes[2], 5)) { results.push('CDA supported'); }
|
||||
if (hasBit(bytes[2], 4)) { results.push('Combined data authentication supported'); }
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tag 9F66 – TTQ (Terminal Transaction Qualifiers)
|
||||
*/
|
||||
export function parse9F66_TTQ(hex: string): string[] {
|
||||
const bytes = hexToBytes(hex);
|
||||
if (bytes.length < 4) { throw new Error('9F66 must be at least 4 bytes'); }
|
||||
const results: string[] = [];
|
||||
|
||||
if (hasBit(bytes[0], 7)) { results.push('Contactless EMV mode supported'); }
|
||||
if (hasBit(bytes[0], 6)) { results.push('Contactless MSD mode supported'); }
|
||||
if (hasBit(bytes[0], 5)) { results.push('Contact EMV supported'); }
|
||||
if (hasBit(bytes[0], 4)) { results.push('Offline data authentication supported'); }
|
||||
|
||||
if (hasBit(bytes[1], 7)) { results.push('No signature (QPS) supported'); }
|
||||
if (hasBit(bytes[1], 6)) { results.push('CVM required'); }
|
||||
if (hasBit(bytes[1], 5)) { results.push('Online PIN supported'); }
|
||||
if (hasBit(bytes[1], 4)) { results.push('Signature supported'); }
|
||||
|
||||
if (hasBit(bytes[2], 7)) { results.push('Online cryptogram required'); }
|
||||
if (hasBit(bytes[2], 6)) { results.push('Issuer update processing supported'); }
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tag 9F6C – CTQ (Card Transaction Qualifiers)
|
||||
*/
|
||||
export function parse9F6C_CTQ(hex: string): string[] {
|
||||
const bytes = hexToBytes(hex);
|
||||
if (bytes.length < 2) { throw new Error('9F6C must be at least 2 bytes'); }
|
||||
const results: string[] = [];
|
||||
|
||||
if (hasBit(bytes[0], 7)) { results.push('CVM required'); }
|
||||
if (hasBit(bytes[0], 6)) { results.push('Online PIN supported'); }
|
||||
if (hasBit(bytes[0], 5)) { results.push('Signature supported'); }
|
||||
if (hasBit(bytes[0], 4)) { results.push('No CVM supported'); }
|
||||
|
||||
if (hasBit(bytes[1], 7)) { results.push('Offline approval possible'); }
|
||||
if (hasBit(bytes[1], 6)) { results.push('Online processing possible'); }
|
||||
if (hasBit(bytes[1], 5)) { results.push('CVM performed by card'); }
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tag 9F6E – FFI (Form Factor Indicator)
|
||||
*/
|
||||
export function parse9F6E_FFI(hex: string): string[] {
|
||||
const bytes = hexToBytes(hex);
|
||||
if (bytes.length < 1) { throw new Error('9F6E must be at least 1 byte'); }
|
||||
const results: string[] = [];
|
||||
|
||||
const code = bytes[0];
|
||||
let description = 'Reserved/Other';
|
||||
if (code === 0x01) { description = 'Plastic card'; }
|
||||
else if (code === 0x02) { description = 'Mobile device'; }
|
||||
else if (code === 0x03) { description = 'Wearable'; }
|
||||
else if (code === 0x04) { description = 'Tokenized device'; }
|
||||
|
||||
results.push(`Form Factor Code: ${code} (${description})`);
|
||||
|
||||
if (bytes.length > 1) {
|
||||
results.push(`Extra bytes: ${bytes.slice(1).map(b => b.toString(16).padStart(2, '0')).join('')}`);
|
||||
}
|
||||
|
||||
return results;
|
||||
}
|
||||
|
||||
export function parseEmvData(tlvData: string, kernel: string) {
|
||||
let parsed: EmvTag[] = [];
|
||||
emv.describeKernel(tlvData, kernel, data => parsed = data);
|
||||
if (!parsed) {
|
||||
throw new Error('Invalid EMV TLV data');
|
||||
}
|
||||
|
||||
const describeItem = (item: EmvTag): EmvTag => {
|
||||
if (Array.isArray(item.value)) {
|
||||
return {
|
||||
tag: item.tag,
|
||||
length: item.length,
|
||||
description: item.description,
|
||||
value: item.value.map(sub_item => describeItem(sub_item)),
|
||||
};
|
||||
}
|
||||
|
||||
let bitDetails: string[] = [];
|
||||
|
||||
const getActiveBitsDescriptions = (bits: EmvBitDescription[][]) => bits.flat().filter(b => b.description !== 'RFU').map(b => `${b.description}: ${(b.value === '1' ? 'yes' : 'no')}`);
|
||||
|
||||
switch (item.tag) {
|
||||
case '95': // TVR
|
||||
emv.tvr(item.value, data => bitDetails = getActiveBitsDescriptions(data));
|
||||
break;
|
||||
case '9B': // TSI
|
||||
emv.tsi(item.value, data => bitDetails = getActiveBitsDescriptions(data));
|
||||
break;
|
||||
case '82': // AIP
|
||||
emv.aip(item.value, data => bitDetails = getActiveBitsDescriptions(data));
|
||||
break;
|
||||
case '8E': // CVM List
|
||||
emv.cvm(item.value, data => bitDetails = data);
|
||||
break;
|
||||
case '9F07': // AUC
|
||||
emv.auc(item.value, data => bitDetails = getActiveBitsDescriptions(data));
|
||||
break;
|
||||
case '9F10': // IAD
|
||||
bitDetails = parse9F10_IAD(item.value);
|
||||
break;
|
||||
case '9F33': // Terminal Capabilities
|
||||
bitDetails = parse9F33_TerminalCapabilities(item.value);
|
||||
break;
|
||||
case '9F34': // CVM Results
|
||||
bitDetails = parse9F34_CVMResults(item.value);
|
||||
break;
|
||||
case '9F40': // Additional Terminal Capabilities
|
||||
bitDetails = parse9F40_AdditionalTerminalCapabilities(item.value);
|
||||
break;
|
||||
case '9F66': // TTQ
|
||||
bitDetails = parse9F66_TTQ(item.value);
|
||||
break;
|
||||
case '9F6C': // CTQ
|
||||
bitDetails = parse9F6C_CTQ(item.value);
|
||||
break;
|
||||
case '9F6E': // FFI
|
||||
bitDetails = parse9F6E_FFI(item.value);
|
||||
break;
|
||||
}
|
||||
|
||||
return {
|
||||
tag: item.tag,
|
||||
length: item.length,
|
||||
description: item.description,
|
||||
value: item.value,
|
||||
bitDetails,
|
||||
};
|
||||
};
|
||||
return parsed.map(describeItem);
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
<script setup lang="ts">
|
||||
import { parseEmvData } from './emv-tlv-decoder.service';
|
||||
import TLVTagTree from './TLVTagTree.vue';
|
||||
|
||||
const tlvInput = ref('4F07A00000000430605F2A02097882025C008407A0000000043060950500800080009A031508069C01009F02060000000001019F080200009F090200009F10120114000100000000000000E0DB2E438900FF');
|
||||
const parsedTags = ref<any[]>([]);
|
||||
const error = ref('');
|
||||
const kernel = ref('Generic');
|
||||
|
||||
function parseTlv() {
|
||||
try {
|
||||
const hex = tlvInput.value.replace(/\s+/g, '').toUpperCase();
|
||||
parsedTags.value = parseEmvData(hex, kernel.value);
|
||||
}
|
||||
catch (err: any) {
|
||||
error.value = err.toString();
|
||||
parsedTags.value = [];
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div>
|
||||
<NFormItem label="TLV Hex Input" mb-2>
|
||||
<NInput
|
||||
v-model:value="tlvInput"
|
||||
type="textarea"
|
||||
placeholder="Paste EMV TLV hex string (e.g. 6F1A8407A0000000031010A50F500B5649534120435245444954)"
|
||||
rows="4"
|
||||
/>
|
||||
</NFormItem>
|
||||
<c-select
|
||||
v-model:value="kernel"
|
||||
:options="['Generic', 'Visa', 'Mastercard', 'JCB', 'AMEX']"
|
||||
label="Kernel Type:"
|
||||
label-position="left"
|
||||
mb-2
|
||||
/>
|
||||
<div mb-2 flex justify-center>
|
||||
<NButton type="primary" @click="parseTlv">
|
||||
Parse TLV
|
||||
</NButton>
|
||||
</div>
|
||||
|
||||
<c-alert v-if="error">
|
||||
{{ error }}
|
||||
</c-alert>
|
||||
|
||||
<c-card v-if="parsedTags" title="Decoded EMV Tags">
|
||||
<TLVTagTree :tags="parsedTags" />
|
||||
</c-card>
|
||||
</div>
|
||||
</template>
|
||||
@@ -0,0 +1,13 @@
|
||||
import { CreditCard } from '@vicons/tabler';
|
||||
import { defineTool } from '../tool';
|
||||
|
||||
export const tool = defineTool({
|
||||
name: 'EMV TLV decoder',
|
||||
path: '/emv-tlv-decoder',
|
||||
description: 'Decodes the EMV TLV (tag-length-value) data and its individual tags having extended meaning (such as TVR (Tag 95), Terminal Capabilities (Tag 9F33), etc.)',
|
||||
keywords: ['emv', 'tag', 'payment', 'card', 'tlv', 'decoder'],
|
||||
component: () => import('./emv-tlv-decoder.vue'),
|
||||
icon: CreditCard,
|
||||
createdAt: new Date('2025-11-01'),
|
||||
category: 'Forensic',
|
||||
});
|
||||
+22
@@ -0,0 +1,22 @@
|
||||
declare module 'node-emv' {
|
||||
export interface EmvBitDescription {
|
||||
bit: string
|
||||
description: string
|
||||
value: string
|
||||
}
|
||||
|
||||
export interface EmvTag {
|
||||
tag: string
|
||||
length: number
|
||||
value: string | EmvTag[]
|
||||
description: string
|
||||
bitDetails?: string[]
|
||||
}
|
||||
|
||||
export function describeKernel(hex: string, kernel: string, callback: (data: EmvTag[]) => void): void;
|
||||
export function tvr(hex: string, callback: (data: EmbBitDescription[][]) => void): void;
|
||||
export function auc(hex: string, callback: (data: EmbBitDescription[][]) => void): void;
|
||||
export function aip(hex: string, callback: (data: EmbBitDescription[][]) => void): void;
|
||||
export function tsi(hex: string, callback: (data: EmbBitDescription[][]) => void): void;
|
||||
export function cvm(hex: string, callback: (data: string[]) => void): void;
|
||||
}
|
||||
Reference in new issue
Block a user