Skip to content

Latest commit

 

History

History
106 lines (79 loc) · 3.9 KB

README.md

File metadata and controls

106 lines (79 loc) · 3.9 KB
Raw

EMV Tool

EMV provides an easy-to-use interface to interact with EMV smartcards based on this great PCSC rust library.

The acronymim EMV stands for Europay-Mastercard-Visa and describes the behaviour of applications running in smart cards. Most of the specification can be found on Books 1~4 on ./docs/

Installing

Homebrew

Currently only supports macOS

brew tap caiotavares/emv
brew install emv

Building from source

Requires rustup

git clone git@github.com:caiotavares/emv.git
cargo install --path ./emv

Usage

emv <subcommand>

Subcommands

emv currently the following subcommands

subcommand arguments
shell
run <input>

Use shell if you want emv to open a connection with a card and keep listening for APDU commands on the command-line.

If you want emv to run a series of APDU commands with minimal manual input, use run and provide a path for a file with APDU command-syntax.

Supported APDU Commands

Some commands require one or two arguments to be provided and for special cases such as PUT_DATA and PIN_UNBLOCK, emv will prompt the user to input the cryptographic MAC (message authentication code), since these commands modify card information.

APDU Arguments Format Prompts for
SELECT <aid> <hex string>
GET_PROCESSING_OPTIONS
READ_RECORD <record> <sfi> <hex string> <hex string>
GET_DATA <tag> <hex string>
PUT_DATA <tag> <value> <hex string> MAC
GENERATE_AC <type> <cdol> ARQC/TC/ACC <hex string>
PIN_UNBLOCK MAC
PIN_CHANGE* <pin> <hex_string> MAC
VERIFY <pin> <hex_string>

* The input PIN should be encrypted by the SMC key

Example 1: Selecting a Mastercard Credit application, fetching the processing options and requesting an ARQC based on a CDOL1:

$ emv shell
> SELECT A0000000041010
> GET_PROCESSING_OPTIONS
> GENERATE_AC ARQC 0000000000100000000000100986000000000009861504280030901B6A2300001EABC126F85499760000000000000000000000000000000000000000000000000000

Example 2: Selecting a Mastercard Maestro application, fetching the processing options, requesting an ARQC and finally requesting a TC from a CDOL2:

$ emv shell
> SELECT A0000000043060
> GET_PROCESSING_OPTIONS
> GENERATE_AC ARQC 0000000000100000000000100986000000000009861504280030901B6A2300001EABC126F85499760000000000000000000000000000000000000000000000000000 
> GENERATE_AC TC E014E254B75DBB8D031A3030000000000030901B6A1EABC126F8549976

Example 3: Using a PUT DATA command to update a linked application:

$ emv shell
> SELECT A0000000043060
> GET_PROCESSING_OPTIONS
> GENERATE_AC ARQC 0000000000100000000000100986000000000009861504280030901B6A2300001EABC126F85499760000000000000000000000000000000000000000000000000000 
> GENERATE_AC TC E014E254B75DBB8D031A3030000000000030901B6A1EABC126F8549976
> PUT_DATA DF07 00FF07A000000004101000A5500A4D6173746572636172648701035F2D067074656E65739F1101019F120D4372656469746F204A6169726FBF0C159F5D030100009F4D020B0A9F6E0700760000303000
> Input the MAC: 31E9601F158651AD