timgabets/lakgves - Githubissues

LAKGVES

lak·ves

dextral muscles around the eyes, in particular the temporal lobes of the chin and lower lip. ("the lakgves of other vertebrates")
a word that does not exist; it was invented, defined and used by a machine learning algorithm.

Concept

HTTP to ISO8583 message converter, written from scratch in Rust and heavily inspired by JUKS' socket queue. The main purpose of the system is testing Issuer Bank systems.

                           +-----------------+                              +--------------------+
                           |                 | <------ XML ISO 8583 ------> |    Issuer Bank     |
HTTP client <--- JSON ---> |     Lakgves     | <--- TODO (VISA SMS/DMS) --> |   Authorization    |
                           |                 | <---  TODO (Mastercard) ---> |        Host        |
                           +--------+--------+                              +--------------------+
                                    |              +--------------------+
                                    |              |    Issuer Bank     |
                                    +-- SP XML --> |     Anti-Fraud     |
                                                   |       System       |
                                                   +--------------------+

The application converts JSON payload to ISO8583 message in a proper format, sends it to the Bank host, receives the response and sends it back to the HTTP client. In other words, the input JSON like this (note that the card number in i002 and expiration date in i014 are masked here for security reasons. The real request should contain the full unmacked data):

{
  "i000":"0100",
  "i002":"443322******0961",
  "i003":"300000",
  "i004":"000000000000",
  "i014":"****",
  "i018":"6011",
  "i022":"0100",
  "i023":"000",
  "i025":"02",
  "i026":"04",
  "i032":"999999",
  "i041":"TERMID01",
  "i042":"IDDQD MERCH ID",
  "i043":"IDDQD AM. 341215574     341215574 MSKRU",
  "i049":"643",
  "i053":"9801100001000000"
}

will be converted into one of the ISO8583 flavours (e.g. Debit Host Interface XML in the example below):

<RequestInput>
  <ISO8583-87>
    <i000>0100</i000>
    <i002>443322******0961</i002>
    <i003>300000</i003>
    <i004>000000000000</i004>
    <i007>0505151908</i007> <!-- Transmission date & time - generated by the application if not provided -->
    <i011>367298</i011> <!-- STAN - generated by the application if not provided -->
    <i012>151908</i012> <!-- hhmmss - generated by the application if not provided -->
    <i013>0505</i013> <!-- MMDD - generated by the application if not provided -->
    <i014>****</i014>
    <i018>6011</i018>
    <i022>0100</i022>
    <i023>000</i023>
    <i025>02</i025>
    <i026>04</i026>
    <i032>999999</i032>
    <i037>964800787298</i037> <!-- RRN (Retrieval Reference Number) - generated by the application if not provided -->
    <i041>TERMID01</i041>
    <i042>IDDQD MERCH ID</i042>
    <i043>IDDQD AM. 341215574     341215574 MSKRU</i043>
    <i049>643</i049>
    <i053>9801100001000000</i053>
  </ISO8583-87>
</RequestInput>

Please refer to your ISO8583 specification for the fields meaning and possible values.

Supported formats

The list of supported formats:

Installation

Red Hat/Fedora:

Quick install:

curl -s https://packagecloud.io/install/repositories/timgabets/lakgves/script.rpm.sh | sudo bash
sudo yum install lakgves

Running

Start app as a service:

sudo systemctl start lakgves
sudo systemctl status lakgves

The application logs may be retrived by journalctl:

journalctl -u lakgves

Alternatively, execute application manually:

# Edit configuration file /etc/lakgves/config.toml and then run
/usr/bin/lakgves /etc/lakgves/config.toml

Usage

Any HTTP tool (e.g. curl or SoapUI) may be used to interact with the Lakgves app:

curl -v --header "Content-Type: application/json" --request POST --data '{"i000":"0100", "i002":"443322******0961", "i003":"300000", "i004":"000000000000", "i014":"****", "i018":"6011", "i022":"0100", "i023":"000", "i025":"02", "i026":"04", "i032":"999999", "i041":"TERMID01", "i042":"IDDQD MERCH ID", "i043":"IDDQD AM. 341215574     341215574 MSKRU", "i049":"643", "i053":"9801100001000000"}' localhost:8080

The received response may look like this:

< HTTP/1.1 200 OK
< content-length: 528
< content-type: application/json
< x-hdr: sample
< date: Tue, 05 May 2020 15:01:52 GMT
<
* Connection #0 to host localhost left intact
{"i000":"0110","i002":"443322******0961","i003":"300000","i004":"000000000000","i007":"0505180152","i011":"233005","i012":"180152","i013":"0505","i014":"****","i018":"6011","i022":"0100","i023":"000","i025":"02","i026":"4","i032":"999999","i037":"634538143910","i038":"082673","i039":"00","i041":"TERMID01","i042":"IDDQD MERCH ID","i043":"IDDQD AM. 341215574     341215574 MSKRU","i049":"643","i053":"9801100001000000","i054":"0001643D000001431065","i096":"0000634538143910","i120":"UD038IR0044444CR009ES0048100IA0103510301943"}* Closing connection 0
curl -v --header "Content-Type: application/json" --request POST --data