Pangalingi tehniline spetsifikatsioon

Üldine

Pangalingi päringute all on mõeldud HTTP POST päringut spetsifitseeritud parameetritega. Iga päring sisaldab endas teenuse numbrit. Igale teenusele vastab oma loetelu parameetritest ja päringu käsitlemise algoritm. Päringud Kaupmehelt Pangale suunatakse URLile: https://www.lhv.ee/banklink.

Maksepäringud

Vastavuses uuendatud tehnilise spetsifikatsiooniga.

Päring 1011

Kaupmees saadab Panka allkirjastatud maksekorralduse andmed, mida Klient internetipangas muuta ei saa. Peale edukat makset koostatakse Kaupmehele päring “1111”, ebaõnnestunud makse puhul “1911”.

Päring 1012

Kaupmees saadab panka Kliendi sooviavalduse Tehingu tegemiseks. Makse saaja nimi ja konto number võetakse Panga ja Kaupmehe vahelisest lepingust. Peale edukat makset koostatakse Kaupmehele päring “1111”, ebaõnnestunud makse puhul “1911”.

Vastuspäring 1111

Kasutatakse vastamiseks maksekorralduse toimumisest

Vastuspäring 1911

Kasutatakse ebaõnnestunud tehingust teatamiseks.

Autentimispäringud

Vastavuses uuendatud tehnilise spetsifikatsiooniga.

Vastuspäring 3012

Kaupmehele edastatakse Panga poolt tuvastatud kasutaja andmed. Turvalisuse huvides peab sõnumi saaja lisaks allkirjale (VK_MAC) kontrollima ka sõnumi saaja ID-d (VK_REC_ID) ning sõnumi genereerimise kuupäeva ja kellaaega (VK_DATETIME), mis tohib erineda kontrollimise hetkel kehtivast maksimaalselt ±5 minutit.

Vastuspäring 3013

Kaupmehele edastatakse vastusena päringule 4012 Panga poolt tuvastatud kasutaja andmed ja nonssi koopia. Turvalisuse huvides peab sõnumi saaja lisaks allkirjale (VK_MAC) ja nonssile (VK_NONCE) kontrollima ka sõnumi saaja ID-d (VK_REC_ID) ning sõnumi genereerimise kuupäeva ja kellaaega (VK_DATETIME), mis tohib erineda kontrollimise hetkel kehtivast maksimaalselt ±5 minutit.

Päring 4011

Kaupmehe poolt Pangale saadetav päring kasutaja tuvastamiseks. Teenus avatud vastava lepingu sõlminud kaupmeestele. Vastuspäringu kood 3012.

Autentimispäring 4012

Kaupmehe poolt Pangale saadetav päring kasutaja tuvastamiseks. Teenus avatud vastava lepingu sõlminud kaupmeestele.
Vastuspäringu kood 3013.

Avalikud võtmed

• LHV aktsepteerib sertifikaadipäringut ehk n-ö self-signed sertifikaati. Pangalingi lepingu sõlmimisel saadab pank kaupmehele avaliku võtme sertifikaadi, mille klient peab sisestama oma süsteemi ning sellega valideeritakse panga poolt saadetud pakette.

• Klient peab genereerima omale avaliku ja salajase võtmepaari. Võtme loomisel soovitame lähtuda järgmistest tingimustest:

  • Signature algorithm - sha1RSA
  • Public key - RSA(2048 Bits)
  • Kehtivusaeg mitte üle 10 aasta

  Kasutame X.509 standardile vastavaid .PEM formaadis võtmeid/sertifikaate st. sisu on BASE64 kodeeringus ning märgendite –BEGIN… – ja –END… – vahel. Kliendi poolt genereeritud salajase võtme minimaalne pikkus peab olema 2048 bitti.
  Võtmepaari saab genereerida käsurealt openssl utiliidi abil:

  openssl genrsa 2048 > privkey.pem
  openssl req -new -key privkey.pem -out cert-req.pem
  

  Avalik võti tuleb panka tagasi saata ning seejärel pangalink aktiveeritakse.

Kontrollkoodi VK_MAC leidmine

Päringutes kasutatava elektroonse allkirja VK_MAC arvutus toimub kokkuleppelise algoritmi alusel. Algoritmi versiooni määrab päringu parameeter VK_VERSION. Allkiri VK_MAC edastatakse päringutes BASE64 kodeerituna. Kasutusel kaks versiooni:

1. VK_MAC(MAC008) arvutatakse kasutades avaliku võtme algoritmi RSA ning räsialgoritmi SHA-1. MAC008(x1,x2,…,xn) := RSA( SHA-1(p(x1)|| x1|| p(x2)|| x2 || … ||p( xn )||xn), d, n).
2. VK_MAC(MAC009) arvutatakse kasutades avaliku võtme algoritmi RSA ning räsialgoritmi SHA-512. MAC009(x1,x2,…,xn) := RSA( SHA-512(p(x1)|| x1|| p(x2)|| x2 || … ||p( xn )||xn), d, n).

Selgitused:

• x1, x2, …, xn on päringu parameetrid.
• p on uuele spetsifikatsioonile vastavate päringute puhul (1011, 1012, 1111, 1911, 3012, 3013, 4011, 4012) funktsioon parameetri pikkusest sümbolites. Pikkus on formateeritud kolmekohalise stringi kujul. Ehk siis pikkus 1 on "001". Tühjade väljade pikkus on "000".
• d on RSA salajane eksponent.
• n on RSA modulus.
• || - stringide liitmistehe.